Skip to main content

trace_filter RPC Method

Returns traces matching given filter (Supported on Erigon).

Updated on
Apr 03, 2026
This RPC method is included in the Free Trial with limited usage. Upgrade your plan to get full access and higher limits. Learn more onĀ our pricing page.
Please be aware that the maximum block range limit for this RPC method is 10,000 blocks for those on paid plans. Consider dividing your queries into smaller segments to enhance response times and manage errors more effectively. For further details on the block range limit and strategies for mitigating it, please consult the FAQ

Parameters

object
object

The filter object

fromBlock
string

The Quantity or Tag from this block

toBlock
string

The Quantity or Tag to this block

fromAddress
array

An array addresses of the senders

toAddress
array

An array addresses of the receivers

after
string

The offset trace number

count
integer

The integer number of traces to display in a batch

Returns

result
array

The list of trace objects. All numeric values are hexadecimal strings unless otherwise noted.

action
object

The action object describing the operation performed

callType
string

The type of call (e.g., call, staticcall, delegatecall, create)

from
string

The address initiating the call

to
string

The target address of the call

value
string

The amount of value sent with the call (in wei)

gas
string

The gas provided for the call

input
string

The input data sent with the call

blockHash
string

The hash of the block containing this transaction

blockNumber
integer

The number of the block containing this transaction

result
object

The result of the traced call

gasUsed
string

The amount of gas used by this call

output
string

The return value from the call (if any)

subtraces
integer

The number of sub-calls (internal calls) performed in this trace

traceAddress
array

An array of integers indicating the location in the call tree

transactionHash
string

The hash of the traced transaction

transactionPosition
integer

The index position of the transaction within the block

type
string

The type of trace (e.g., call, create)

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"action": {
7
"from": "0xedc763b3e418cd14767b3be02b667619a6374076",
8
"callType": "call",
9
"gas": "0x8462",
10
"input": "0x095ea7b30000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488dffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
11
"to": "0x7ff4169a6b5122b664c51c95727d87750ec07c84",
12
"value": "0x0"
13
},
14
"blockHash": "0x351e7c06ec010c8f7e7358eb580238dd23e1e129be96822aa93ebb6da08558e6",
15
"blockNumber": 13416771,
16
"result": {
17
"gasUsed": "0x6009",
18
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
19
},
20
"subtraces": 0,
21
"traceAddress": [],
22
"transactionHash": "0x054bbb9fbb855bf23f755e548c7409f45fc5eff8a824b2ad06380bc038d7b049",
23
"transactionPosition": 54,
24
"type": "call"
25
}
26
]
27
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"action": {
7
"from": "0xedc763b3e418cd14767b3be02b667619a6374076",
8
"callType": "call",
9
"gas": "0x8462",
10
"input": "0x095ea7b30000000000000000000000007a250d5630b4cf539739df2c5dacb4c659f2488dffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
11
"to": "0x7ff4169a6b5122b664c51c95727d87750ec07c84",
12
"value": "0x0"
13
},
14
"blockHash": "0x351e7c06ec010c8f7e7358eb580238dd23e1e129be96822aa93ebb6da08558e6",
15
"blockNumber": 13416771,
16
"result": {
17
"gasUsed": "0x6009",
18
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
19
},
20
"subtraces": 0,
21
"traceAddress": [],
22
"transactionHash": "0x054bbb9fbb855bf23f755e548c7409f45fc5eff8a824b2ad06380bc038d7b049",
23
"transactionPosition": 54,
24
"type": "call"
25
}
26
]
27
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free