tx_search - Stable
Example code for the tx_search JSON-RPC method. Complete guide on how to use tx_search JSON-RPC in GetBlock Web3 documentation.
Searches transactions by an event-attribute query, with pagination and ordering. Useful for finding transactions by sender, recipient, or module events.
Method
tx_searchParameters
query
string
Event query, e.g. "message.sender='cosmos1...'"
prove
string
Include Merkle proofs
page
string
Page number
per_page
string
Results per page
order_by
string
"asc" or "desc"
Example
export STABLE_TM=https://shared.ap-southeast-1.getblock.io/<ACCESS-TOKEN>/
# JSON-RPC over HTTP (POST)
curl -X POST "${STABLE_TM}" -H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": "getblock.io", "method": "tx_search", "params": {"query": "tx.height=31378844", "prove": "false", "page": "1", "per_page": "30", "order_by": "asc"}}'
# URI over HTTP (GET)
curl "${STABLE_TM}tx_search?query=tx.height=31378844&prove=false&page=1&per_page=30&order_by=asc"Response
Response Fields
txs
array
Matching transactions with results
total_count
string
Total number of matches
Use Cases
History queries: Find an address's transactions by event query
Module indexing: Search by module event attributes
Error Handling
-32600 / Invalid request
Invalid request
The JSON-RPC envelope was malformed
-32602 / Invalid params
Invalid params
A parameter was missing or of the wrong type
403 / RBAC: access denied
Access denied
The GetBlock access token is missing or incorrect
Last updated
Was this helpful?