Skip to main content
Version: Next

eth_getHeaderByHash

Returns the execution header of the given block. Header fields introduced by a fork MUST be omitted for headers that predate that fork. The result is `null` if the block is unknown.

Returns information about a block header by hash.

Parameters (by position)​

Block hash string required

Result​

Header information null or object

Show Option 1 Not Found (null) null

Not Found (null) fields​

Header information null

Not Found (null)

Show Option 2 Header object object

Header object fields​

Header information object

Header object

Show Header information object

Header information fields​

  • baseFeePerGas string

    Base fee per gas

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • blobGasUsed string

    Blob gas used

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • blockAccessListHash string

    EIP-7928 block access list hash

    Match pattern: ^0x[0-9a-f]{64}$

  • difficulty string required

    Difficulty

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • excessBlobGas string

    Excess blob gas

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • extraData string required

    Extra data

    Match pattern: ^0x[0-9a-f]*$

  • gasLimit string required

    Gas limit

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • gasUsed string required

    Gas used

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • hash string required

    Hash

    Match pattern: ^0x[0-9a-f]{64}$

  • logsBloom string required

    Bloom filter

    Match pattern: ^0x[0-9a-f]{512}$

  • miner string required

    Coinbase

    Match pattern: ^0x[0-9a-fA-F]{40}$

  • mixHash string required

    Mix hash

    Match pattern: ^0x[0-9a-f]{64}$

  • nonce string required

    Nonce

    Match pattern: ^0x[0-9a-f]{16}$

  • number string required

    Number

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • parentBeaconBlockRoot string

    Parent Beacon Block Root

    Match pattern: ^0x[0-9a-f]{64}$

  • parentHash string required

    Parent block hash

    Match pattern: ^0x[0-9a-f]{64}$

  • receiptsRoot string required

    Receipts root

    Match pattern: ^0x[0-9a-f]{64}$

  • requestsHash string

    EIP-7685 requests hash

    Match pattern: ^0x[0-9a-f]{64}$

  • sha3Uncles string required

    Ommers hash

    Match pattern: ^0x[0-9a-f]{64}$

  • slotNumber string

    EIP-7843 slot number

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]{0,15})$

  • stateRoot string required

    State root

    Match pattern: ^0x[0-9a-f]{64}$

  • timestamp string required

    Timestamp

    Match pattern: ^0x(0|[1-9a-f][0-9a-f]*)$

  • transactionsRoot string required

    Transactions root

    Match pattern: ^0x[0-9a-f]{64}$

  • withdrawalsRoot string

    Withdrawals root

    Match pattern: ^0x[0-9a-f]{64}$

  • additionalProperties false

Errors​

Error code: 4444

  • code

    4444

  • message

    Pruned history unavailable

Examples​

eth_getHeaderByHash example

Request​

{
  "params": [
    "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c"
  ]
}

Response​

{
  "baseFeePerGas": "0x7",
  "blobGasUsed": "0x0",
  "difficulty": "0x66e619a",
  "excessBlobGas": "0x0",
  "extraData": "0xd583010502846765746885676f312e37856c696e7578",
  "gasLimit": "0x47e7c4",
  "gasUsed": "0x37993",
  "hash": "0xd5f1812548be429cbdc6376b29611fc49e06f1359758c4ceaaa3b393e2239f9c",
  "logsBloom": "0x00000000000000100000004080000000000500000000000000020000100000000800001000000004000001000000000000000800040010000020100000000400000010000000000000000040000000000000040000000000000000000000000000000400002400000000000000000000000000000004000004000000000000840000000800000080010004000000001000000800000000000000000000000000000000000800000000000040000000020000000000000000000800000400000000000000000000000600000400000000002000000000000000000000004000000000000000100000000000000000000000000000000000040000900010000000",
  "miner": "0xb42b6c4a95406c78ff892d270ad20b22642e102d",
  "mixHash": "0x24900fb3da77674a861c428429dce0762707ecb6052325bbd9b3c64e74b5af9d",
  "nonce": "0x378da40ff335b070",
  "number": "0x68b3",
  "parentBeaconBlockRoot": "0x95c4dbd5b19f6fe3cbc3183be85ff4e85ebe75c5b4fc911f1c91e5b7a554a685",
  "parentHash": "0x1f68ac259155e2f38211ddad0f0a15394d55417b185a93923e2abe71bb7a4d6d",
  "receiptsRoot": "0x68461ab700003503a305083630a8fb8d14927238f0bc8b6b3d246c0c64f21f4a",
  "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
  "stateRoot": "0x91309efa7e42c1f137f31fe9edbe88ae087e6620d0d59031324da3e2f4f93233",
  "timestamp": "0x5835c54d",
  "transactionsRoot": "0x4d0c8e91e16bdff538c03211c5c73632ed054d00a7e210c0eb25146c20048126",
  "withdrawalsRoot": "0x7a4ecf19774d15cf9c15adf0dd8e8a250c128b26c9e2ab2a08d6c9c8ffbd104f"
}
Request