eth_getBlockByHash

eth_getBlockByHash returns the full block data for the block identified by a given 32-byte hash. Base is Coinbase's OP Stack rollup that uses ETH for gas and produces a block roughly every 2 seconds, so a single hash uniquely pins one L2 block. Send the hash to https://base.therpc.io/YOUR_API_KEY (chain ID 8453) along with a boolean choosing full transaction objects or just hashes, and the node returns the header fields, gas metrics, withdrawals, and transaction list — or null if it has never seen that hash.

Use cases

• Fetch full block data when you already hold a Base block hash — for example the blockHash from a transaction receipt.
• Detect a chain reorganisation by comparing a hash you stored against what the node now returns for that height; a mismatch means the L2 tip moved.
• Retrieve withdrawals, gas metrics (gasUsed, gasLimit, baseFeePerGas), and header fields for a specific canonical Base block.

Parameters

Response

Example request

1curl https://base.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 Base playground.

Errors & troubleshooting

Common pitfalls

• Pass a real JSON boolean for includeTransactions, not the string "true" — the type matters and a string will be rejected or misread.
• With includeTransactions=true, a busy Base block packed with DEX swaps can push the response past 1 MB; stream or fall back to hashes-only if bandwidth is constrained.
• The method returns null for a hash the node has never seen — always null-check before reading fields off the result.

Supported networks

• Mainnet — Chain ID: 8453
• Sepolia — Chain ID: 84532

See also

• eth_getBlockByNumber
• eth_getBlockReceipts
• eth_getTransactionByHash
• eth_getBlockTransactionCountByHash

1curl https://base.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":["",""]}'