debug_traceBlockByNumber

debug_traceBlockByNumber replays an entire Polygon PoS block and returns a per-transaction trace, selecting the block by its height or a tag like latest. Polygon's Bor client is built on Geth, so the standard callTracer, prestateTracer, and default struct-log tracers run unchanged against these MATIC-fee blocks. Send the request to https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89). It returns opcode-level execution traces for every transaction in the block identified by its number or tag, in the order they were mined.

Use cases

• Trace every transaction in a known Polygon block height to audit all state transitions in one request.
• Extract the complete call graph for a whole block for MEV research on Polygon DEX flow using callTracer.
• Compare the gas profiles of all transactions in a block to spot outliers — useful given Polygon's low-fee, high-volume traffic.

Parameters

Response

Example request

1curl https://polygon.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 Polygon playground.

Errors & troubleshooting

Common pitfalls

• Tracing a full block replays every transaction in it; a busy Polygon block can take a long time and return very large payloads, so prefer a compact tracer for bulk runs.
• Historical blocks require a Bor archive node — non-archive Polygon nodes hold only recent state, which the ~2-second block cadence prunes fast.
• Tags like latest are valid but race with new blocks: a fresh Polygon block may land mid-request, so pin to a concrete number for reproducible results.

Supported networks

• Mainnet — Chain ID: 137
• Amoy — Chain ID: 80002

See also

• debug_traceBlockByHash
• debug_traceBlock
• debug_traceTransaction
• trace_block

1curl https://polygon.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",{}]}'