trace_replayBlockTransactions

trace_replayBlockTransactions re-runs every transaction in a Polygon PoS block and returns, for each one, whichever combination of trace types you ask for. It is the block-wide counterpart of trace_replayTransaction, well suited to building a complete state-diff record of an entire MATIC-fee block in a single call. Send the request to https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89), passing the block and the traceTypes you need. It replays all transactions in the block and returns a selectable combination of call-tree trace, VM trace, and state diff for each.

Use cases

• Produce a complete stateDiff audit for every transaction in a Polygon block, feeding a chain analytics pipeline.
• Reconstruct all MATIC and token balance changes in a block for accounting or reconciliation.
• Analyze the full execution flow of every transaction in a known Polygon MEV block in one pass.

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": "trace_replayBlockTransactions",
7    "params": [
8        "latest",
9        [
10          "trace"
11        ]
12      ],
13    "id": 1
14  }'

Try it live in the Polygon playground.

Errors & troubleshooting

Common pitfalls

• This is the heaviest method in the trace namespace: it replays every transaction and computes the requested trace types for each, so a busy Polygon block can time out — keep traceTypes minimal.
• It requires a trace-enabled Bor archive node; a plain Polygon full node cannot serve it.
• Combining all three trace types on a dense Polygon block can yield hundreds of MB of data, so request stateDiff or trace alone unless you genuinely need the opcode-level vmTrace.

Supported networks

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

See also

• trace_block
• trace_replayTransaction
• trace_call
• debug_traceBlockByNumber

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":"trace_replayBlockTransactions","params":["",[]]}'