Skip to main content

tx_search REST API Endpoint

Searches for transactions with their results.

Updated on
Nov 7, 2024

tx_search REST API Endpoint

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
integer
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
boolean
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
string
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
string
The list of aunt hashes
total_count
string
The total count of transactions
Request
1
curl --location 'https://docs-demo.celestia-mainnet.quiknode.pro/tx_search?query=YOUR_QUERY&prove=true&page=1&per_page=30&order_by=asc'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free