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
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.

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, which can be one of the following:

vmTrace
string

To get a full trace of the virtual machine's state during the execution of the given of given transaction, including for any subcells

trace
string

To get the basic trace of the given transaction

stateDiff
string

To get information on altered Ethereum state due to execution of the given 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 block traces object (all return values are hexadecimal strings unless otherwise noted):

output
string

The data returned as an output, encoded in hexadecimal

stateDiff
string

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

trace
array

An array containing the basic trace information of the transaction

type
string

The type of trace, e.g., 'call' or 'create'

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 by the sender, encoded as hexadecimal

input
string

The input data sent along with the transaction, encoded as hexadecimal

to
string

The address of the receiver

value
string

The value sent with this transaction, encoded as hexadecimal

result
object

The result of the call execution

gasUsed
string

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

output
string

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

subtraces
integer

The number of sub-traces (contract calls made by the transaction)

traceAddress
array

A list of addresses representing the call path to this trace

vmTrace
object

The full trace of the EVM state during execution, or empty if not enabled

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"output": "0x",
6
"stateDiff": null,
7
"trace": [
8
{
9
"type": "call",
10
"action": {
11
"from": "0x0000000000000000000000000000000000000000",
12
"callType": "call",
13
"gas": "0x24b8",
14
"input": "0x",
15
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
16
"value": "0x0"
17
},
18
"result": {
19
"gasUsed": "0x0",
20
"output": "0x"
21
},
22
"subtraces": 0,
23
"traceAddress": []
24
}
25
],
26
"vmTrace": null
27
}
28
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": {
5
"output": "0x",
6
"stateDiff": null,
7
"trace": [
8
{
9
"type": "call",
10
"action": {
11
"from": "0x0000000000000000000000000000000000000000",
12
"callType": "call",
13
"gas": "0x24b8",
14
"input": "0x",
15
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
16
"value": "0x0"
17
},
18
"result": {
19
"gasUsed": "0x0",
20
"output": "0x"
21
},
22
"subtraces": 0,
23
"traceAddress": []
24
}
25
],
26
"vmTrace": null
27
}
28
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free