Blockchain Data

Access blockchain state and history

Core blockchain data endpoints for querying blocks, transactions, chain statistics, and blockchain state.

Get blockchain statistics

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/chain/stats

Retrieves current blockchain statistics including height, transaction counts, and network metrics.

Responses

200

Chain statistics retrieved successfully

application/json

get

/api/chain/stats

cURLJavaScript

curl -X GET "https://nodes.amadeus.bot/api/chain/stats"

200

Chain statistics retrieved successfully

{
  "error": "ok",
  "stats": {
    "height": 12345,
    "total_transactions": 1,
    "total_accounts": 1,
    "network_hash_rate": "text",
    "difficulty": "text"
  }
}

Get chain tip

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/chain/tip

Retrieves the current tip (latest block) of the blockchain

Responses

200

Chain tip retrieved successfully

application/json

get

/api/chain/tip

HTTPcURLJavaScriptPython

GET /api/chain/tip HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

Chain tip retrieved successfully

{
  "error": "ok",
  "entry": {
    "hash": "text",
    "height": 1,
    "timestamp": 1,
    "previous_hash": "text",
    "merkle_root": "text",
    "signature": "text",
    "mask": "text"
  }
}

Get entries by height

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/chain/height/{height}

Retrieves all blockchain entries at a specific height

Path parameters

heightintegerRequired

Blockchain height to query

Example: 12345

Responses

200

Entries retrieved successfully

application/json

get

/api/chain/height/{height}

cURL

curl -X GET "https://nodes.amadeus.bot/api/chain/height/12345"

200

Entries retrieved successfully

{
  "error": "ok",
  "entries": [
    {
      "hash": "text",
      "height": 1,
      "timestamp": 1,
      "previous_hash": "text",
      "merkle_root": "text",
      "signature": "text",
      "mask": "text"
    }
  ]
}

Get entries by height with transactions

get

https://nodes.amadeus.bothttp://167.235.169.185http://37.27.238.30http://localhost

/api/chain/height_with_txs/{height}

Retrieves blockchain entries at a specific height including all transactions

Path parameters

heightintegerRequired

Blockchain height to query

Example: 12345

Responses

200

Entries with transactions retrieved successfully

application/json

get

/api/chain/height_with_txs/{height}

HTTPcURLJavaScriptPython

GET /api/chain/height_with_txs/{height} HTTP/1.1
Host: nodes.amadeus.bot
Accept: */*

200

Entries with transactions retrieved successfully

{
  "error": "ok",
  "entries": [
    {
      "hash": "text",
      "height": 1,
      "timestamp": 1,
      "previous_hash": "text",
      "merkle_root": "text",
      "signature": "text",
      "mask": "text",
      "txs": [
        {
          "hash": "text",
          "from": "text",
          "to": "text",
          "amount": "text",
          "symbol": "text",
          "fee": "text",
          "nonce": 1,
          "timestamp": 1,
          "signature": "text",
          "type": "transfer"
        }
      ]
    }
  ]
}