Skip to navigation

eth_getHeaderByNumber

Returns only the header fields of a block — no transaction list, uncles, or withdrawals body. Cheaper than eth_getBlockByNumber when you only need header data such as stateRoot, baseFeePerGas, or timestamp.

⚡ Compute Units: 15 CU

Request

This endpoint expects an object.
blockNumberenum or stringRequired
Block number or tag.

Response

Block header, or null if the block is not found.

parentHashstringformat: "^0x[0-9a-fA-F]{64}$"

32-byte hash of the parent block

noncestringformat: "^0x[0-9a-fA-F]*$"

8-byte value used in proof-of-work mining. On post-Merge chains (all Conduit rollups) this is always "0x0000000000000000" — the field is retained for header-shape backwards compatibility.

sha3Unclesstringformat: "^0x[0-9a-fA-F]{64}$"
SHA3 of the uncles data in the block
logsBloomstringformat: "^0x[0-9a-fA-F]{512}$"
Bloom filter for the logs of the block
transactionsRootstringformat: "^0x[0-9a-fA-F]{64}$"
Root of the transaction trie
stateRootstringformat: "^0x[0-9a-fA-F]{64}$"
Root of the final state trie
receiptsRootstringformat: "^0x[0-9a-fA-F]{64}$"
Root of the receipts trie
mixHashstringformat: "^0x[0-9a-fA-F]{64}$"

32-byte hash. Post-Merge this field carries the prevRandao value (the beacon chain randomness) rather than a proof-of-work mix hash.

minerstringformat: "^0x[0-9a-fA-F]{40}$"

20-byte address of the beneficiary

difficultystringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Integer of the difficulty for this block
extraDatastringformat: "^0x[0-9a-fA-F]*$"
Extra data field of this block
gasLimitstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Maximum gas allowed in this block
gasUsedstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Total gas used by all transactions in this block
timestampstringformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"
Unix timestamp for when the block was collated
numberstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

The block number, hex-encoded

hashstringOptionalformat: "^0x[0-9a-fA-F]{64}$"

32-byte block hash

baseFeePerGasstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Base fee per gas in wei, hex-encoded. Introduced by EIP-1559 (London). Absent on pre-London blocks.

withdrawalsRootstringOptionalformat: "^0x[0-9a-fA-F]{64}$"

Root of the withdrawals trie. Introduced by EIP-4895 (Shanghai). Absent on pre-Shanghai blocks.

blobGasUsedstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Total blob gas used by the transactions in this block, hex-encoded. Introduced by EIP-4844 (Cancun). Absent on pre-Cancun blocks.

excessBlobGasstringOptionalformat: "^0x(0|[1-9a-fA-F][0-9a-fA-F]*)$"

Running total of blob gas consumed in excess of the target, used to compute the blob gas price, hex-encoded. Introduced by EIP-4844 (Cancun). Absent on pre-Cancun blocks.

parentBeaconBlockRootstringOptionalformat: "^0x[0-9a-fA-F]{64}$"

Parent beacon block root hash. Introduced by EIP-4788 (Cancun). Absent on pre-Cancun blocks.