Skip to main content

Get recent blocks

Retrieves a list of recently mined blocks

If you need to actively monitor new blocks, we highly recommend subscribing to WebSockets or Socket.io for real-time updates.

Query Parameters
limit integer

Possible values: value ≤ 30

max number of blocks to fetch

offset integer

index of first block to fetch

Responses
200

List of blocks

Schema OPTIONAL
limit integer

Possible values: value ≤ 30

The number of blocks to return

offset integer

The number to blocks to skip (starting at 0)

total integer

The number of blocks available

results object[]
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

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