Block search

Search for blocks by BeginBlock and EndBlock events

Search for blocks by BeginBlock and EndBlock events.

See /subscribe for the query syntax.

get

/block_search

Query parameters

querystringrequired

Query

Example: block.height > 1000 AND valset.changed > 0

pageinteger

Page number (1-based)

Example: 1

per_pageinteger

Number of entries per page (max: 100)

Example: 30

order_bystring

Order in which blocks are sorted ("asc" or "desc"), by height. If empty, default sorting will be still applied.

Example: asc

match_eventsboolean

Match attributes in query within events, in addition to the height

Example: true

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://band.nownodes.io/block_search?query=block.height+%3E+1000+AND+valset.changed+%3E+0'

500

500

{
  "id": 0,
  "jsonrpc": "2.0",
  "error": "Description of failure"
}

Error