eth_getBlockByHash

eth_getBlockByHash returns the full block object for the OP Mainnet block identified by a given 32-byte hash — header fields, gas metrics, withdrawals, and either transaction hashes or full transaction objects. OP Mainnet is an OP Stack rollup that pays gas in ETH and produces blocks about every 2 seconds, so block hashes turn over quickly. Send the request to https://optimism.therpc.io/YOUR_API_KEY (chain ID 10, 0xa); an unknown hash returns null.

Use cases

• Fetch full block data when you already hold a specific OP Mainnet block hash, e.g. the blockHash from a transaction receipt.
• Detect L2 reorganisations by comparing a stored hash against what the node now returns for that block number — a mismatch means the sequencer's chain changed.
• Retrieve withdrawals, gas metrics, and header fields for a specific canonical OP Mainnet block for indexing or auditing.

Parameters

Response

Example request

1curl https://optimism.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 Optimism playground.

Errors & troubleshooting

Common pitfalls

• Pass a real boolean for includeTransactions, not the string "true" — JSON-RPC distinguishes the two and a string is rejected.
• With includeTransactions=true, a busy OP Mainnet block can return well over 1 MB of transaction objects; stream or chunk the response if bandwidth is constrained.
• An unknown hash returns null, not an error — always null-check before reading fields like number or transactions.

Supported networks

• Mainnet — Chain ID: 10
• Sepolia — Chain ID: 11155420

See also

• eth_getBlockByNumber
• eth_getBlockReceipts
• eth_getTransactionByHash
• eth_getBlockTransactionCountByHash

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