Docs · method · EVM
eth_getBlockByHash
| Units per call | 1 (standard) |
|---|---|
| Cache | final — cached 1 week once the block is 64 blocks below the head |
| Rule | 1 unit on a miss; by-hash lookups are cached only once 64 blocks of finality sit above them, so no reorg can serve a stale answer. Pending transactions are never cached. |
| Chains | Ethereum Mainnet · Base Mainnet · Arbitrum One · OP Mainnet · Polygon PoS |
| Specification | https://ethereum.github.io/execution-apis/api-documentation/ |
Example
curl -s https://flexyield.io/rpc/eth_mainnet \
-H "Authorization: Bearer $FLEXYIELD_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"eth_getBlockByHash","params":["0x<hash>",false]}'Questions
When is eth_getBlockByHash cached?
Once the referenced block is 64 blocks below the chain head; then for 1 week.
All methods: methods and limits · docs · AI agents: the same call is the rpc_call MCP tool.