eth_getBlockByNumber

Returns block information by number.

Returns information about a block by its number.

Since Denim, Base produces a canonical block every 200ms and Flashblocks are retired. The "pending" tag is still accepted, but it no longer returns Flashblocks preconfirmation state. Use "latest" for the newest canonical block. See Migrate From Flashblocks.

​

Parameters

block · string · required

Block number in hex, or "latest", "pending", "safe", "finalized", "earliest".

fullTransactions · boolean · required

If true, returns full transaction objects. If false, returns only transaction hashes.

​

Returns

result · object

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

Show Block Fields

number · string

Block number in hex.

hash · string

Block hash.

parentHash · string

Hash of the parent block.

nonce · string

PoW nonce. Always "0x0000000000000000" on Base (PoS).

sha3Uncles · string

Hash of the uncles list. Always empty on Base.

logsBloom · string

Bloom filter for the block’s logs.

transactionsRoot · string

Root of the transaction trie.

stateRoot · string

Root of the final state trie.

receiptsRoot · string

Root of the receipts trie.

miner · string

Address of the fee recipient (coinbase).

difficulty · string

Always "0x0" on Base (PoS).

mixHash · string

Present in all blocks; repurposed for PoS consensus (bytes32 hex).

extraData · string

Arbitrary data field set by the sequencer.

size · string

Block size in bytes (hex).

gasLimit · string

Maximum gas allowed in this block (hex).

gasUsed · string

Total gas used in this block (hex).

timestamp · string

Unix timestamp (hex).

timestampMs · string

Optional. Unix timestamp in milliseconds (hex). Present on blocks produced after Denim activated; omitted when the block’s BaseTime metadata is unavailable. See Denim Millisecond Timestamps.

transactions · array

Array of transaction hashes or full transaction objects.

uncles · array

Always [] on Base.

withdrawals · array

Always [] on Base.

withdrawalsRoot · string

Merkle root of the withdrawals list (EIP-4895, bytes32 hex).

baseFeePerGas · string

EIP-1559 base fee per gas (hex).

blobGasUsed · string

Total blob gas used (EIP-4844, hex).

excessBlobGas · string

Excess blob gas for blob fee calculation (EIP-4844, hex).

parentBeaconBlockRoot · string

Parent beacon block root (EIP-4788).

requestsHash · string

Hash of requests (EIP-7685).

​

Denim Millisecond Timestamps

Since Denim, the block object adds an optional timestampMs field: a JSON-RPC quantity containing the full Unix timestamp in milliseconds. The existing timestamp field stays in Unix seconds.

The response omits timestampMs when the block’s BaseTime metadata has been pruned or is otherwise unavailable. See 200ms Blocks for the full list of affected methods.

​

Example

Standard (latest sealed block)

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