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.
Tempo RPC endpoint: endpoint URLs, plans and pricing.
Returns traces matching a filter on Tempo.
Archive Node Required
This method requires an archive node. It is not available on full nodes.
When to Use This Method
- Search for traces matching address criteria - Find all internal transactions involving a specific address on Tempo
- Find all interactions with a contract - Track every call, delegate call, and create operation targeting a contract for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications
- Audit contract usage patterns - Analyze how contracts are used over time across block ranges
- Forensic analysis - Investigate transaction patterns and address-level activity across the chain
Best Practices
- Very resource-intensive on large block ranges; narrow the range as much as possible
- Use specific fromAddress or toAddress filters to reduce response size
- Limit block range to small chunks and paginate results
- Many provider-managed endpoints disable this method due to computational cost
Response Body
Code Examples
Related Methods
trace_block- Get all traces in a blocktrace_transaction- Get traces for a specific transactioneth_getLogs- Filter event logs
trace_callMany
Trace multiple calls in sequence on Tempo. Requires archive node for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications.
trace_get
Get a specific trace by transaction hash and index on Tempo. Requires archive node for merchant settlement, treasury operations, payout automation, and stablecoin-native financial applications.