debug_traceBlockByHash

debug_traceBlockByHash re-executes a whole Polygon PoS block and hands back a trace for each transaction it contains, selected by the block's hash rather than its number. Polygon's Bor client is Geth-based, so the same tracers you use on Ethereum — callTracer, prestateTracer, or the default opcode struct-log — apply here against 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 hash, in block order.

Use cases

• Deterministically trace one specific Polygon block when you hold only its hash — for example from a reorg investigation near a Heimdall checkpoint.
• Audit every internal call inside a known side-branch block that Bor saw but did not keep on the canonical chain.
• Build a block-level call graph for MEV analysis on Polygon DEX traffic (QuickSwap, aggregators) using callTracer.

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_traceBlockByHash",
7    "params": [
8        "0x0000000000000000000000000000000000000000000000000000000000000000",
9        {}
10      ],
11    "id": 1
12  }'

Try it live in the Polygon playground.

Errors & troubleshooting

Common pitfalls

• This costs the same as debug_traceBlockByNumber: the node replays every transaction in the block, so a dense Polygon block is far heavier than a single-transaction trace.
• Historical blocks need a Bor archive node; with ~2-second block times the state behind older Polygon blocks is pruned from full nodes quickly.
• Blocks packed with complex DeFi transactions can exceed the default trace timeout on a remote node — narrow the tracer config or retry with a longer timeout.

Supported networks

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

See also

• debug_traceBlockByNumber
• 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_traceBlockByHash","params":["0x0000000000000000000000000000000000000000000000000000000000000000",{}]}'