Skip to main content
POST
trace_filter
curl --request POST \
  --url https://tempo-mainnet.core.chainstack.com/c3ce2925b51f1ed18719fe8a23bbdccf/ \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "trace_filter",
  "params": [
    {
      "fromBlock": "0x564000",
      "toBlock": "0x565000",
      "toAddress": [
        "0x20c0000000000000000000000000000000000000"
      ],
      "count": 10
    }
  ],
  "id": 1
}
'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt

Use this file to discover all available pages before exploring further.

Tempo API method that returns execution traces matching specific filter criteria. This is useful for finding all interactions with a specific contract or address across multiple blocks.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • filterObject — the filter object:
    • fromBlock — (optional) starting block number (hex)
    • toBlock — (optional) ending block number (hex)
    • fromAddress — (optional) array of sender addresses to filter
    • toAddress — (optional) array of recipient addresses to filter
    • after — (optional) offset for pagination
    • count — (optional) maximum number of traces to return

​
Response

  • result — array of trace objects matching the filter:
    • action — the action object:
      • from — sender address
      • to — recipient address
      • callType — type of call
      • gas — gas provided
      • input — call data
      • value — value transferred
    • blockHash — hash of the block
    • blockNumber — block number
    • result — the result object
    • subtraces — number of child traces
    • traceAddress — position in the trace tree
    • transactionHash — hash of the transaction
    • transactionPosition — index in the block
    • type — trace type

​
trace_filter code examples

The following example finds all calls to the pathUSD token contract: 
const ethers = require('ethers');
const NODE_URL = "CHAINSTACK_NODE_URL";
const provider = new ethers.JsonRpcProvider(NODE_URL);

// pathUSD token address
const PATHUSD = "0x20c0000000000000000000000000000000000000";

const traceFilter = async () => {
    const currentBlock = await provider.getBlockNumber();
    const fromBlock = "0x" + (currentBlock - 1000).toString(16);
    const toBlock = "0x" + currentBlock.toString(16);

    const traces = await provider.send("trace_filter", [{
      fromBlock: fromBlock,
      toBlock: toBlock,
      toAddress: [PATHUSD],
      count: 20
    }]);

    console.log(`Found ${traces.length} traces to pathUSD`);

    for (const trace of traces) {
      console.log(`Block ${trace.blockNumber}: ${trace.action.from} -> ${trace.action.to}`);
      console.log(`  Call type: ${trace.action.callType}`);
      console.log(`  Tx: ${trace.transactionHash}`);
    }
  };

traceFilter();

Body

application/json
​
jsonrpc
string
default:2.0
​
method
string
default:trace_filter
​
params
any[]

Filter object with block range and address filters

​
id
integer
default:1

Response

200 - application/json

Array of matching traces

​
jsonrpc
string
​
id
integer
​
result
object[]

Array of trace objects matching the filter

Last modified on May 18, 2026