Skip to main content

trace_filter RPC Method

Returns traces matching given filter (Supported on Erigon).

Updated on
Mar 27, 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
array

The filter object

fromBlock
string
REQUIRED

The block number (Quantity) or tag (e.g., 'latest', 'earliest', 'pending') from which to start

toBlock
string
REQUIRED

The block number (Quantity) or tag up to which to include traces

fromAddress
array

An array of sender addresses

toAddress
array

An array of receiver addresses

after
integer

The offset trace number (used for pagination)

count
integer

The number of traces to display in a batch

Returns

array
array

The block traces (all return values are hexadecimal unless otherwise noted):

action
object

The action performed in this trace step

from
string

The address of the sender

callType
string

The type of call such as 'call' or 'delegatecall'

gas
string

The gas provided for the call, encoded as hexadecimal

input
string

The input data sent with the transaction, encoded as hexadecimal

to
string

The address of the receiver

value
string

The value sent with this transaction, encoded as hexadecimal

blockHash
string

The hash of the block containing this transaction

blockNumber
integer

The block number containing this transaction

result
object

The result of the call execution

gasUsed
string

The amount of gas used by this specific call, encoded as hexadecimal

output
string

The return value from the contract call; contains bytes returned by the RETURN opcode, or '0x' if empty

subtraces
integer

The number of sub-traces (nested calls) made by this transaction

traceAddress
array

The call path to this trace (an array of integers representing call depth and order)

transactionHash
string

The hash of the transaction

transactionPosition
integer

The position of the transaction within the block

type
string

The type of trace, e.g., 'call' or '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