Blockflow

List blocks on the given time interval

get

Returns blocks produced within the specified time range.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

fromTsinteger · int64Required

toTsinteger · int64Optional

Responses

200

Valid response

application/json

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

get/blockflow/blocks

HTTPcURLJavaScriptPython

GET /blockflow/blocks?fromTs=1 HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "blocks": [
    [
      {
        "hash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
        "timestamp": 1611041396892,
        "chainFrom": 1,
        "chainTo": 2,
        "height": 42,
        "deps": [
          "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
          "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5"
        ],
        "transactions": [
          {
            "unsigned": {
              "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
              "version": 1,
              "networkId": 1,
              "gasAmount": 20000,
              "gasPrice": "100000000000",
              "inputs": [
                {
                  "outputRef": {
                    "hint": 23412,
                    "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
                  },
                  "unlockScript": "00d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28"
                }
              ],
              "fixedOutputs": [
                {
                  "hint": 1,
                  "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
                  "attoAlphAmount": "2000000000000000000",
                  "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
                  "tokens": [
                    {
                      "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
                      "amount": "42000000000000000000"
                    },
                    {
                      "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                      "amount": "1000000000000000000000"
                    }
                  ],
                  "lockTime": 1611041396892,
                  "message": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
                }
              ]
            },
            "scriptExecutionOk": true,
            "contractInputs": [
              {
                "hint": 23412,
                "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
              }
            ],
            "generatedOutputs": [
              {
                "type": "AssetOutput",
                "hint": 1,
                "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
                "attoAlphAmount": "2000000000000000000",
                "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
                "tokens": [
                  {
                    "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
                    "amount": "42000000000000000000"
                  },
                  {
                    "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                    "amount": "1000000000000000000000"
                  }
                ],
                "lockTime": 1611041396892,
                "message": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
              },
              {
                "type": "ContractOutput",
                "hint": 1,
                "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
                "attoAlphAmount": "2000000000000000000",
                "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
                "tokens": [
                  {
                    "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
                    "amount": "42000000000000000000"
                  },
                  {
                    "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                    "amount": "1000000000000000000000"
                  }
                ]
              }
            ],
            "inputSignatures": [
              "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
            ],
            "scriptSignatures": [
              "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
            ]
          }
        ],
        "nonce": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
        "version": 1,
        "depStateHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
        "txsHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
        "target": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
        "ghostUncles": [
          {
            "blockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
            "miner": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
          }
        ]
      }
    ]
  ]
}

Blocks with events

get

List blocks with events on the given time interval

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

fromTsinteger · int64Required

toTsinteger · int64Optional

Responses

200

Valid response

application/json

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

get/blockflow/blocks-with-events

HTTPcURLJavaScriptPython

GET /blockflow/blocks-with-events?fromTs=1 HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "blocksAndEvents": [
    [
      {
        "block": {
          "hash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
          "timestamp": 1611041396892,
          "chainFrom": 1,
          "chainTo": 2,
          "height": 42,
          "deps": [
            "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
            "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5"
          ],
          "transactions": [
            {
              "unsigned": {
                "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
                "version": 1,
                "networkId": 1,
                "gasAmount": 20000,
                "gasPrice": "100000000000",
                "inputs": [
                  {
                    "outputRef": {
                      "hint": 23412,
                      "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
                    },
                    "unlockScript": "00d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28"
                  }
                ],
                "fixedOutputs": [
                  {
                    "hint": 1,
                    "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
                    "attoAlphAmount": "2000000000000000000",
                    "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
                    "tokens": [
                      {
                        "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
                        "amount": "42000000000000000000"
                      },
                      {
                        "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                        "amount": "1000000000000000000000"
                      }
                    ],
                    "lockTime": 1611041396892,
                    "message": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
                  }
                ]
              },
              "scriptExecutionOk": true,
              "contractInputs": [
                {
                  "hint": 23412,
                  "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
                }
              ],
              "generatedOutputs": [
                {
                  "type": "AssetOutput",
                  "hint": 1,
                  "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
                  "attoAlphAmount": "2000000000000000000",
                  "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
                  "tokens": [
                    {
                      "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
                      "amount": "42000000000000000000"
                    },
                    {
                      "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                      "amount": "1000000000000000000000"
                    }
                  ],
                  "lockTime": 1611041396892,
                  "message": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
                },
                {
                  "type": "ContractOutput",
                  "hint": 1,
                  "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
                  "attoAlphAmount": "2000000000000000000",
                  "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
                  "tokens": [
                    {
                      "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
                      "amount": "42000000000000000000"
                    },
                    {
                      "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                      "amount": "1000000000000000000000"
                    }
                  ]
                }
              ],
              "inputSignatures": [
                "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
              ],
              "scriptSignatures": [
                "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
              ]
            }
          ],
          "nonce": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
          "version": 1,
          "depStateHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
          "txsHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
          "target": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
          "ghostUncles": [
            {
              "blockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
              "miner": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
            }
          ]
        },
        "events": [
          {
            "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
            "contractAddress": "vSxdLL2kE3o6vJBdKkdgmS3W39G3ZEmFHpo2y1jnbzBq",
            "eventIndex": 1,
            "fields": [
              {
                "type": "Address",
                "value": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
              },
              {
                "type": "U256",
                "value": "10"
              }
            ]
          }
        ]
      }
    ]
  ]
}

