Skip to main content

trace_filter RPC Method

Returns traces matching given filter (Trace Mode required, and supported only on OpenEthereum & Erigon).

Updated on
Jul 28, 2025

trace_filter RPC Method

Please note that this RPC method is available to all users on the Build plan and higher. If you are using the Free plan, you will need to upgrade to utilize this method. See our pricing for more information.

Parameters

object
array
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
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free