Skip to main content

Get block by burnchain height

deprecated

This endpoint has been deprecated and may be removed in future versions of the API.

NOTE: This endpoint is deprecated in favor of Get blocks.

Retrieves block details of a specific block for a given burn chain height

Path Parameters
burn_block_height number REQUIRED

Height of the burn chain block

Responses
200

Block

Schema OPTIONAL
canonical boolean

Set to true if block corresponds to the canonical chain tip

height integer

Height of the block

hash string

Hash representing the block

block_time number

Unix timestamp (in seconds) indicating when this block was mined.

block_time_iso string

An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) indicating when this block was mined.

index_block_hash string

The only hash that can uniquely identify an anchored block or an unconfirmed state trie

parent_block_hash string

Hash of the parent block

burn_block_time number

Unix timestamp (in seconds) indicating when this block was mined.

burn_block_time_iso string

An ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ) indicating when this block was mined.

burn_block_hash string

Hash of the anchor chain block

burn_block_height integer

Height of the anchor chain block

miner_txid string

Anchor chain transaction ID

parent_microblock_hash string

The hash of the last streamed block that precedes this block to which this block is to be appended. Not every anchored block will have a parent microblock stream. An anchored block that does not have a parent microblock stream has the parent microblock hash set to an empty string, and the parent microblock sequence number set to -1.

parent_microblock_sequence integer

The hash of the last streamed block that precedes this block to which this block is to be appended. Not every anchored block will have a parent microblock stream. An anchored block that does not have a parent microblock stream has the parent microblock hash set to an empty string, and the parent microblock sequence number set to -1.

txs string[]

List of transactions included in the block

microblocks_accepted string[]

List of microblocks that were accepted in this anchor block. Not every anchored block will have a accepted all (or any) of the previously streamed microblocks. Microblocks that were orphaned are not included in this list.

microblocks_streamed string[]

List of microblocks that were streamed/produced by this anchor block's miner. This list only includes microblocks that were accepted in the following anchor block. Microblocks that were orphaned are not included in this list.

execution_cost_read_count integer

Execution cost read count.

execution_cost_read_length integer

Execution cost read length.

execution_cost_runtime integer

Execution cost runtime.

execution_cost_write_count integer

Execution cost write count.

execution_cost_write_length integer

Execution cost write length.

microblock_tx_count object

List of txs counts in each accepted microblock

404

Cannot find block with given height