Skip to main content

debug_traceBlockByNumber RPC Method

Returns the tracing result by executing all transactions in the block specified by number with a tracer.

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

blockNumber
string
REQUIRED

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, Gnosis, Arbitrum, Arbitrum Nova, and Avalanche C-chain

object
object
REQUIRED

The tracer object with the following fields:

tracer
string

The type of tracer. It could be callTracer or prestateTracer

callTracer
string

The calltracer keeps track of all call frames, including depth 0 calls, that are made during a transaction

prestateTracer
string

The prestateTracer replays the transaction and tracks every part of state that occured during the transaction

tracerConfig
object

The object to specify the configurations of the tracer

onlyTopCall
boolean

When set to true, this will only trace the primary (top-level) call and not any sub-calls. It eliminates the additional processing for each call frame

Returns

array
array

The array of transaction trace results

txHash
string

The hash of the traced transaction

result
object

The trace result object containing the execution details of the transaction

type
string

The type of the call such as CALL or STATICCALL

from
string

The address the call was made from

to
string

The address the call was made to

value
string

The amount of value transferred in wei encoded as hexadecimal

gas
string

The amount of gas provided for the call encoded as hexadecimal

gasUsed
string

The amount of gas consumed during the call encoded as hexadecimal

input
string

The data sent with the call

output
string

The data returned from the call

calls
array

The list of internal sub-calls triggered during the execution

type
string

The type of the sub-call such as CALL or STATICCALL

from
string

The address the sub-call was made from

to
string

The address the sub-call was made to

value
string

The amount of value transferred in the sub-call encoded as hexadecimal

gas
string

The amount of gas provided for the sub-call encoded as hexadecimal

gasUsed
string

The amount of gas consumed during the sub-call encoded as hexadecimal

input
string

The data sent with the sub-call

output
string

The data returned from the sub-call

error
string

