eth_getBlockByNumber

eth_getBlockByNumber returns the block data for an Avalanche C-Chain block at a given height or named tag such as latest or finalized. You get the full header — timestamp, gas usage, the AVAX-denominated base fee — plus either transaction hashes or full transaction objects. It is the height-keyed way to walk the C-Chain, and because Snowman finality lands in roughly one to two seconds, the finalized tag is rarely far behind latest. Query https://avalanche.therpc.io/YOUR_API_KEY (chain ID 43114).

Use cases

• Walk the C-Chain forward block-by-block in an indexer, incrementing the height each step.
• Fetch the latest block for a real-time Avalanche monitoring dashboard; at ~1–2s block times it refreshes quickly.
• Retrieve the finalized block to anchor queries that must be reorg-safe under Snowman consensus.
• Pull all transaction hashes from a block (with includeTransactions=false) before fetching receipts in bulk.

Parameters

Response

Example request

1curl https://avalanche.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 Avalanche playground.

Errors & troubleshooting

Common pitfalls

• Pass a real boolean for includeTransactions, not the string "true" — the JSON-RPC type check will reject a quoted value.
• When you need every receipt in a block, prefer eth_getBlockReceipts over N individual eth_getTransactionReceipt calls — far fewer round trips against the C-Chain.
• With includeTransactions=true, the response can reach 1–2 MB for a heavily loaded C-Chain block; budget bandwidth accordingly.

Supported networks

• Mainnet — Chain ID: 43114
• Fuji

See also

• eth_getBlockByHash
• eth_getBlockReceipts
• eth_blockNumber
• eth_getBlockTransactionCountByNumber

1curl https://avalanche.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]}'