eth_getBlockByHash

eth_getBlockByHash returns the full block data for the Polygon PoS block identified by a given hash — header fields, gas metrics, and either transaction hashes or full transaction objects. It is the hash-keyed counterpart to eth_getBlockByNumber, and because a hash pins one exact block, it is the reliable way to detect reorgs of Bor blocks before their Heimdall checkpoint settles on Ethereum. Fees in any contained transactions are denominated in MATIC. Send the request to https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89).

Use cases

• Fetch full block data when you already hold a Polygon block hash — for example one pulled from a transaction receipt.
• Detect a Bor reorg by comparing a stored hash against the hash the node now returns for that height.
• Retrieve gas metrics, the baseFeePerGas, the producer, and other header fields for a specific canonical Polygon block.

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

Try it live in the Polygon playground.

Errors & troubleshooting

Common pitfalls

• Pass a real boolean for includeTransactions, not the string "true" — JSON-RPC requires the boolean type or the node rejects the request.
• With includeTransactions=true, a busy Polygon block packed with DeFi and stablecoin transfers can push the response past 1 MB; stream or paginate when bandwidth is tight.
• An unknown hash returns null, not an error — always null-check before reading fields.

Supported networks

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

See also

• eth_getBlockByNumber
• eth_getBlockReceipts
• eth_getTransactionByHash
• eth_getBlockTransactionCountByHash

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