Get Block by Hash

get

Retrieves detailed information about a block identified by its hash.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

block_hashstringRequired

The hash of the block to retrieve.

Example: 0000000000004612ec7dbcf08dc4f07e65ac767f9fe0c32b53a61c18761ef44c

Responses

200

Block information retrieved successfully.

application/json

hashstringRequired

Block hash.

Example: 0000000000004612ec7dbcf08dc4f07e65ac767f9fe0c32b53a61c18761ef44c

timestampintegerRequired

Unix timestamp in milliseconds when the block was created.

Example: 1754913020964

chainFromintegerRequired

Source chain ID.

Example: 3

chainTointegerRequired

Destination chain ID.

Example: 0

heightintegerRequired

Block height.

Example: 3117858

depsstring[]Required

List of dependent block hashes.

Example: 00000000000007d6582a5af7ce642de0454d790b0f8f55ccf30667c747eabf00

noncestringRequired

Nonce value.

Example: 1a4d00000000000000000000000000000022a74ad1b6753f

versionintegerRequiredExample: 0

depStateHashstringRequired

Dependency state hash.

Example: 0ad632ebff89ecb0d1af82f7de24372d8dc823dba623f2073983bcb8c56eedd2

txsHashstringRequired

Transactions hash.

Example: 480dc015f5267c1d27e5a665016254f72b83554e7992e6b4473a65566cdbb4a7

targetstringRequired

Mining target.

Example: 1a808a0f

ghostUnclesstring[]Required

List of ghost uncle block hashes.

400

Invalid block hash supplied.

application/json

404

Block not found.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/blockflow/blocks/{block_hash}

HTTPcURLJavaScriptPython

GET /blockflow/blocks/{block_hash} HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "hash": "0000000000004612ec7dbcf08dc4f07e65ac767f9fe0c32b53a61c18761ef44c",
  "timestamp": 1754913020964,
  "chainFrom": 3,
  "chainTo": 0,
  "height": 3117858,
  "deps": [
    "00000000000007d6582a5af7ce642de0454d790b0f8f55ccf30667c747eabf00"
  ],
  "transactions": [
    {
      "unsigned": {
        "txId": "12a99bdb3aa8961f0d099a30996e3c6003f49cafe9397ed0e96daea2938a8e42",
        "version": 0,
        "networkId": 0,
        "gasAmount": 20000,
        "gasPrice": "1000000000",
        "inputs": [],
        "fixedOutputs": [
          {
            "hint": -856749559,
            "key": "a523cac223b9ef2a98c66b92de5ff2b8042a0e951cb6f5f0919b4b1eec3a362d",
            "attoAlphAmount": "191472590469365818",
            "address": "1PZonix2UoaguUfbbBnWevk4vod1m9MeJXBnkr7aqN76",
            "tokens": [
              {}
            ],
            "lockTime": 1754943020964,
            "message": "030000"
          }
        ]
      },
      "scriptExecutionOk": true,
      "contractInputs": [],
      "generatedOutputs": [],
      "inputSignatures": [],
      "scriptSignatures": []
    }
  ],
  "nonce": "1a4d00000000000000000000000000000022a74ad1b6753f",
  "version": 0,
  "depStateHash": "0ad632ebff89ecb0d1af82f7de24372d8dc823dba623f2073983bcb8c56eedd2",
  "txsHash": "480dc015f5267c1d27e5a665016254f72b83554e7992e6b4473a65566cdbb4a7",
  "target": "1a808a0f",
  "ghostUncles": []
}

Main chain block by ghost uncle

get

Get a mainchain block by ghost uncle hash

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

ghost_uncle_hashstring · block-hashRequired

Responses

200

Valid response

application/json

hashstring · block-hashRequired

timestampinteger · int64Required

chainFrominteger · int32Required

chainTointeger · int32Required

heightinteger · int32Required

depsstring · block-hash[]Required

noncestring · hex-stringRequired

versionintegerRequired

depStateHashstring · 32-byte-hashRequired

txsHashstring · 32-byte-hashRequired

targetstring · hex-stringRequired

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

get/blockflow/main-chain-block-by-ghost-uncle/{ghost_uncle_hash}

