Skip to main content
POST
/
efb0a5eccd2caa5135eb54eba6f7f300
debug_traceBlockByNumber
curl --request POST \
  --url https://optimism-mainnet.core.chainstack.com/efb0a5eccd2caa5135eb54eba6f7f300 \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "id": 1,
  "params": [
    "0x6eee7bc"
  ]
}
'
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": [
    {}
  ]
}
The debug_traceBlockByNumber RPC method is used to retrieve detailed execution traces for all transactions included in a block, identified by the block’s number. This method is particularly useful for developers and analysts who need to deeply understand transaction execution and state changes within a specific block.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Request

To use debug_traceBlockByNumber, send a POST request with a JSON RPC call in the body.

​
Parameters

  • Block Number (string): The number of the block for which to retrieve the execution traces, in hexadecimal format.

​
Response

The response includes detailed execution traces for all transactions in the specified block.
  • result (array): An array of execution traces for each transaction in the block. Each trace provides comprehensive details about the execution, including calls, state changes, and gas usage.

​
Use case

The debug_traceBlockByNumber method is essential for:
  • Developers debugging complex interactions within a block.
  • Analysts conducting forensic analysis of block transactions.
  • Tools and services that provide insights into the Ethereum Virtual Machine (EVM) execution and state changes.

Body

application/json
​
jsonrpc
string
default:2.0
required
​
method
string
default:debug_traceBlockByNumber
required
​
id
integer
default:1
required
​
params
string[]
required

Response

200 - application/json

Detailed execution traces for all transactions in the specified block

​
jsonrpc
string
​
id
integer
​
result
object[]

An array of execution traces for each transaction in the block.

Last modified on August 7, 2025