Skip to main content

Get recent blocks

:::caution 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 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