Blocks
The block's ID hash (64-character hex string)
0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdefPattern: ^[0-9a-f]{64}$The raw SIP-003-encoded block will be returned.
Bad request
Not found
Method Not Allowed
Internal Server Error
The block's height (max 4294967295)
Stacks chain tip to query from. Options:
- (empty/omitted): Use latest anchored tip (canonical confirmed state)
latest: Use latest known tip including unconfirmed microblocks{block_id}: Use specific block ID (64 hex characters)
latestPattern: ^(latest|[0-9a-f]{64})?$The raw SIP-003-encoded block will be returned.
Bad request
Not found
Internal Server Error
Metadata about the ongoing tenure
Consensus hash of the tenure
^[0-9a-f]{40}$Block ID where the tenure started
^[0-9a-f]{64}$Parent consensus hash
^[0-9a-f]{40}$Parent tenure start block ID
^[0-9a-f]{64}$Current tip block ID
^[0-9a-f]{64}$Current tip height
Current reward cycle
Metadata about the ongoing tenure
The tenure-start block ID of the tenure to query (64-character hex string)
0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdefPattern: ^[0-9a-f]{64}$The block ID hash of the highest block in this tenure that is already known to the caller. Neither the corresponding block nor any of its ancestors will be served. This is used to fetch tenure blocks that the caller does not have.
^[0-9a-f]{64}$SIP-003-encoded Nakamoto blocks, concatenated together
Bad request
Not found
Method Not Allowed
Internal Server Error
The hex-encoded consensus hash of the tenure to query (40 hexadecimal characters, without 0x prefix)
^[0-9a-f]{40}$List of Stacks blocks in the tenure
Consensus hash of the tenure
^[0-9a-f]{40}$Height of the Bitcoin block
Hash of the Bitcoin block
^[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Get the list of Nakamoto Stacks blocks in a tenure given Bitcoin block hash
The hex-encoded Bitcoin block hash of the tenure to query (64 hexadecimal characters, without 0x prefix)
^[0-9a-f]{64}$List of Stacks blocks in the tenure
Consensus hash of the tenure
^[0-9a-f]{40}$Height of the Bitcoin block
Hash of the Bitcoin block
^[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Get the list of Nakamoto Stacks blocks in a tenure given Bitcoin block height
The Bitcoin block height of the tenure to query
List of Stacks blocks in the tenure
Consensus hash of the tenure
^[0-9a-f]{40}$Height of the Bitcoin block
Hash of the Bitcoin block
^[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Latest sortition information
Array of sortition information objects from the burnchain
The burnchain header hash of the block that triggered this event
^0x[0-9a-f]{64}$The burn height of the block that triggered this event
The burn block time of the sortition (Unix timestamp)
This sortition ID of the block that triggered this event. This incorporates PoX forking information and the burn block hash to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{64}$The parent of this burn block's Sortition ID
^0x[0-9a-f]{64}$The consensus hash of the block that triggered this event. This incorporates PoX forking information and burn op information to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{40}$Boolean indicating whether or not there was a successful sortition (i.e. a winning block or miner was chosen). This will also be true if this sortition corresponds to a shadow block.
If sortition occurred, and the miner's VRF key registration associated a nakamoto mining pubkey with their commit, this will contain the Hash160 of that mining key.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the burn block corresponding to the winning block commit's parent block ptr. In 3.x, this is the consensus hash of the tenure that this new burn block's miner will be building off of.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the most recent sortition before this one.
^0x[0-9a-f]{40}$In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.
^0x[0-9a-f]{64}$This is the VRF seed generated by this sortition
^0x[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Latest and last sortition information
Array of sortition information objects from the burnchain
The burnchain header hash of the block that triggered this event
^0x[0-9a-f]{64}$The burn height of the block that triggered this event
The burn block time of the sortition (Unix timestamp)
This sortition ID of the block that triggered this event. This incorporates PoX forking information and the burn block hash to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{64}$The parent of this burn block's Sortition ID
^0x[0-9a-f]{64}$The consensus hash of the block that triggered this event. This incorporates PoX forking information and burn op information to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{40}$Boolean indicating whether or not there was a successful sortition (i.e. a winning block or miner was chosen). This will also be true if this sortition corresponds to a shadow block.
If sortition occurred, and the miner's VRF key registration associated a nakamoto mining pubkey with their commit, this will contain the Hash160 of that mining key.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the burn block corresponding to the winning block commit's parent block ptr. In 3.x, this is the consensus hash of the tenure that this new burn block's miner will be building off of.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the most recent sortition before this one.
^0x[0-9a-f]{40}$In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.
^0x[0-9a-f]{64}$This is the VRF seed generated by this sortition
^0x[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Hex-encoded consensus hash (40 characters)
^[0-9a-f]{40}$Sortition information for the consensus hash
Array of sortition information objects from the burnchain
The burnchain header hash of the block that triggered this event
^0x[0-9a-f]{64}$The burn height of the block that triggered this event
The burn block time of the sortition (Unix timestamp)
This sortition ID of the block that triggered this event. This incorporates PoX forking information and the burn block hash to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{64}$The parent of this burn block's Sortition ID
^0x[0-9a-f]{64}$The consensus hash of the block that triggered this event. This incorporates PoX forking information and burn op information to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{40}$Boolean indicating whether or not there was a successful sortition (i.e. a winning block or miner was chosen). This will also be true if this sortition corresponds to a shadow block.
If sortition occurred, and the miner's VRF key registration associated a nakamoto mining pubkey with their commit, this will contain the Hash160 of that mining key.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the burn block corresponding to the winning block commit's parent block ptr. In 3.x, this is the consensus hash of the tenure that this new burn block's miner will be building off of.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the most recent sortition before this one.
^0x[0-9a-f]{40}$In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.
^0x[0-9a-f]{64}$This is the VRF seed generated by this sortition
^0x[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Hex-encoded burn header hash (64 characters)
^[0-9a-f]{64}$Sortition information for the burn header hash
Array of sortition information objects from the burnchain
The burnchain header hash of the block that triggered this event
^0x[0-9a-f]{64}$The burn height of the block that triggered this event
The burn block time of the sortition (Unix timestamp)
This sortition ID of the block that triggered this event. This incorporates PoX forking information and the burn block hash to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{64}$The parent of this burn block's Sortition ID
^0x[0-9a-f]{64}$The consensus hash of the block that triggered this event. This incorporates PoX forking information and burn op information to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{40}$Boolean indicating whether or not there was a successful sortition (i.e. a winning block or miner was chosen). This will also be true if this sortition corresponds to a shadow block.
If sortition occurred, and the miner's VRF key registration associated a nakamoto mining pubkey with their commit, this will contain the Hash160 of that mining key.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the burn block corresponding to the winning block commit's parent block ptr. In 3.x, this is the consensus hash of the tenure that this new burn block's miner will be building off of.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the most recent sortition before this one.
^0x[0-9a-f]{40}$In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.
^0x[0-9a-f]{64}$This is the VRF seed generated by this sortition
^0x[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Burn block height (integer, max 4294967295)
Sortition information for the burn block height
Array of sortition information objects from the burnchain
The burnchain header hash of the block that triggered this event
^0x[0-9a-f]{64}$The burn height of the block that triggered this event
The burn block time of the sortition (Unix timestamp)
This sortition ID of the block that triggered this event. This incorporates PoX forking information and the burn block hash to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{64}$The parent of this burn block's Sortition ID
^0x[0-9a-f]{64}$The consensus hash of the block that triggered this event. This incorporates PoX forking information and burn op information to obtain an identifier that is unique across PoX forks and burnchain forks.
^0x[0-9a-f]{40}$Boolean indicating whether or not there was a successful sortition (i.e. a winning block or miner was chosen). This will also be true if this sortition corresponds to a shadow block.
If sortition occurred, and the miner's VRF key registration associated a nakamoto mining pubkey with their commit, this will contain the Hash160 of that mining key.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the burn block corresponding to the winning block commit's parent block ptr. In 3.x, this is the consensus hash of the tenure that this new burn block's miner will be building off of.
^0x[0-9a-f]{40}$If sortition occurred, this will be the consensus hash of the most recent sortition before this one.
^0x[0-9a-f]{40}$In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.
^0x[0-9a-f]{64}$This is the VRF seed generated by this sortition
^0x[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Get number of blocks signed by signer during a given reward cycle
Hex-encoded compressed Secp256k1 public key of signer
^0[23][0-9a-f]{64}$Reward cycle number
Stacks chain tip to query from. Options:
- (empty/omitted): Use latest anchored tip (canonical confirmed state)
latest: Use latest known tip including unconfirmed microblocks{block_id}: Use specific block ID (64 hex characters)
latestPattern: ^(latest|[0-9a-f]{64})?$Number of blocks signed
Number of blocks signed by this signer
Bad request
Not found
Internal Server Error
Hex-encoded Stacks block ID (64 characters)
^[0-9a-f]{64}$Stacks chain tip to query from. Options:
- (empty/omitted): Use latest anchored tip (canonical confirmed state)
latest: Use latest known tip including unconfirmed microblocks{block_id}: Use specific block ID (64 hex characters)
latestPattern: ^(latest|[0-9a-f]{64})?$Stream of confirmed microblocks
Bad request
Not found
Internal Server Error
Get a stream of microblocks beginning
with the given microblock (Epoch 2.x).
Hex-encoded microblock hash (64 characters)
^[0-9a-f]{64}$The microblock data
Bad request
Not found
Internal Server Error
Hex-encoded parent block ID (64 characters)
^[0-9a-f]{64}$Starting sequence number (0-65535)
Stream of unconfirmed microblocks
Bad request
Not found
Internal Server Error
Index-block hash of the accepted microblock
32-byte block-header hash (hex)
^[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Number of headers to return (max 256)
Stacks chain tip to query from. Options:
- (empty/omitted): Use latest anchored tip (canonical confirmed state)
latest: Use latest known tip including unconfirmed microblocks{block_id}: Use specific block ID (64 hex characters)
latestPattern: ^(latest|[0-9a-f]{64})?$Array of block headers
JSON array returned by /v2/headers/{quantity}. Each entry is an ExtendedStacksHeader.
20-byte burn-chain consensus hash (hex, no 0x prefix)
^[0-9a-f]{40}$Hex-encoded SIP-003 serialization of the Stacks block header
^[0-9a-f]+$32-byte index-block ID of the parent Stacks block (hex)
^[0-9a-f]{64}$Bad request
Not found
Internal Server Error
Hex-encoded block ID (64 characters)
^[0-9a-f]{64}$The block data
Bad request
Not found
Internal Server Error
Starting consensus hash (40 hexadecimal characters, without 0x prefix)
^[0-9a-f]{40}$Stopping consensus hash (40 hexadecimal characters, without 0x prefix)
^[0-9a-f]{40}$Ordered list of tenure fork events from stop back to (and including) start
Information about a tenure used for fork-detection.
0x-prefixed 32-byte Bitcoin block hash that triggered the tenure event
^0x[0-9a-fA-F]{64}$0x-prefixed 32-byte sortition ID (unique across PoX and Bitcoin forks)
^0x[0-9a-fA-F]{64}$0x-prefixed sortition ID of the parent burn block
^0x[0-9a-fA-F]{64}$0x-prefixed 20-byte consensus hash identifying the tenure
^0x[0-9a-fA-F]{40}$Whether a winning sortition occurred at this burn block
0x-prefixed index-block ID of the first Stacks block in the tenure (if any)
^0x[0-9a-fA-F]{64}$0x-prefixed SIP-003 binary encoding of all Nakamoto blocks mined in this tenure
Bad request
Not found
Internal Server Error
Consensus hash (40 characters)
^[0-9a-f]{40}$Tenure tip block information
JSON encoding of StacksBlockHeaderTypes returned by /v3/tenures/tip.
Exactly one variant property will be present: either Epoch2 or Nakamoto.
Bad request
Not found
Internal Server Error
Consensus hash (40 characters)
^[0-9a-f]{40}$Tenure tip block information
JSON encoding of BlockHeaderWithMetadata returned by /v3/tenures/tip_metadata.
Exactly one variant property will be present: either Epoch2 or Nakamoto.
Hex-encoded bitcoin block hash
Bad request
Not found
Internal Server Error
Plain-text secret value that must exactly equal the node's
configured password, which is set as connection_options.auth_token
in the node's configuration file.
If set to "1" the node will broadcast the uploaded block to peers.
When present the request must include a valid Authorization header.
Binary SIP-003 encoding of a NakamotoBlock
Block upload result.
The ID of the uploaded block
Whether the block was accepted
Bad request
Unauthorized. Invalid or missing authentication token.
Internal Server Error
Plain-text secret value that must exactly equal the node's
configured password, which is set as connection_options.auth_token
in the node's configuration file.
The block ID hash
^[0-9a-f]{64}$Content of the replayed block
Hash of the block
^[0-9a-f]{64}$Block ID (index block hash)
^[0-9a-f]{64}$Height of the Stacks block
Consensus hash of the tenure
^[0-9a-f]{40}$total fees for the block
Uncompressed signature of the miner
^[0-9a-f]{130}$Parent Block ID (index block hash)
^[0-9a-f]{64}$Uncompressed signature of the signer
block state index root computed from the MARF (got from the original block)
^[0-9a-f]{64}$merkle_root of the included transactions
does the merkle_root matches the chain block and the simulated one?
Bad request
Unauthorized. Invalid or missing authentication token.
Not found
Internal Server Error
Simulate mining of a block with the specified transactions and returns its content
Plain-text secret value that must exactly equal the node's
configured password, which is set as connection_options.auth_token
in the node's configuration file.
The block ID hash
^[0-9a-f]{64}$SIP-003-encoded Transaction in hex format
Content of the simulated block
Hash of the block
^[0-9a-f]{64}$Block ID (index block hash)
^[0-9a-f]{64}$Height of the Stacks block
Consensus hash of the tenure
^[0-9a-f]{40}$total fees for the block
Uncompressed signature of the miner
^[0-9a-f]{130}$Parent Block ID (index block hash)
^[0-9a-f]{64}$Uncompressed signature of the signer
block state index root computed from the MARF (got from the original block)
^[0-9a-f]{64}$merkle_root of the included transactions
does the merkle_root matches the chain block and the simulated one?
Bad request
Unauthorized. Invalid or missing authentication token.
Not found
Internal Server Error
Last updated
Was this helpful?