Docs
Supported ChainsTempoJSON-RPC APITrace Methods

trace_filter - Tempo RPC Method

Filter traces by address and block range on Tempo. Requires archive node for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications.

Returns traces matching a filter on Tempo.

Archive Node Required

This method requires an archive node. It is not available on full nodes.

Use Cases

  • Address activity - Find all internal transactions involving an address
  • Contract monitoring - Track calls to specific contracts
  • Forensic analysis - Investigate transaction patterns for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications

Request Parameters

Request
filterObjectObject

Filter criteria (see below)

fromBlockQUANTITY|TAG

Start block (hex or tag)

toBlockQUANTITY|TAG

End block (hex or tag)

fromAddressArray<DATA>

Filter by sender addresses

toAddressArray<DATA>

Filter by receiver addresses

afterQUANTITY

Offset for pagination

countQUANTITY

Max results to return

Response Body

Response

Code Examples

Bash
curl -X POST https://api-tempo-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_filter",
    "params": [{
      "fromBlock": "latest",
      "toBlock": "latest",
      "toAddress": ["0x0bd34b0a5be345c9bf7a147eb698e993511180cb"],
      "count": 10
    }],
    "id": 1
  }'

On this page