v1

latestOpenAPI 3.1.02026-07-2612501.4 MB

GetBeaconHeaders

Get block headers. Retrieves block headers matching given query. By default it will fetch current head slot blocks.

get/{apiKey}/eth/v1/beacon/headers

Path parameters

apiKeystring required
<style> .custom-style { color: #048FF4; } </style>

For higher throughput, please <span class="custom-style"><a href="../docs/quick-start-guide#-creating-your-api-key-on-the-zan-platform" target="_blank">create your own API key</a></span>.

Query parameters

slotstring
Example:1
parent_rootstring hex
Example:0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2

Response

A version string of the running beacon node.

execution_optimisticboolean required

True if the response references an unverified execution payload. Optimistic information may be invalidated at a later time. If the field is not present, assume the False value.

finalizedboolean required

True if the response references the finalized history of the chain, as determined by fork choice. If the field is not present, additional calls are necessary to compare the epoch of the requested information with the finalized checkpoint.

Example response

{
  "data": [
    {
      "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2",
      "header": {
        "message": {
          "slot": "1",
          "proposer_index": "1",
          "parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2",
          "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2",
          "body_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2"
        },
        "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505"
      }
    }
  ]
}