debug_traceBlockByNumber

Reach for debug_traceBlockByNumber when you think in heights rather than hashes. You name a block by its hex number or by a tag like latest, earliest, or pending, and the node returns an opcode-level trace of every transaction it contains. That addressing fits the common jobs: walking a contiguous range of heights, or grabbing whatever block sits at the tip right now. BNB Smart Chain (BSC) mints those blocks roughly every three seconds and charges gas in BNB, so the tip moves fast. Point the call at chain ID 56 via https://bsc.therpc.io/YOUR_API_KEY. A full-block replay is heavy work, and it needs a debug-enabled archive node to reach back past the recent window.

Use cases

• Trace every transaction at a known height in one pass to audit all of that block's state transitions together.
• Pull a whole block's call graph for MEV research with callTracer, mapping how value moves transaction to transaction.
• Line up per-transaction gas profiles across a block and flag the outliers worth a closer look.

Parameters

Response

Example request

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5    "jsonrpc": "2.0",
6    "method": "debug_traceBlockByNumber",
7    "params": [
8        "latest",
9        {}
10      ],
11    "id": 1
12  }'

Try it live in the BNB Smart Chain playground.

Errors & troubleshooting

Common pitfalls

• A full-block replay re-runs every transaction inside, so a busy BSC block can take minutes and spill gigabytes of structLog data.
• Historical heights need an archive node. A non-archive node keeps only the recent window and rejects older blocks outright.
• The latest tag works but races the three-second cadence, so the height you trace can advance between request and response, and lower tiers may rate-limit the call.

Supported networks

• Mainnet — Chain ID: 56
• Testnet — Chain ID: 97

See also

• debug_traceBlockByHash
• debug_traceBlock
• debug_traceTransaction
• trace_block

1curl https://bsc.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H 'Content-Type: application/json' \
4  -d '{"jsonrpc":"2.0","id":1,"method":"debug_traceBlockByNumber","params":["latest",{}]}'