HTTPcURLJavaScriptPython

GET /blockflow/main-chain-block-by-ghost-uncle/{ghost_uncle_hash} HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "hash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
  "timestamp": 1611041396892,
  "chainFrom": 1,
  "chainTo": 2,
  "height": 42,
  "deps": [
    "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
    "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5"
  ],
  "transactions": [
    {
      "unsigned": {
        "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
        "version": 1,
        "networkId": 1,
        "gasAmount": 20000,
        "gasPrice": "100000000000",
        "inputs": [
          {
            "outputRef": {
              "hint": 23412,
              "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
            },
            "unlockScript": "00d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28"
          }
        ],
        "fixedOutputs": [
          {
            "hint": 1,
            "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
            "attoAlphAmount": "2000000000000000000",
            "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
            "tokens": [
              {
                "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
                "amount": "42000000000000000000"
              },
              {
                "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
                "amount": "1000000000000000000000"
              }
            ],
            "lockTime": 1611041396892,
            "message": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
          }
        ]
      },
      "scriptExecutionOk": true,
      "contractInputs": [
        {
          "hint": 23412,
          "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
        }
      ],
      "generatedOutputs": [
        {
          "type": "AssetOutput",
          "hint": 1,
          "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
          "attoAlphAmount": "2000000000000000000",
          "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
          "tokens": [
            {
              "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
              "amount": "42000000000000000000"
            },
            {
              "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
              "amount": "1000000000000000000000"
            }
          ],
          "lockTime": 1611041396892,
          "message": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
        },
        {
          "type": "ContractOutput",
          "hint": 1,
          "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
          "attoAlphAmount": "2000000000000000000",
          "address": "uomjgUz6D4tLejTkQtbNJMY8apAjTm1bgQf7em1wDV7S",
          "tokens": [
            {
              "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
              "amount": "42000000000000000000"
            },
            {
              "id": "bd165d20bd063c7a023d22232a1e75bf46e904067f92b49323fe89fa0fd586bf",
              "amount": "1000000000000000000000"
            }
          ]
        }
      ],
      "inputSignatures": [
        "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
      ],
      "scriptSignatures": [
        "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
      ]
    }
  ],
  "nonce": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
  "version": 1,
  "depStateHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
  "txsHash": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
  "target": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
  "ghostUncles": [
    {
      "blockHash": "bdaf9dc514ce7d34b6474b8ca10a3dfb93ba997cb9d5ff1ea724ebe2af48abe5",
      "miner": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
    }
  ]
}

Get Block with Events

get

Retrieves detailed block information along with any smart contract events emitted in the block.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

block_hashstringRequired

The hash of the block.

Example: 0000000000001ddd11912d103cae4d7596a49485ee7ea8e9c2acdc32b4480759

Responses

200

Block with events retrieved successfully.

application/json

eventsobject[]Optional

List of smart contract events emitted in the block.

404

Block not found.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/blockflow/blocks-with-events/{block_hash}

HTTPcURLJavaScriptPython

GET /blockflow/blocks-with-events/{block_hash} HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "block": {
    "hash": "0000000000001ddd11912d103cae4d7596a49485ee7ea8e9c2acdc32b4480759",
    "timestamp": 1754913626360,
    "chainFrom": 2,
    "chainTo": 1,
    "height": 3217510,
    "deps": [
      "text"
    ],
    "transactions": [
      {
        "unsigned": {
          "txId": "4a91d581039055cef017e0ced7dae4a9176be281153e7cc12aebf790e536b645",
          "version": 0,
          "networkId": 0,
          "gasAmount": 20000,
          "gasPrice": "1000000000",
          "inputs": [],
          "fixedOutputs": [
            {
              "hint": -502957581,
              "key": "text",
              "attoAlphAmount": "text",
              "address": "text",
              "tokens": [
                {}
              ],
              "lockTime": 1,
              "message": "text"
            }
          ]
        },
        "scriptExecutionOk": true,
        "contractInputs": [],
        "generatedOutputs": [],
        "inputSignatures": [],
        "scriptSignatures": []
      }
    ],
    "nonce": "68710000000000000000000000000000009b4cca7126d384",
    "version": 0,
    "depStateHash": "600fd8ce293930f6c7361894f33f54a04df2ac1339617eee13ed7da99bba98ab",
    "txsHash": "12e5681ac5f5ab02779778bc22df52aca57846cec805d4dd3ee5dc0d466223d2",
    "target": "1a76456d",
    "ghostUncles": []
  },
  "events": []
}

Check if Block is in Main Chain

get

Returns whether the specified block is part of the main chain.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

blockHashstringRequired

The hash of the block to check.

Example: 0000000000001ddd11912d103cae4d7596a49485ee7ea8e9c2acdc32b4480759

