Skip to main content

trace_callMany RPC Method

Performs multiple call traces on top of the same block, allowing dependent transactions to be traced.

Updated on
Jul 31, 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

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 transaction, including for any subcalls

trace
string

To get the basic trace of the given transaction

stateDiff
string

To get information on the state altered by the 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, and pending for the pending state/transactions

Returns

array
array

The list of traced calls, one entry per requested call, which have the following fields (please note that all return types are hexadecimal representations of their data type unless otherwise stated):

output
string

The data which is returned as an output encoded in hexadecimal format

stateDiff
object

The state altered by the execution of the call, keyed by account address, and it is null when the stateDiff tracer is not requested

trace
array

The basic traces of the call:

action
object

The action to be performed on the receiver id:

callType
string

The type of method such as call or delegatecall

from
string

The address of the sender

gas
string

The gas provided by the sender, encoded as hexadecimal

input
string

The data sent along with the call

to
string

The address of the receiver

value
string

The integer of the value sent with this call, encoded as hexadecimal

blockHash
string

The hash of the block in which the call was simulated

blockNumber
integer

The number of the block in which the call was simulated (stated in decimal)

result
object

The result of the call:

gasUsed
string

The amount of gas used by this call alone

output
string

The value returned by the contract call, and it only contains the actual value sent by the RETURN method. If the RETURN method was not executed, the output is empty bytes

subtraces
integer

The number of contract calls made by this call

traceAddress
array

The list of addresses where the call executed, the address of the parents and the order of the current sub call

transactionHash
string

The hash of the simulated transaction the trace belongs to

transactionPosition
integer

The position of the simulated transaction in the block (stated in decimal)

type
string

The value of the method such as call or create

vmTrace
object

The full trace of the virtual machine's state during the execution of the call, including for any sub-calls, and it is null when the vmTrace tracer is not requested

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"output": "0x",
7
"stateDiff": null,
8
"trace": [
9
{
10
"action": {
11
"callType": "call",
12
"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",
13
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
14
"value": "0x186a0",
15
"gas": "0x23c2f3f8",
16
"input": "0x"
17
},
18
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
19
"blockNumber": 76639225,
20
"result": {
21
"gasUsed": "0x393f29d",
22
"output": "0x"
23
},
24
"subtraces": 1,
25
"traceAddress": [],
26
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
27
"transactionPosition": 0,
28
"type": "call"
29
},
30
{
31
"action": {
32
"callType": "call",
33
"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
34
"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",
35
"value": "0x186a0",
36
"gas": "0x2333c385",
37
"input": "0x"
38
},
39
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
40
"blockNumber": 76639225,
41
"result": {
42
"gasUsed": "0x0",
43
"output": "0x"
44
},
45
"subtraces": 0,
46
"traceAddress": [
47
0
48
],
49
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
50
"transactionPosition": 0,
51
"type": "call"
52
}
53
],
54
"vmTrace": null
55
},
56
{
57
"output": "0x",
58
"stateDiff": null,
59
"trace": [
60
{
61
"action": {
62
"callType": "call",
63
"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",
64
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
65
"value": "0x186a0",
66
"gas": "0x23c2f3f8",
67
"input": "0x"
68
},
69
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
70
"blockNumber": 76639225,
71
"result": {
72
"gasUsed": "0x393f29d",
73
"output": "0x"
74
},
75
"subtraces": 1,
76
"traceAddress": [],
77
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
78
"transactionPosition": 1,
79
"type": "call"
80
},
81
{
82
"action": {
83
"callType": "call",
84
"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
85
"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",
86
"value": "0x186a0",
87
"gas": "0x2333c385",
88
"input": "0x"
89
},
90
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
91
"blockNumber": 76639225,
92
"result": {
93
"gasUsed": "0x0",
94
"output": "0x"
95
},
96
"subtraces": 0,
97
"traceAddress": [
98
0
99
],
100
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
101
"transactionPosition": 1,
102
"type": "call"
103
}
104
],
105
"vmTrace": null
106
}
107
]
108
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"output": "0x",
7
"stateDiff": null,
8
"trace": [
9
{
10
"action": {
11
"callType": "call",
12
"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",
13
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
14
"value": "0x186a0",
15
"gas": "0x23c2f3f8",
16
"input": "0x"
17
},
18
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
19
"blockNumber": 76639225,
20
"result": {
21
"gasUsed": "0x393f29d",
22
"output": "0x"
23
},
24
"subtraces": 1,
25
"traceAddress": [],
26
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
27
"transactionPosition": 0,
28
"type": "call"
29
},
30
{
31
"action": {
32
"callType": "call",
33
"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
34
"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",
35
"value": "0x186a0",
36
"gas": "0x2333c385",
37
"input": "0x"
38
},
39
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
40
"blockNumber": 76639225,
41
"result": {
42
"gasUsed": "0x0",
43
"output": "0x"
44
},
45
"subtraces": 0,
46
"traceAddress": [
47
0
48
],
49
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
50
"transactionPosition": 0,
51
"type": "call"
52
}
53
],
54
"vmTrace": null
55
},
56
{
57
"output": "0x",
58
"stateDiff": null,
59
"trace": [
60
{
61
"action": {
62
"callType": "call",
63
"from": "0x53b9ad09b82a313ec07040f6d8cb07bb6fd6e7ce",
64
"to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
65
"value": "0x186a0",
66
"gas": "0x23c2f3f8",
67
"input": "0x"
68
},
69
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
70
"blockNumber": 76639225,
71
"result": {
72
"gasUsed": "0x393f29d",
73
"output": "0x"
74
},
75
"subtraces": 1,
76
"traceAddress": [],
77
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
78
"transactionPosition": 1,
79
"type": "call"
80
},
81
{
82
"action": {
83
"callType": "call",
84
"from": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
85
"to": "0x62b397afd9dfb2166c57323fa3bbeaaceecb3460",
86
"value": "0x186a0",
87
"gas": "0x2333c385",
88
"input": "0x"
89
},
90
"blockHash": "0xaedaf812a55ca2085b435ed03ea0aca3c6f5ca14042a839b4aafa71d7aaa7558",
91
"blockNumber": 76639225,
92
"result": {
93
"gasUsed": "0x0",
94
"output": "0x"
95
},
96
"subtraces": 0,
97
"traceAddress": [
98
0
99
],
100
"transactionHash": "0xede69d00ba89e8e7ebaed83dee481f0eb087d1f4cac4216d5be434c74a63cce1",
101
"transactionPosition": 1,
102
"type": "call"
103
}
104
],
105
"vmTrace": null
106
}
107
]
108
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free