TriportRPC
DashboardDocs

trace_filter

Last updated:

`trace_filter` scans a contiguous range of blocks and returns every trace (internal call, create, or suicide frame) whose sender and/or recipient match the supplied filter. Unlike [`trace_block`](./trace_block.md) — which is keyed to a single block — or [`trace_transaction`](./trace_transaction.md) — which is keyed to one transaction hash — `trace_filter` lets you sweep a window of history and narrow it down by address. It is the right tool for building an account's incoming/outgoing internal-transfer history or for indexing all activity that touched a particular contract.

Because a single block range can produce a very large number of traces, results are paginated with the `after` (offset) and `count` (limit) fields. Keep ranges modest and page through large result sets rather than requesting a huge window in one call.

This method requires the **pro** tier. Calls authenticated with a free-tier key are rejected with `-32002 tier_insufficient`.

Parameters

This method takes no parameters.

Returns

trace_filter return value
FieldType
resultobject

Examples

curl https://<your-endpoint>/ \
  -X POST -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"trace_filter","params":[]}'
const res = await fetch("https://<your-endpoint>/", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
  "id": 1,
  "method": "trace_filter",
  "params": [],
  "jsonrpc": "2.0"
}),
});
const data = await res.json();
import requests
resp = requests.post("https://<your-endpoint>/", json={"id":1,"method":"trace_filter","params":[],"jsonrpc":"2.0"})
print(resp.json())

Usage

  1. Transport: HTTP (JSON-RPC).
  2. Networks: mainnet.
  3. Credit cost: 5 per call.

FAQ

What does trace_filter do?
Returns all transaction traces (call frames) across a range of blocks that match an optional sender/recipient filter, with cursor-style pagination.
How many credits does trace_filter cost?
trace_filter costs 5 credit(s) per call on Triport by default.
Is trace_filter available over WebSocket?
trace_filter is an HTTP JSON-RPC method.