Burn Blocks

Read-only endpoints to obtain burn block details

Get burn blocks

get

Retrieves a list of recent burn blocks

Authorizations
Query parameters
limitinteger · max: 30Optional

Results per page

Default: 20
offsetintegerOptional

Result offset

Default: 0
Responses
200
Default Response
application/json
get
GET /extended/v2/burn-blocks/ HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "burn_block_time": 1,
      "burn_block_time_iso": "text",
      "burn_block_hash": "text",
      "burn_block_height": 1,
      "stacks_blocks": [
        "text"
      ],
      "avg_block_time": 1,
      "total_tx_count": 1
    }
  ]
}

Get burn block

get

Retrieves a single burn block

Authorizations
Path parameters
height_or_hashany ofRequired
string · enumOptionalPossible values:
or
stringOptional

Burn block hash

Example: ["0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133"]Pattern: ^(0x)?[a-fA-F0-9]{64}$
or
integerOptional

Burn block height

Example: [777678]
Responses
200
Default Response
application/json
get
GET /extended/v2/burn-blocks/{height_or_hash} HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "burn_block_time": 1,
  "burn_block_time_iso": "text",
  "burn_block_hash": "text",
  "burn_block_height": 1,
  "stacks_blocks": [
    "text"
  ],
  "avg_block_time": 1,
  "total_tx_count": 1
}

Get blocks by burn block

get

Retrieves a list of blocks confirmed by a specific burn block

Authorizations
Path parameters
height_or_hashany ofRequired
string · enumOptionalPossible values:
or
stringOptional

Burn block hash

Example: ["0000000000000000000452773967cdd62297137cdaf79950c5e8bb0c62075133"]Pattern: ^(0x)?[a-fA-F0-9]{64}$
or
integerOptional

Burn block height

Example: [777678]
Query parameters
limitinteger · max: 30Optional

Results per page

Default: 20
offsetintegerOptional

Result offset

Default: 0
Responses
200
Default Response
application/json
get
GET /extended/v2/burn-blocks/{height_or_hash}/blocks HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "limit": 20,
  "offset": 0,
  "total": 1,
  "results": [
    {
      "canonical": true,
      "height": 1,
      "hash": "text",
      "block_time": 1,
      "block_time_iso": "text",
      "tenure_height": 1,
      "index_block_hash": "text",
      "parent_block_hash": "text",
      "parent_index_block_hash": "text",
      "burn_block_time": 1,
      "burn_block_time_iso": "text",
      "burn_block_hash": "text",
      "burn_block_height": 1,
      "miner_txid": "text",
      "tx_count": 1,
      "execution_cost_read_count": 1,
      "execution_cost_read_length": 1,
      "execution_cost_runtime": 1,
      "execution_cost_write_count": 1,
      "execution_cost_write_length": 1
    }
  ]
}
PreviousBlocksNextFaucets