trace_filter

Finds call traces matching a block range and address filters.

Erigon reference · All supported methods

Parameters

Parameters are positional, in the order below.

Parameter	Type	Required	Description
filter	Object	Yes	Block bounds, address filters, after, and count; see the fields below.

Filter fields

Field	Meaning
fromBlock, toBlock	Inclusive block bounds
fromAddress, toAddress	Arrays of addresses to match on call actions
after	Number of matching traces to skip; defaults to zero
count	Number of matching traces requested for the page; required by Direct

Return value

An array of call traces. Each entry identifies the action, result or execution error, call path, and containing transaction/block where applicable.

Example

Replace <gateway-url> with your gateway base URL and <service-url> with the chain’s service path, such as service/ethereum.

curl -X POST "<gateway-url>/<service-url>" \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":1,"method":"trace_filter","params":[{"fromBlock":"0x100","toBlock":"0x1ff","count":100,"after":0}]}'

Illustrative response; values depend on the selected network and request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

Direct behavior

The gateway selects providers supporting the requested tracing group and format. Unsupported formats are rejected rather than replaced.

The tracing group must cover the requested historical blocks or transactions. Providers may supply the result using retained trace indexes or replay; Direct checks the advertised coverage.

Limits

Search up to 1,000 blocks, counting both endpoints. Supply count explicitly from 1 through 1,000; after defaults to zero and cannot exceed 10,000.

A requested page must be complete within the shared limits. Reaching an output or waiting limit returns an error, not a shorter page disguised as success. Use smaller block ranges when the search needs more pages than the offset limit permits. The log-query range allowance does not apply.

Reconstruction, internal splitting, and recovery share the gateway deadline; none gives the request an unlimited fresh budget.

For providers

Qualify for the entire applicable tracing group, including required formats and options. Historical combinations are verified separately; recent success alone does not establish historical coverage.

See provider qualification for checks and continued eligibility.