Skip to main content

trace_call RPC Method

Executes a new message call and returns a number of possible traces (Supported on Erigon).

Updated on
Apr 16, 2026
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 transaction call object which contains the following fields:

from
string

The string of the address the transaction is sent from

to
string
REQUIRED

The string of the address to the transaction is directed to

gas
integer

The integer of the gas provided for the transaction execution

gasPrice
integer

The integer of the gasPrice used for each paid gas encoded as hexadecimal

value
integer

The integer of the value sent with this transaction encoded as hexadecimal

data
string

The string of the hash of the method signature and encoded parameters, see the Ethereum Contract ABI

array
array
REQUIRED

The type of trace to retrieve. One or more of: trace (basic call trace), vmTrace (full VM execution trace), stateDiff (state changes due to the transaction)

blockNumber
string

The block number as a string in hexadecimal format or tags. The supported tag values include earliest for the earliest/genesis block, latest for the latest mined block, pending for the pending state/transactions, safe for the most recent secure block, and finalized for the most recent secure block accepted by more than 2/3 of validators. safe and finalized are only supported on Ethereum and Gnosis

Returns

object
object

The transaction trace result object

output
string

The data returned as output encoded in hexadecimal format

stateDiff
object

The altered Ethereum state due to execution of the given transaction, or null if not available

trace
array

An array of basic trace objects for the given transaction

action
object

The action performed during the trace

from
string

The address of the sender

callType
string

The type of call such as call, staticcall, delegatecall

gas
string

The gas provided by the sender, encoded as hexadecimal

input
string

The data sent along with the transaction

to
string

The address of the receiver

value
string

The value sent with this transaction, encoded as hexadecimal

result
object

The execution result of the trace

gasUsed
string

The amount of gas used by this trace

output
string

The return value of the contract call, empty if no RETURN executed

subtraces
integer

The number of subtraces (internal calls) within this trace

traceAddress
array

The list of addresses where the call executed, including parent calls and order

type
string

The type of the trace, such as call or create

vmTrace
object

The full trace of the virtual machine's state during execution, including sub-calls, or null if not available

Request
Response
1
{
2
"id": 1,
3
"jsonrpc": "2.0",
4
"error": {
5
"code": -32601,
6
"message": "the method trace_call does not exist/is not available"
7
}
8
}
1
{
2
"id": 1,
3
"jsonrpc": "2.0",
4
"error": {
5
"code": -32601,
6
"message": "the method trace_call does not exist/is not available"
7
}
8
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free