Skip to main content

tx_search REST API Endpoint

Searches for transactions with their results.

Updated on
Jul 07, 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

The hash of the transaction

height

The height at which the transaction was included

index

The index of the transaction

tx_result
object

The tx_result object which contains the following fields:

code

Response code; 0 indicates success

data

Result bytes from the application

log

The log information of the transaction

gas_wanted

Gas limit specified by the transaction

gas_used

Gas consumed by the transaction

info

Additional information about the transaction result

codespace

Namespace for the error code

events
array

An array of events emitted by the transaction

type

The type of the event

attributes
array

An array of key-value attributes for the event

key

The key of the attribute

value

The value of the attribute

index

The index of the attribute

tx

The base64 encoded representation of the transaction

proof
object

The proof object which contains the following fields:

RootHash

The root hash of the Merkle tree

Data

The base64 encoded data

Proof
object

The Proof object which contains the following fields:

total

The total number of elements in the proof

index

The index of the proof

leaf_hash

The hash of the leaf node

aunts

The list of aunt hashes

total_count

The total count of transactions

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