Skip to main content

/extended/v1/block REST API Endpoint

Retrieves a list of recently mined blocks. If you need to actively monitor new blocks, we recommend subscribing to WebSockets or Socket.iofor real-time updates.

Updated on
Oct 4, 2023

/extended/v1/block REST API Endpoint

Query Parameters

limit
integer
Default: 20. The max number of blocks to fetch.
offset
integer
index of first block to fetch.

Returns

object
array
GET request that returns blocks
limit
integer
The number of blocks to return.
offset
integer
The number of blocks to skip (starting at 0).
total
integer
The total number of available blocks.
results
array
List of blocks.
canonical
boolean
Set to true if the block corresponds to the canonical chain tip.
height
integer
The height of the block.
hash
string
The hash representing the block.
parent_block_hash
string
The 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 timestamp indicating when this block was mined (YYYY-MM-DDTHH:mm:ss.sssZ).
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. Empty string if no parent microblock stream exists.
parent_microblock_sequence
integer
The sequence number of the last streamed block that precedes this block to which this block is to be appended. -1 if no parent microblock stream exists.
txs
array
List of transactions included in the block.
microblocks_accepted
array
List of microblocks that were accepted in this anchor block. Does not include orphaned microblocks.
microblocks_streamed
array
List of microblocks that were streamed/produced by this anchor block's miner. Only includes microblocks accepted in the following anchor block. Does not include orphaned microblocks.
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.
Request
1
curl -X 'GET' \
2
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/block?limit=30&offset=42000' \
3
    -H 'Content-Type: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free