Docs

eth_getBlockByNumber - Base RPC Method

Retrieve complete block data by block number on Base. Perfect for consumer app developers, SocialFi builders, and teams seeking easy fiat onramps building on Coinbase's L2 with 54% of L2 market revenue and direct access to 110M+ Coinbase users.

Returns information about a block by block number on Base.

Why Base? Build on Coinbase's L2 with 54% of L2 market revenue and direct access to 110M+ Coinbase users with $8B+ TVL, $0.08 gas fees, built-in Coinbase distribution, and seamless fiat rails.

Use Cases

The eth_getBlockByNumber method is essential for:

  • Block explorers - Display complete block information
  • Transaction indexers - Process all transactions in a block
  • Analytics platforms - Analyze blockchain data for consumer dApps, SocialFi, NFT marketplaces, and merchant payment integrations
  • Timestamp verification - Get block timestamps for time-based logic

Code Examples

Error Handling

Error CodeMessageDescription
-32602Invalid paramsInvalid block number or parameter format
-32000Block not foundBlock does not exist