For the complete documentation index, see llms.txt. This page is also available as Markdown.

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_search

Parameters

Parameter
Type
Description

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

Field
Type
Description

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

Error
Message
Description

-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?