Skip to main content

block_search REST API Endpoint

Searches for blocks by BeginBlock and EndBlock events.

Updated on
Mar 17, 2026

Query Parameters

query
string
REQUIRED

query is a string, which has a form: 'condition AND condition ...' (no OR at the moment). condition has a form: 'key operation operand'. key is a string with a restricted set of possible symbols (

()'=>< are not allowed). operation can be =, <, <=, >, >=, CONTAINS. An operand can be a string (escaped with single quotes), number, date, or time

prove
boolean
REQUIRED

Adds proofs of the transactions inclusion in the block

page
integer
REQUIRED

The page number (1-based). The default value is 1

per_page
integer
REQUIRED

The number of entries per page. The default value is 30

order_by
string
REQUIRED

The order in which transactions are sorted (asc or desc), by height & index. If empty, default asc sorting still applies

match_events
boolean

Matches attributes in query within events, in addition to the height and txhash

Returns

result
object

The result object with the following fields:

txs
array

An array of txs

hash
string

The hash of the transaction

height
string

The height at which the transaction was included

index
string

The index of the transaction

tx_result
object

The tx_result object which contains the following fields:

log
string

The log information of the transaction

gas_wanted
string

Gas limit specified by the transaction

gas_used
string

Gas consumed by the transaction

tags
object

The tags object which contains the following fields:

key
string

The key associated with the tag

value
string

The value associated with the tag

index
string

The index of the tag

tx
string

The base64 encoded representation of the transaction

proof
object

The proof object which contains the following fields:

RootHash
string

The root hash of the Merkle tree

Data
string

The base64 encoded data

Proof
object

The Proof object which contains the following fields:

total
integer

The total number of elements in the proof

index
string

The index of the proof

leaf_hash
string

The hash of the leaf node

aunts
array

The list of aunt hashes

total_count
integer

The total count of blocks

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free