Blocks

Fetch a Nakamoto block

get

Fetch a Nakamoto block by its index block hash.

Path parameters
block_idstringRequired

The block's ID hash

Responses
200
The raw SIP-003-encoded block will be returned.
application/json
Responsestring

GET fee estimates

get
GET /v3/blocks/{block_id} HTTP/1.1
Host: stacks.nownodes.io
Accept: */*

binary

Fetch a Nakamoto block by its height and optional tip

get

Fetch a Nakamoto block by its height and optional tip.

Path parameters
block_heightintegerRequired

The block's height

Query parameters
tipstringOptional

The Stacks chain tip to query from. If tip == latest or empty, the query will be run from the latest known tip.

Responses
200
The raw SIP-003-encoded block will be returned.
application/json
Responsestring

GET fee estimates

get
GET /v3/blocks/height/{block_height} HTTP/1.1
Host: stacks.nownodes.io
Accept: */*

binary

Fetch metadata about the ongoing Nakamoto tenure

get

Fetch metadata about the ongoing Nakamoto tenure. This information is sufficient to obtain and authenticate the highest complete tenure, as well as obtain new tenure blocks.

Responses
200
Metadata about the ongoing tenure
application/json
get
GET /v3/tenures/info HTTP/1.1
Host: stacks.nownodes.io
Accept: */*
200

Metadata about the ongoing tenure

{
  "consensus_hash": "4c5a49be0e34dc603b66f090fd07d28a2f76a2ad",
  "parent_consensus_hash": "fa8a04af41957499afdd4082b9b702ffca9a4370",
  "parent_tenure_start_block_id": "0cfec8433849d353ad6b2fe1173da143e3d4a3ab452588a14eb074d0181ac202",
  "reward_cycle": 8,
  "tenure_start_block_id": "0425099d51547c714df6a7864c040c1a605b198ff07f71d19a823139c88a35f8",
  "tip_block_id": "52d64f5e47abc7666c4fed3fe850f381f93f2d588ee2a92a4e07b44f14588d5e",
  "tip_height": 416
}

Fetch a sequence of Nakamoto blocks in a tenure

get

Fetch a sequence of Nakamoto blocks in a tenure. The blocks will be served in order from highest to lowest. The blocks will be encoded in their SIP-003 wire format, and concatenated together.

Path parameters
block_idstringRequired

The tenure-start block ID of the tenure to query

Query parameters
stopstringOptional

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.

Responses
200
SIP-003-encoded Nakamoto blocks, concatenated together
application/json
Responsestring

GET fee estimates

get
GET /v3/tenures/{block_id} HTTP/1.1
Host: stacks.nownodes.io
Accept: */*
200

SIP-003-encoded Nakamoto blocks, concatenated together

binary

Fetch information about evaluated burnchain blocks (i.e., sortitions).

get

Fetch sortition information about a burnchain block. If the lookup_kind and lookup parameters are empty, it will return information about the latest burn block.

Path parameters
lookup_kindstringOptional

The style of lookup that should be performed. If not given, the most recent burn block processed will be returned. Otherwise, the lookup_kind should be one of the following strings:

  • consensus - find the burn block using the consensus hash supplied in the lookup field.
  • burn_height - find the burn block using the burn block height supplied in the lookup field.
  • burn - find the burn block using the burn block hash supplied in the lookup field.
  • latest_and_last - return information about the latest burn block with a winning miner and the previous such burn block
lookupstringOptional

The value to use for the lookup if lookup_kind is consensus, burn_height, or burn

Responses
200
Information for the burn block or in the case of `latest_and_last`, multiple burn blocks
application/json
get
GET /v3/sortitions/{lookup_kind}/{lookup} HTTP/1.1
Host: stacks.nownodes.io
Accept: */*
200

Information for the burn block or in the case of latest_and_last, multiple burn blocks

[
  {
    "burn_block_hash": "0x046f54cd1924a5d80fc3b8186d0334b7521acae90f9e136e2bee680c720d0e83",
    "burn_block_height": 231,
    "burn_header_timestamp": 1726797570,
    "sortition_id": "0x8a5116b7b4306dc4f6db290d1adfff9e1347f3e921bb793fc4c33e2ff05056e2",
    "parent_sortition_id": "0xdaf479110cf859e58c56b6ae941f8a14e7c7992c57027183dfbda4a4b820897c",
    "consensus_hash": "0x8d2c51db737597a93191f49bcdc9c7bb44b90892",
    "was_sortition": true,
    "miner_pk_hash160": "0x6bc51b33e9f3626944eb879147e18111581f8f9b",
    "stacks_parent_ch": "0x697357c72da55b759b1d6b721676c92c69f0b490",
    "last_sortition_ch": "0x697357c72da55b759b1d6b721676c92c69f0b490",
    "committed_block_hash": "0xeea47d6d639c565027110e192e308fb11656183d5c077bcd718d830652800183",
    "vrf_seed": "0x48b754acc291a5bfad1354ee19bbc471f14af2b21dc7eccc0f929bd16798defe"
  }
]

Get number of blocks signed by signer during a given reward cycle

get

Get number of blocks signed by signer during a given reward cycle

Path parameters
signerstringRequired

Hex-encoded compressed Secp256k1 public key of signer

cycle_numberintegerRequired

Reward cycle number

Responses
200
Number of blocks signed
application/json
Responseinteger
Example: 7
get
GET /v3/signer/{signer}/{cycle_number} HTTP/1.1
Host: stacks.nownodes.io
Accept: */*
200

Number of blocks signed

7
PreviousMiningNextModels