The error message if the sub-call failed such as execution reverted

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"txHash": "0xad8b5a9c405d28b4ba5153abfeb7ddf0800e01d9a09ca2914297ff3d9760a334",
7
"result": {
8
"calls": [
9
{
10
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
11
"gas": "0x958136",
12
"gasUsed": "0xb4d",
13
"input": "0x0902f1ac",
14
"output": "0x0000000000000000000000000000000000000000000000000000003473208dc700000000000000000000000000000000000000000000003fed5b32a8ef74bda80000000000000000000000000000000000000000000000000000000068cd8a1e",
15
"to": "0xc71f9e1de80eb505c0cb3bbf90ae6593130e5d25",
16
"type": "STATICCALL"
17
},
18
{
19
"error": "execution reverted",
20
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
21
"gas": "0x955d04",
22
"gasUsed": "0x2d0",
23
"input": "0x3850c7bd",
24
"to": "0x2b59b462103efaa4d04e869d62985b43b46a93c9",
25
"type": "STATICCALL"
26
}
27
],
28
"from": "0xaef7197e050a8eac5f94ea335d97847dd0a77fd4",
29
"gas": "0x989680",
30
"gasUsed": "0x30ee8",
31
"input": "0x",
32
"to": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
33
"type": "CALL",
34
"value": "0x0"
35
}
36
},
37
{
38
"txHash": "0x4076876d4c070b0e0c8da94083f098a35de5ead026205870de9e228e406c1334",
39
"result": {
40
"calls": [
41
{
42
"from": "0x164d9b632f0eca9c47e52fe4f8467e4d9eb5149c",
43
"gas": "0x53022e",
44
"gasUsed": "0xa04",
45
"input": "0x70a082310000000000000000000000003ea2a2f97a8bf3bbb1a3539bce45c612982ea9bf",
46
"output": "0x0000000000000000000000000000000000000000000000d566dee92b9f3b0ec1",
47
"to": "0xe538905cf8410324e03a5a23c1c177a474d59b2b",
48
"type": "STATICCALL"
49
},
50
{
51
"from": "0x164d9b632f0eca9c47e52fe4f8467e4d9eb5149c",
52
"gas": "0x52ecd4",
53
"gasUsed": "0xa04",
54
"input": "0x70a0823100000000000000000000000007acace793c28a3936645c1906cea701dd757f04",
55
"output": "0x00000000000000000000000000000000000000000000000a84b70691eba7bf20",
56
"to": "0xe538905cf8410324e03a5a23c1c177a474d59b2b",
57
"type": "STATICCALL"
58
}
59
],
60
"from": "0x91e2f8e3b81ccd4d12865ae3fab7e42ab9666666",
61
"gas": "0x54c563",
62
"gasUsed": "0x15ee1",
63
"input": "0x290c05ea0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000b0000000000000000000000003ea2a2f97a8bf3bbb1a3539bce45c612982ea9bf00000000000000000000000007acace793c28a3936645c1906cea701dd757f04000000000000000000000000c23522b8303874a77d239117f8d66a1ea74047020000000000000000000000004a2407054a73e2834bcab3b7e22420ab02ca46ca000000000000000000000000c71f9e1de80eb505c0cb3bbf90ae6593130e5d2500000000000000000000000032d6b77ee026d471c191ea9ef9ed404d2cb4d4a60000000000000000000000004e6c7d221b5fa285aabdd8c7fa692bc0c79e7d8b000000000000000000000000dd755ebc1c84bdcdf31177f2f20ed9ae3e936854000000000000000000000000d352a852a328d7eccc8bbf63e2e1dd73c68527cd000000000000000000000000fb43803eaf41a516c062e7cfb9d77c65c523590700000000000000000000000076451ea2075ef09f0e31ea86204547ac0caf3647",
64
"to": "0x164d9b632f0eca9c47e52fe4f8467e4d9eb5149c",
65
"type": "CALL",
66
"value": "0x0"
67
}
68
},
69
{
70
"txHash": "0x4f0da7dbd75f2d2e32894a11312c081371e18173c86017fb99bfd4249b9547f2",
71
"result": {
72
"calls": [
73
{
74
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
75
"gas": "0x958136",
76
"gasUsed": "0xb4d",
77
"input": "0x0902f1ac",
78
"output": "0x0000000000000000000000000000000000000000000000000000003473208dc700000000000000000000000000000000000000000000003fed5b32a8ef74bda80000000000000000000000000000000000000000000000000000000068cd8a1e",
79
"to": "0xc71f9e1de80eb505c0cb3bbf90ae6593130e5d25",
80
"type": "STATICCALL"
81
},
82
{
83
"error": "execution reverted",
84
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
85
"gas": "0x955d04",
86
"gasUsed": "0x2d0",
87
"input": "0x3850c7bd",
88
"to": "0x2b59b462103efaa4d04e869d62985b43b46a93c9",
89
"type": "STATICCALL"
90
}
91
],
92
"from": "0xaef7197e050a8eac5f94ea335d97847dd0a77fd4",
93
"gas": "0x989680",
94
"gasUsed": "0x30ee8",
95
"input": "0x",
96
"to": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
97
"type": "CALL",
98
"value": "0x0"
99
}
100
}
101
]
102
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": [
5
{
6
"txHash": "0xad8b5a9c405d28b4ba5153abfeb7ddf0800e01d9a09ca2914297ff3d9760a334",
7
"result": {
8
"calls": [
9
{
10
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
11
"gas": "0x958136",
12
"gasUsed": "0xb4d",
13
"input": "0x0902f1ac",
14
"output": "0x0000000000000000000000000000000000000000000000000000003473208dc700000000000000000000000000000000000000000000003fed5b32a8ef74bda80000000000000000000000000000000000000000000000000000000068cd8a1e",
15
"to": "0xc71f9e1de80eb505c0cb3bbf90ae6593130e5d25",
16
"type": "STATICCALL"
17
},
18
{
19
"error": "execution reverted",
20
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
21
"gas": "0x955d04",
22
"gasUsed": "0x2d0",
23
"input": "0x3850c7bd",
24
"to": "0x2b59b462103efaa4d04e869d62985b43b46a93c9",
25
"type": "STATICCALL"
26
}
27
],
28
"from": "0xaef7197e050a8eac5f94ea335d97847dd0a77fd4",
29
"gas": "0x989680",
30
"gasUsed": "0x30ee8",
31
"input": "0x",
32
"to": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
33
"type": "CALL",
34
"value": "0x0"
35
}
36
},
37
{
38
"txHash": "0x4076876d4c070b0e0c8da94083f098a35de5ead026205870de9e228e406c1334",
39
"result": {
40
"calls": [
41
{
42
"from": "0x164d9b632f0eca9c47e52fe4f8467e4d9eb5149c",
43
"gas": "0x53022e",
44
"gasUsed": "0xa04",
45
"input": "0x70a082310000000000000000000000003ea2a2f97a8bf3bbb1a3539bce45c612982ea9bf",
46
"output": "0x0000000000000000000000000000000000000000000000d566dee92b9f3b0ec1",
47
"to": "0xe538905cf8410324e03a5a23c1c177a474d59b2b",
48
"type": "STATICCALL"
49
},
50
{
51
"from": "0x164d9b632f0eca9c47e52fe4f8467e4d9eb5149c",
52
"gas": "0x52ecd4",
53
"gasUsed": "0xa04",
54
"input": "0x70a0823100000000000000000000000007acace793c28a3936645c1906cea701dd757f04",
55
"output": "0x00000000000000000000000000000000000000000000000a84b70691eba7bf20",
56
"to": "0xe538905cf8410324e03a5a23c1c177a474d59b2b",
57
"type": "STATICCALL"
58
}
59
],
60
"from": "0x91e2f8e3b81ccd4d12865ae3fab7e42ab9666666",
61
"gas": "0x54c563",
62
"gasUsed": "0x15ee1",
63
"input": "0x290c05ea0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000b0000000000000000000000003ea2a2f97a8bf3bbb1a3539bce45c612982ea9bf00000000000000000000000007acace793c28a3936645c1906cea701dd757f04000000000000000000000000c23522b8303874a77d239117f8d66a1ea74047020000000000000000000000004a2407054a73e2834bcab3b7e22420ab02ca46ca000000000000000000000000c71f9e1de80eb505c0cb3bbf90ae6593130e5d2500000000000000000000000032d6b77ee026d471c191ea9ef9ed404d2cb4d4a60000000000000000000000004e6c7d221b5fa285aabdd8c7fa692bc0c79e7d8b000000000000000000000000dd755ebc1c84bdcdf31177f2f20ed9ae3e936854000000000000000000000000d352a852a328d7eccc8bbf63e2e1dd73c68527cd000000000000000000000000fb43803eaf41a516c062e7cfb9d77c65c523590700000000000000000000000076451ea2075ef09f0e31ea86204547ac0caf3647",
64
"to": "0x164d9b632f0eca9c47e52fe4f8467e4d9eb5149c",
65
"type": "CALL",
66
"value": "0x0"
67
}
68
},
69
{
70
"txHash": "0x4f0da7dbd75f2d2e32894a11312c081371e18173c86017fb99bfd4249b9547f2",
71
"result": {
72
"calls": [
73
{
74
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
75
"gas": "0x958136",
76
"gasUsed": "0xb4d",
77
"input": "0x0902f1ac",
78
"output": "0x0000000000000000000000000000000000000000000000000000003473208dc700000000000000000000000000000000000000000000003fed5b32a8ef74bda80000000000000000000000000000000000000000000000000000000068cd8a1e",
79
"to": "0xc71f9e1de80eb505c0cb3bbf90ae6593130e5d25",
80
"type": "STATICCALL"
81
},
82
{
83
"error": "execution reverted",
84
"from": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
85
"gas": "0x955d04",
86
"gasUsed": "0x2d0",
87
"input": "0x3850c7bd",
88
"to": "0x2b59b462103efaa4d04e869d62985b43b46a93c9",
89
"type": "STATICCALL"
90
}
91
],
92
"from": "0xaef7197e050a8eac5f94ea335d97847dd0a77fd4",
93
"gas": "0x989680",
94
"gasUsed": "0x30ee8",
95
"input": "0x",
96
"to": "0x243e55d3233a2af3a8d92b1762296a5ad2c207a7",
97
"type": "CALL",
98
"value": "0x0"
99
}
100
}
101
]
102
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free