Responses

200

Successfully checked block status.

application/json

isMainChainbooleanOptional

True if the block is in the main chain, false otherwise.

Example: true

400

Invalid or missing block hash.

application/json

404

Block not found.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/blockflow/is-block-in-main-chain

HTTPcURLJavaScriptPython

GET /blockflow/is-block-in-main-chain?blockHash=0000000000001ddd11912d103cae4d7596a49485ee7ea8e9c2acdc32b4480759 HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "isMainChain": true
}

Get Block Headers Hashes

get

Retrieves block header hashes filtered by source group, destination group, and block height.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

fromGroupintegerRequired

Source group number.

Example: 1

toGroupintegerRequired

Destination group number.

Example: 2

heightintegerRequired

Block height to filter.

Example: 3087063

Responses

200

List of block header hashes.

application/json

headersstring[]Optional

Array of block header hashes matching the criteria.

Example: 0000000000000edd995d369f408344e473eeb1beaa050911c393661a7ef71b46

400

Invalid or missing query parameters.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/blockflow/hashes

HTTPcURLJavaScriptPython

GET /blockflow/hashes?fromGroup=1&toGroup=2&height=3087063 HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "headers": [
    "0000000000000edd995d369f408344e473eeb1beaa050911c393661a7ef71b46"
  ]
}

Get Chain Info by Groups

get

Returns the current chain height filtered by fromGroup and toGroup.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

fromGroupintegerRequired

Source group number.

Example: 1

toGroupintegerRequired

Destination group number.

Example: 2

Responses

200

Chain information retrieved successfully.

application/json

currentHeightintegerOptional

Current height of the blockchain for the specified group range.

Example: 3351911

400

Invalid or missing query parameters.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/blockflow/chain-info

HTTPcURLJavaScriptPython

GET /blockflow/chain-info?fromGroup=1&toGroup=2 HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "currentHeight": 3351911
}

Get Block Header by Hash

get

Returns detailed information about a block header identified by its hash.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

block_hashstringRequired

Hash of the block header to retrieve.

Example: 0000000000005c8d2761b8c0967d5e0dcbfe47a5678a80f676a54276d956e3ed

Responses

200

Block header retrieved successfully.

application/json

hashstringOptional

Unique hash of the block.

Example: 0000000000005c8d2761b8c0967d5e0dcbfe47a5678a80f676a54276d956e3ed

timestampintegerOptional

Timestamp of the block in milliseconds since epoch.

Example: 1754914650065

chainFromintegerOptional

Source chain group number.

Example: 3

chainTointegerOptional

Destination chain group number.

Example: 1

heightintegerOptional

Block height.

Example: 3087063

depsstring[]Optional

Array of dependent block hashes.

Example: ["00000000000077b5fa47c09862b5e5bdac2d607a0c2d5f47c6a809dfe648fe30","0000000000002607d92a86fe627d89508c772b8212c2e329ec01ff08b8a72e05","0000000000001bf5527420ea81e4cfbe9f876d8684789dad8141ea761624f6ba","00000000000051c9411b5c0d34753677a2c05f36f085dddb9a5ac6462559727c","00000000000025f9d5df85bee58053b9e0a66a707e6a20b385c5ab7afb566c9d","0000000000005266b43014907a76202f534ecf9370033aa72cca5112c8448dae","0000000000003979d68003f93bb1d10e82ef0a7ff62e19cdd94aa19d3f4379ef"]

400

Invalid block hash supplied.

application/json

404

Block header not found.

application/json

500

Internal server error.

application/json

503

ServiceUnavailable

application/json

get/blockflow/headers/{block_hash}

HTTPcURLJavaScriptPython

GET /blockflow/headers/{block_hash} HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "hash": "0000000000005c8d2761b8c0967d5e0dcbfe47a5678a80f676a54276d956e3ed",
  "timestamp": 1754914650065,
  "chainFrom": 3,
  "chainTo": 1,
  "height": 3087063,
  "deps": [
    "00000000000077b5fa47c09862b5e5bdac2d607a0c2d5f47c6a809dfe648fe30",
    "0000000000002607d92a86fe627d89508c772b8212c2e329ec01ff08b8a72e05",
    "0000000000001bf5527420ea81e4cfbe9f876d8684789dad8141ea761624f6ba",
    "00000000000051c9411b5c0d34753677a2c05f36f085dddb9a5ac6462559727c",
    "00000000000025f9d5df85bee58053b9e0a66a707e6a20b385c5ab7afb566c9d",
    "0000000000005266b43014907a76202f534ecf9370033aa72cca5112c8448dae",
    "0000000000003979d68003f93bb1d10e82ef0a7ff62e19cdd94aa19d3f4379ef"
  ]
}