/eth/v1/beacon/headers

Get block headers.

Finds block headers that match the supplied query. It will automatically retrieve the current head slot blocks.

Example Request and Result for /v1/beacon/headers

In this section, we provide an illustrative example of a request made to retrieve details contents using the /v1/beacon/headers endpoint. Additionally, we present the resulting response containing information about block headers.

Parameters

Field	Type	Description
slot	string	Restrict returned values to those matching the supplied slot.
parent_root	string	Epoch to fetch the RANDAO mix for. Default: state's current epoch.

The example in this section uses a non-existing project id.

Make sure you replace it with your Ethereum Holesky Beacon endpoint when issuing the API calls.

Don't have a project id? Here's a straightforward guide on how to obtain one!

Get block headers.

GET https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/headers

Query Parameters

Name	Type	Description
slot	string	32
parent_root	String	0xf7884f046f0200cebff4b5ea50a9c015c8352d90b3936b3898ae5f736f4f598f

200: OK Expand for a detailed response example

{
  "data": [
    {
      "header": {
        "message": {
          "slot": "32",
          "proposer_index": "604295",
          "parent_root": "0xf7884f046f0200cebff4b5ea50a9c015c8352d90b3936b3898ae5f736f4f598f",
          "state_root": "0xaf26c2ee3da0d363d2021dd28e32508d07945a0cacc8bf6e00d42e4830f3f281",
          "body_root": "0x366ee1cbfd59b534910acff3c7d42ee4e2d9c5662e995def0ad58287f2b5b88e"
        },
        "signature": "0x96a4eebec9561ad901ea1c90f7c6352bb6613ec8f39b38d69a5c4e8721f6e1c1c2bddb0f6b1c61a2e492f4ed85b8b3be001a953ee1b771f5e9bb739edaf4bd84ce6988ec1d33f10dab30f6298ef908cac915e1cb18f3b348cd0e8b2fc3a1e2f1"
      },
      "root": "0x6dc9164ece2c9a7c99967ea0dd66e120ee8d5a18d8043b20bd4535053cb1f62e",
      "canonical": true
    }
  ],
  "execution_optimistic": false,
  "finalized": true
}

Curl Request example

curl -X 'GET' \
  'https://eth-holesky-beacon.blastapi.io/<project-id>/eth/v1/beacon/headers?slot=32&parent_root=0xf7884f046f0200cebff4b5ea50a9c015c8352d90b3936b3898ae5f736f4f598f' \
  -H 'accept: application/json'