Skip to main content

eth_getBlockByNumber RPC Method

Returns information of the block matching the given block number.

Updated on
Feb 12, 2026

Parameters

blockNumber/tag
string
REQUIRED

The block number in hexadecimal format or the string latest, earliest, pending, safe or finalized

transaction detail flag
boolean
REQUIRED

The method returns the full transaction objects when this value is true otherwise, it returns only the hashes of the transactions

Returns

result
object

A block object, or null when no block was found

baseFeePerGas
string

Base fee per gas for the block encoded as hexadecimal (EIP-1559 only)

blobGasUsed
string

Total blob gas used by all transactions in the block encoded as hexadecimal

difficulty
string

Block difficulty encoded as hexadecimal

excessBlobGas
string

Excess blob gas carried forward to this block encoded as hexadecimal

extraData
string

Extra data field of the block encoded as hexadecimal

gasLimit
string

Maximum gas allowed in this block encoded as hexadecimal

gasUsed
string

Total gas used by all transactions in this block encoded as hexadecimal

hash
string

Block hash of the requested block or null if pending

logsBloom
string

Bloom filter for the logs of the block encoded as hexadecimal or null if pending

miner
string

Address of the beneficiary to whom block rewards were given

mixHash
string

Mix digest used to prove block validity

nonce
string

Proof-of-work nonce or null if pending

number
string

Block number encoded as hexadecimal or null if pending

parentBeaconBlockRoot
string

Root hash of the parent beacon block

parentHash
string

Hash of the parent block

receiptsRoot
string

Root of the receipts trie for the block

requestsHash
string

Root hash of execution layer requests included in the block

sha3Uncles
string

SHA3 hash of the uncles data in the block

size
string

Size of the block in bytes encoded as hexadecimal

stateRoot
string

Root hash of the final state trie for the block

timestamp
string

Unix timestamp when the block was produced encoded as hexadecimal

transactions
array

Array of transaction objects or transaction hashes

transactionsRoot
string

Root of the transaction trie for the block

uncles
array

Array of uncle block hashes

withdrawals
array

Array of withdrawal objects included in the block

withdrawalsRoot
string

Root hash of the withdrawals list for the block

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free