eth_getBlockByNumber

eth_getBlockByNumber returns the full block data for a Polygon PoS block at a given height or named tag (latest, finalized, safe, pending, earliest). It is the height-keyed twin of eth_getBlockByHash and the natural way to walk the chain forward in an indexer, since Polygon seals a new Bor block about every 2 seconds. Any transactions it contains paid gas in MATIC. Point the call at https://polygon.therpc.io/YOUR_API_KEY (chain ID 137, 0x89) and choose whether to include full transaction objects or just hashes.

Use cases

• Walk Polygon forward block-by-block in an indexer, advancing through its ~2-second blocks.
• Fetch the latest block to drive a real-time Polygon monitoring dashboard.
• Read the finalized block to anchor queries that must survive a Bor reorg — that block's Heimdall checkpoint is already committed to Ethereum.
• Pull all transaction hashes from a block (with includeTransactions=false) before fetching their receipts in bulk via eth_getBlockReceipts.

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_getBlockByNumber",
7    "params": [
8        "latest",
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.
• When you need every receipt in a Polygon block, prefer one eth_getBlockReceipts call over N separate eth_getTransactionReceipt calls.
• With includeTransactions=true, a heavily loaded Polygon block can return a 1–2 MB payload; budget bandwidth or fetch hashes only and pull details on demand.

Supported networks

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

See also

• eth_getBlockByHash
• eth_getBlockReceipts
• eth_blockNumber
• eth_getBlockTransactionCountByNumber

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