v1

latestOpenAPI 3.0.2CC0 1.0 Universal2026-07-17128129208.3 KB

blocks

Get headers in a specified range of heights

get/blocks/chainSlice

Query parameters

fromHeightinteger

Min header height (start of the range)

toHeightinteger

Max header height of the range (last header height then omitted)

Response

Array of headers

idstring base16 required

Base16-encoded 32 byte modifier id

timestampinteger required

Basic timestamp definition

versioninteger required

Ergo blockchain protocol version

adProofsRootstring base16 required

Base16-encoded 32 byte digest

stateRootstring base16 required

Base16-encoded 33 byte digest - digest with extra byte with tree height

transactionsRootstring base16 required

Base16-encoded 32 byte digest

nBitsinteger required

Proof-of-work target (difficulty encoded)

extensionHashstring base16 required

Base16-encoded 32 byte digest

heightinteger required

Height of the block (genesis block height == 1)

difficultystring required

parentIdstring base16 required

Base16-encoded 32 byte modifier id

votesstring base16 required

Base16-encoded votes for a soft-fork and parameters

sizeinteger

Size of the header in bytes

extensionIdstring base16

Base16-encoded 32 byte modifier id

transactionsIdstring base16

Base16-encoded 32 byte modifier id

adProofsIdstring base16

Base16-encoded 32 byte modifier id

Example response

[
  {
    "id": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "timestamp": 1524143059077,
    "version": 2,
    "adProofsRoot": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "stateRoot": "333ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "transactionsRoot": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "nBits": 19857408,
    "extensionHash": "4ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "powSolutions": {
      "pk": "0350e25cee8562697d55275c96bb01b34228f9bd68fd9933f2a25ff195526864f5",
      "w": "0366ea253123dfdb8d6d9ca2cb9ea98629e8f34015b1e4ba942b1d88badfcc6a12",
      "n": "0000000000000000",
      "d": 987654321
    },
    "height": 667,
    "difficulty": "9575989248",
    "parentId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "votes": "000000",
    "extensionId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "transactionsId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117",
    "adProofsId": "3ab9da11fc216660e974842cc3b7705e62ebb9e0bf5ff78e53f9cd40abadd117"
  }
]