eth_getBlockByNumber

Returns information about a block by its block number.

Returns information about a block by its block number.

Parameters

blockParameter · string · required

Block number in hexadecimal, or a block tag: latest, earliest, pending, safe, or finalized.

fullTransactions · boolean · required

If true, returns full transaction objects in the transactions array. If false, returns only transaction hashes.

Returns

result · object | null

A block object, or null if no block was found.

Show Block object fields

number · string

Block number as a hex string. null when the block is pending.

hash · string

32-byte hash of the block. null when the block is pending.

parentHash · string

32-byte hash of the parent block.

nonce · string

8-byte proof-of-work nonce. Always "0x0000000000000000" on Base (proof-of-stake).

sha3Uncles · string

32-byte SHA3 hash of the uncles data in the block. Always the empty-uncle-list hash on Base.

logsBloom · string

256-byte bloom filter for the logs of the block.

transactionsRoot · string

32-byte root of the transaction trie.

stateRoot · string

32-byte root of the final state trie.

receiptsRoot · string

32-byte root of the receipts trie.

miner · string

20-byte address of the fee recipient (block proposer on Base).

difficulty · string

Block difficulty. Always "0x0" on Base (proof-of-stake).

totalDifficulty · string

Total chain difficulty. Always "0x0" on Base (proof-of-stake).

extraData · string

Hex-encoded extra data field of the block.

size · string

Integer size of the block in bytes as a hexadecimal.

gasLimit · string

Maximum gas allowed in this block.

gasUsed · string

Total gas used by all transactions in this block.

timestamp · string

Unix timestamp of when the block was collated.

transactions · array

Array of transaction hashes (when fullTransactions is false) or full transaction objects (when true).

uncles · array

Array of uncle block hashes. Always [] on Base.

baseFeePerGas · string

Base fee per gas in this block (EIP-1559).

withdrawals · array

Array of validator withdrawals included in the block (EIP-4895).

withdrawalsRoot · string

32-byte root of the withdrawals trie (EIP-4895).

Flashblocks Behavior

On a Flashblocks-aware endpoint, use "pending" as the block parameter to query preconfirmed state — data available up to 200ms before the next full block is sealed.

When called with "pending", returns the current Flashblock — the block actively being built with preconfirmed transactions, sealed approximately every 200ms.

cURL (preconfirmed state)

curl https://mainnet-preconf.base.org \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["pending",false],"id":1}'

Example

Request

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": ["latest", false],
  "id": 1
}