Ctrlk
Quick LinksPlatform
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Blocks

Operations for retrieving block and microblock data.

Get Nakamoto block by ID

get
/v3/blocks/{block_id}

Get a specific Nakamoto block (Stacks 3.x+) by its index block hash. This endpoint streams the block data from the Nakamoto staging blocks database where Nakamoto blocks are stored with additional metadata including tenure information.

Compatibility: Works with Nakamoto blocks only. For Stacks 2.x blocks, use /v2/blocks/{block_id}.

Path parameters
block_idstring · min: 64 · max: 64Required

The block's ID hash (64-character hex string)

Example: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdefPattern: ^[0-9a-f]{64}$
Responses
200

The raw SIP-003-encoded block will be returned.

application/octet-stream
string · binaryOptional
get/v3/blocks/{block_id}
GET /v3/blocks/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Fetch a Nakamoto block by its height and optional tip

get
/v3/blocks/height/{block_height}

Fetch a Nakamoto block by its height and optional tip.

Path parameters
block_heightinteger · max: 4294967295Required

The block's height (max 4294967295)

Query parameters
tipstring · max: 64Optional

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)
Example: latestPattern: ^(latest|[0-9a-f]{64})?$
Responses
200

The raw SIP-003-encoded block will be returned.

application/octet-stream
string · binaryOptional
get/v3/blocks/height/{block_height}
GET /v3/blocks/height/{block_height} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Fetch metadata about the ongoing Nakamoto tenure

get
/v3/tenures/info

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
consensus_hashstringOptional

Consensus hash of the tenure

Pattern: ^[0-9a-f]{40}$
tenure_start_block_idstringOptional

Block ID where the tenure started

Pattern: ^[0-9a-f]{64}$
parent_consensus_hashstringOptional

Parent consensus hash

Pattern: ^[0-9a-f]{40}$
parent_tenure_start_block_idstringOptional

Parent tenure start block ID

Pattern: ^[0-9a-f]{64}$
tip_block_idstringOptional

Current tip block ID

Pattern: ^[0-9a-f]{64}$
tip_heightintegerOptional

Current tip height

reward_cycleintegerOptional

Current reward cycle

get/v3/tenures/info
GET /v3/tenures/info HTTP/1.1
Host: localhost:20443
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
/v3/tenures/{block_id}

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_idstring · min: 64 · max: 64Required

The tenure-start block ID of the tenure to query (64-character hex string)

Example: 0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdefPattern: ^[0-9a-f]{64}$
Query parameters
stopstring · min: 64 · max: 64Optional

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.

Pattern: ^[0-9a-f]{64}$
Responses
200

SIP-003-encoded Nakamoto blocks, concatenated together

application/octet-stream
string · binaryOptional
get/v3/tenures/{block_id}
GET /v3/tenures/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Get the list of Stacks blocks in a tenure

get
/v3/tenures/blocks/{consensus_hash}

Get the list of blocks in a tenure. The blocks will be shown in order from highest to lowest.

Path parameters
consensus_hashstringRequired

The hex-encoded consensus hash of the tenure to query (40 hexadecimal characters, without 0x prefix)

Pattern: ^[0-9a-f]{40}$
Responses
200

List of Stacks blocks in the tenure

application/json
consensus_hashstringOptional

Consensus hash of the tenure

Pattern: ^[0-9a-f]{40}$
burn_block_heightinteger · uint64Optional

Height of the Bitcoin block

burn_block_hashstringOptional

Hash of the Bitcoin block

Pattern: ^[0-9a-f]{64}$
get/v3/tenures/blocks/{consensus_hash}
GET /v3/tenures/blocks/{consensus_hash} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "burn_block_hash": "dff0aba3d65209225e365692ac46d26fa64ca9760bd7c244fc27e2022f7cb90d",
  "burn_block_height": 51,
  "consensus_hash": "90b360130732dd83a165a7fa34386ae547512300",
  "stacks_blocks": [
    {
      "block_hash": "a9f3d8bca7d766a2022528e27c52f39ba77192f0712ea5515cc9d06b97821a11",
      "block_id": "67c795896b4c2940b3eb759871661a72e78458ba591dc63979d689d23695891f",
      "header_type": "nakamoto",
      "height": 116,
      "parent_block_id": "fb7102c45bb2f07a6dd86b6672cb39133861fc7d38087e82cb04d4faccfcab82"
    },
    {
      "block_hash": "3e81505acaa3d386e15256921dd1193e479fd9d7f81d993b1c2b327b9bfb05cc",
      "block_id": "fb7102c45bb2f07a6dd86b6672cb39133861fc7d38087e82cb04d4faccfcab82",
      "header_type": "nakamoto",
      "height": 115,
      "parent_block_id": "5d51f815bc71508768b71258d8bc2adc68c129428101a418083f5b5ab30d525e"
    },
    {
      "block_hash": "c6f427503dcbe8bf187c7ce523c7a239328b2ab4ec87d6013895b2bd9ed23604",
      "block_id": "5d51f815bc71508768b71258d8bc2adc68c129428101a418083f5b5ab30d525e",
      "header_type": "nakamoto",
      "height": 114,
      "parent_block_id": "7d1c89f57a467f888fed171a5b3a2e51a7652f862189710df7db814ef84a29e2"
    },
    {
      "block_hash": "f0665d1dd419e949d68c4e85b7f79e078d6c36d929820b9cd9c794a60c0505b4",
      "block_id": "7d1c89f57a467f888fed171a5b3a2e51a7652f862189710df7db814ef84a29e2",
      "header_type": "nakamoto",
      "height": 113,
      "parent_block_id": "b65ab3b6d113285390c1d99c09a62d940f5b55c1cbc10bdc1b478c395fc435f9"
    },
    {
      "block_hash": "0486701e4eed06b74c3d93b82ffc0f3700b3cb2bea41aea1a30e00a5669ec0b7",
      "block_id": "b65ab3b6d113285390c1d99c09a62d940f5b55c1cbc10bdc1b478c395fc435f9",
      "header_type": "nakamoto",
      "height": 112,
      "parent_block_id": "c711415e6eedffcb6be16e33eb5c5cf62c3f51047f9528a51e21cbd83b25c185"
    },
    {
      "block_hash": "6724170340a2e507dbe7b21b691412e196c7c8900a597786aa991c1429ae6b58",
      "block_id": "c711415e6eedffcb6be16e33eb5c5cf62c3f51047f9528a51e21cbd83b25c185",
      "header_type": "nakamoto",
      "height": 111,
      "parent_block_id": "b11d631ef1b052942973cac88527a56f6e00c51fd57f9b7a710713f58ddc2393"
    },
    {
      "block_hash": "2114066e4446242e558847f552ca839f65ae769ab59000087677007e52b0dab7",
      "block_id": "b11d631ef1b052942973cac88527a56f6e00c51fd57f9b7a710713f58ddc2393",
      "header_type": "nakamoto",
      "height": 110,
      "parent_block_id": "2ef1973e95ba622479e59e87251d35c1eaaa9cb7f99f3dd3a8a79359624c38eb"
    },
    {
      "block_hash": "2345d34722cb07e908c5dab7f89ec0756f34d7fe34c86e40881c29c6aa202601",
      "block_id": "2ef1973e95ba622479e59e87251d35c1eaaa9cb7f99f3dd3a8a79359624c38eb",
      "header_type": "nakamoto",
      "height": 109,
      "parent_block_id": "9c1f844267819dc7349ff0aff6e6c6f60d8c41b531e304cd89df022ca4d147bf"
    },
    {
      "block_hash": "6b904297fdd045e2d18b93083f9d36592fa6915a53e8461fc3b4c59f6c91bc6d",
      "block_id": "9c1f844267819dc7349ff0aff6e6c6f60d8c41b531e304cd89df022ca4d147bf",
      "header_type": "nakamoto",
      "height": 108,
      "parent_block_id": "335596dd153bfc155863a2d439940816cd5095a3b36e2738fb89d715c28ac6c5"
    },
    {
      "block_hash": "cd748c67a9b7e685c52f388cc1d5e334b3dbe2509535caaf9f7ea7b6e5bbad77",
      "block_id": "335596dd153bfc155863a2d439940816cd5095a3b36e2738fb89d715c28ac6c5",
      "header_type": "nakamoto",
      "height": 107,
      "parent_block_id": "45cb658a80897117c2cfa6191a7623344ed1079117ad8bb30113019278bac028"
    }
  ]
}

Get the list of Nakamoto Stacks blocks in a tenure given Bitcoin block hash

get
/v3/tenures/blocks/hash/{burnchain_block_hash}

Get the list of Nakamoto blocks in a tenure given the Bitcoin block hash. The blocks will be shown in order from highest to lowest. This is only for Nakamoto blocks, Epoch2 ones will not be shown.

Path parameters
burnchain_block_hashstringRequired

The hex-encoded Bitcoin block hash of the tenure to query (64 hexadecimal characters, without 0x prefix)

Pattern: ^[0-9a-f]{64}$
Responses
200

List of Stacks blocks in the tenure

application/json
consensus_hashstringOptional

Consensus hash of the tenure

Pattern: ^[0-9a-f]{40}$
burn_block_heightinteger · uint64Optional

Height of the Bitcoin block

burn_block_hashstringOptional

Hash of the Bitcoin block

Pattern: ^[0-9a-f]{64}$
get/v3/tenures/blocks/hash/{burnchain_block_hash}
GET /v3/tenures/blocks/hash/{burnchain_block_hash} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "burn_block_hash": "dff0aba3d65209225e365692ac46d26fa64ca9760bd7c244fc27e2022f7cb90d",
  "burn_block_height": 51,
  "consensus_hash": "90b360130732dd83a165a7fa34386ae547512300",
  "stacks_blocks": [
    {
      "block_hash": "a9f3d8bca7d766a2022528e27c52f39ba77192f0712ea5515cc9d06b97821a11",
      "block_id": "67c795896b4c2940b3eb759871661a72e78458ba591dc63979d689d23695891f",
      "header_type": "nakamoto",
      "height": 116,
      "parent_block_id": "fb7102c45bb2f07a6dd86b6672cb39133861fc7d38087e82cb04d4faccfcab82"
    },
    {
      "block_hash": "3e81505acaa3d386e15256921dd1193e479fd9d7f81d993b1c2b327b9bfb05cc",
      "block_id": "fb7102c45bb2f07a6dd86b6672cb39133861fc7d38087e82cb04d4faccfcab82",
      "header_type": "nakamoto",
      "height": 115,
      "parent_block_id": "5d51f815bc71508768b71258d8bc2adc68c129428101a418083f5b5ab30d525e"
    },
    {
      "block_hash": "c6f427503dcbe8bf187c7ce523c7a239328b2ab4ec87d6013895b2bd9ed23604",
      "block_id": "5d51f815bc71508768b71258d8bc2adc68c129428101a418083f5b5ab30d525e",
      "header_type": "nakamoto",
      "height": 114,
      "parent_block_id": "7d1c89f57a467f888fed171a5b3a2e51a7652f862189710df7db814ef84a29e2"
    },
    {
      "block_hash": "f0665d1dd419e949d68c4e85b7f79e078d6c36d929820b9cd9c794a60c0505b4",
      "block_id": "7d1c89f57a467f888fed171a5b3a2e51a7652f862189710df7db814ef84a29e2",
      "header_type": "nakamoto",
      "height": 113,
      "parent_block_id": "b65ab3b6d113285390c1d99c09a62d940f5b55c1cbc10bdc1b478c395fc435f9"
    },
    {
      "block_hash": "0486701e4eed06b74c3d93b82ffc0f3700b3cb2bea41aea1a30e00a5669ec0b7",
      "block_id": "b65ab3b6d113285390c1d99c09a62d940f5b55c1cbc10bdc1b478c395fc435f9",
      "header_type": "nakamoto",
      "height": 112,
      "parent_block_id": "c711415e6eedffcb6be16e33eb5c5cf62c3f51047f9528a51e21cbd83b25c185"
    },
    {
      "block_hash": "6724170340a2e507dbe7b21b691412e196c7c8900a597786aa991c1429ae6b58",
      "block_id": "c711415e6eedffcb6be16e33eb5c5cf62c3f51047f9528a51e21cbd83b25c185",
      "header_type": "nakamoto",
      "height": 111,
      "parent_block_id": "b11d631ef1b052942973cac88527a56f6e00c51fd57f9b7a710713f58ddc2393"
    },
    {
      "block_hash": "2114066e4446242e558847f552ca839f65ae769ab59000087677007e52b0dab7",
      "block_id": "b11d631ef1b052942973cac88527a56f6e00c51fd57f9b7a710713f58ddc2393",
      "header_type": "nakamoto",
      "height": 110,
      "parent_block_id": "2ef1973e95ba622479e59e87251d35c1eaaa9cb7f99f3dd3a8a79359624c38eb"
    },
    {
      "block_hash": "2345d34722cb07e908c5dab7f89ec0756f34d7fe34c86e40881c29c6aa202601",
      "block_id": "2ef1973e95ba622479e59e87251d35c1eaaa9cb7f99f3dd3a8a79359624c38eb",
      "header_type": "nakamoto",
      "height": 109,
      "parent_block_id": "9c1f844267819dc7349ff0aff6e6c6f60d8c41b531e304cd89df022ca4d147bf"
    },
    {
      "block_hash": "6b904297fdd045e2d18b93083f9d36592fa6915a53e8461fc3b4c59f6c91bc6d",
      "block_id": "9c1f844267819dc7349ff0aff6e6c6f60d8c41b531e304cd89df022ca4d147bf",
      "header_type": "nakamoto",
      "height": 108,
      "parent_block_id": "335596dd153bfc155863a2d439940816cd5095a3b36e2738fb89d715c28ac6c5"
    },
    {
      "block_hash": "cd748c67a9b7e685c52f388cc1d5e334b3dbe2509535caaf9f7ea7b6e5bbad77",
      "block_id": "335596dd153bfc155863a2d439940816cd5095a3b36e2738fb89d715c28ac6c5",
      "header_type": "nakamoto",
      "height": 107,
      "parent_block_id": "45cb658a80897117c2cfa6191a7623344ed1079117ad8bb30113019278bac028"
    }
  ]
}

Get the list of Nakamoto Stacks blocks in a tenure given Bitcoin block height

get
/v3/tenures/blocks/height/{burnchain_block_height}

Get the list of Nakamoto blocks in a tenure given the Bitcoin block height. The blocks will be shown in order from highest to lowest. This is only for Nakamoto blocks, Epoch2 ones will not be shown.

Path parameters
burnchain_block_heightinteger · max: 4294967295Required

The Bitcoin block height of the tenure to query

Responses
200

List of Stacks blocks in the tenure

application/json
consensus_hashstringOptional

Consensus hash of the tenure

Pattern: ^[0-9a-f]{40}$
burn_block_heightinteger · uint64Optional

Height of the Bitcoin block

burn_block_hashstringOptional

Hash of the Bitcoin block

Pattern: ^[0-9a-f]{64}$
get/v3/tenures/blocks/height/{burnchain_block_height}
GET /v3/tenures/blocks/height/{burnchain_block_height} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "burn_block_hash": "dff0aba3d65209225e365692ac46d26fa64ca9760bd7c244fc27e2022f7cb90d",
  "burn_block_height": 51,
  "consensus_hash": "90b360130732dd83a165a7fa34386ae547512300",
  "stacks_blocks": [
    {
      "block_hash": "a9f3d8bca7d766a2022528e27c52f39ba77192f0712ea5515cc9d06b97821a11",
      "block_id": "67c795896b4c2940b3eb759871661a72e78458ba591dc63979d689d23695891f",
      "header_type": "nakamoto",
      "height": 116,
      "parent_block_id": "fb7102c45bb2f07a6dd86b6672cb39133861fc7d38087e82cb04d4faccfcab82"
    },
    {
      "block_hash": "3e81505acaa3d386e15256921dd1193e479fd9d7f81d993b1c2b327b9bfb05cc",
      "block_id": "fb7102c45bb2f07a6dd86b6672cb39133861fc7d38087e82cb04d4faccfcab82",
      "header_type": "nakamoto",
      "height": 115,
      "parent_block_id": "5d51f815bc71508768b71258d8bc2adc68c129428101a418083f5b5ab30d525e"
    },
    {
      "block_hash": "c6f427503dcbe8bf187c7ce523c7a239328b2ab4ec87d6013895b2bd9ed23604",
      "block_id": "5d51f815bc71508768b71258d8bc2adc68c129428101a418083f5b5ab30d525e",
      "header_type": "nakamoto",
      "height": 114,
      "parent_block_id": "7d1c89f57a467f888fed171a5b3a2e51a7652f862189710df7db814ef84a29e2"
    },
    {
      "block_hash": "f0665d1dd419e949d68c4e85b7f79e078d6c36d929820b9cd9c794a60c0505b4",
      "block_id": "7d1c89f57a467f888fed171a5b3a2e51a7652f862189710df7db814ef84a29e2",
      "header_type": "nakamoto",
      "height": 113,
      "parent_block_id": "b65ab3b6d113285390c1d99c09a62d940f5b55c1cbc10bdc1b478c395fc435f9"
    },
    {
      "block_hash": "0486701e4eed06b74c3d93b82ffc0f3700b3cb2bea41aea1a30e00a5669ec0b7",
      "block_id": "b65ab3b6d113285390c1d99c09a62d940f5b55c1cbc10bdc1b478c395fc435f9",
      "header_type": "nakamoto",
      "height": 112,
      "parent_block_id": "c711415e6eedffcb6be16e33eb5c5cf62c3f51047f9528a51e21cbd83b25c185"
    },
    {
      "block_hash": "6724170340a2e507dbe7b21b691412e196c7c8900a597786aa991c1429ae6b58",
      "block_id": "c711415e6eedffcb6be16e33eb5c5cf62c3f51047f9528a51e21cbd83b25c185",
      "header_type": "nakamoto",
      "height": 111,
      "parent_block_id": "b11d631ef1b052942973cac88527a56f6e00c51fd57f9b7a710713f58ddc2393"
    },
    {
      "block_hash": "2114066e4446242e558847f552ca839f65ae769ab59000087677007e52b0dab7",
      "block_id": "b11d631ef1b052942973cac88527a56f6e00c51fd57f9b7a710713f58ddc2393",
      "header_type": "nakamoto",
      "height": 110,
      "parent_block_id": "2ef1973e95ba622479e59e87251d35c1eaaa9cb7f99f3dd3a8a79359624c38eb"
    },
    {
      "block_hash": "2345d34722cb07e908c5dab7f89ec0756f34d7fe34c86e40881c29c6aa202601",
      "block_id": "2ef1973e95ba622479e59e87251d35c1eaaa9cb7f99f3dd3a8a79359624c38eb",
      "header_type": "nakamoto",
      "height": 109,
      "parent_block_id": "9c1f844267819dc7349ff0aff6e6c6f60d8c41b531e304cd89df022ca4d147bf"
    },
    {
      "block_hash": "6b904297fdd045e2d18b93083f9d36592fa6915a53e8461fc3b4c59f6c91bc6d",
      "block_id": "9c1f844267819dc7349ff0aff6e6c6f60d8c41b531e304cd89df022ca4d147bf",
      "header_type": "nakamoto",
      "height": 108,
      "parent_block_id": "335596dd153bfc155863a2d439940816cd5095a3b36e2738fb89d715c28ac6c5"
    },
    {
      "block_hash": "cd748c67a9b7e685c52f388cc1d5e334b3dbe2509535caaf9f7ea7b6e5bbad77",
      "block_id": "335596dd153bfc155863a2d439940816cd5095a3b36e2738fb89d715c28ac6c5",
      "header_type": "nakamoto",
      "height": 107,
      "parent_block_id": "45cb658a80897117c2cfa6191a7623344ed1079117ad8bb30113019278bac028"
    }
  ]
}

Get latest sortition information

get
/v3/sortitions

Get sortition information about the latest burnchain block processed by this node. Returns a single-element array with the latest sortition.

Responses
200

Latest sortition information

application/json

Array of sortition information objects from the burnchain

burn_block_hashstringRequired

The burnchain header hash of the block that triggered this event

Pattern: ^0x[0-9a-f]{64}$
burn_block_heightintegerRequired

The burn height of the block that triggered this event

burn_header_timestampintegerRequired

The burn block time of the sortition (Unix timestamp)

sortition_idstringRequired

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.

Pattern: ^0x[0-9a-f]{64}$
parent_sortition_idstringRequired

The parent of this burn block's Sortition ID

Pattern: ^0x[0-9a-f]{64}$
consensus_hashstringRequired

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.

Pattern: ^0x[0-9a-f]{40}$
was_sortitionbooleanRequired

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.

miner_pk_hash160string · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
stacks_parent_chstring · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
last_sortition_chstring · nullableOptional

If sortition occurred, this will be the consensus hash of the most recent sortition before this one.

Pattern: ^0x[0-9a-f]{40}$
committed_block_hashstring · nullableOptional

In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.

Pattern: ^0x[0-9a-f]{64}$
vrf_seedstring · nullableOptional

This is the VRF seed generated by this sortition

Pattern: ^0x[0-9a-f]{64}$
get/v3/sortitions
GET /v3/sortitions HTTP/1.1
Host: localhost:20443
Accept: */*

[
  {
    "burn_block_hash": "0x00000000000000000002173857dc821186d17c6aee85e545a74625b6bc9c3656",
    "burn_block_height": 902499,
    "burn_header_timestamp": 1750747303,
    "sortition_id": "0x7ae9066d4c3cf4a5c5f5f89d30bd012317be1c10f520af6b8f35d169c3a424ba",
    "parent_sortition_id": "0x04d40e2ee2a9ee79c59c2e85b2f742c57bdeed5a2c32bb3bf659a77e892d8234",
    "consensus_hash": "0xe4a00a6c88722c7812ba0a2f780c42247c1d2d4c",
    "was_sortition": true,
    "miner_pk_hash160": "0x37e79a837b4071a1fc6c1b49208e7d2141a25905",
    "stacks_parent_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "last_sortition_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "committed_block_hash": "0xdeb48fe0b0600092968fb7de1b6d586b111be7cd61bf52a666d14d41d6835ded",
    "vrf_seed": "0x49b75b824fcf765264d6ec91889a146bf52d46e2688f1b7ae7f7e5187765e99d"
  }
]

Get latest and last winning sortitions

get
/v3/sortitions/latest_and_last

Get sortition information about the latest burn block with a winning miner AND the previous such burn block. Returns an array with two sortition objects.

Responses
200

Latest and last sortition information

application/json

Array of sortition information objects from the burnchain

burn_block_hashstringRequired

The burnchain header hash of the block that triggered this event

Pattern: ^0x[0-9a-f]{64}$
burn_block_heightintegerRequired

The burn height of the block that triggered this event

burn_header_timestampintegerRequired

The burn block time of the sortition (Unix timestamp)

sortition_idstringRequired

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.

Pattern: ^0x[0-9a-f]{64}$
parent_sortition_idstringRequired

The parent of this burn block's Sortition ID

Pattern: ^0x[0-9a-f]{64}$
consensus_hashstringRequired

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.

Pattern: ^0x[0-9a-f]{40}$
was_sortitionbooleanRequired

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.

miner_pk_hash160string · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
stacks_parent_chstring · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
last_sortition_chstring · nullableOptional

If sortition occurred, this will be the consensus hash of the most recent sortition before this one.

Pattern: ^0x[0-9a-f]{40}$
committed_block_hashstring · nullableOptional

In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.

Pattern: ^0x[0-9a-f]{64}$
vrf_seedstring · nullableOptional

This is the VRF seed generated by this sortition

Pattern: ^0x[0-9a-f]{64}$
get/v3/sortitions/latest_and_last
GET /v3/sortitions/latest_and_last HTTP/1.1
Host: localhost:20443
Accept: */*

[
  {
    "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"
  },
  {
    "burn_block_hash": "0x496ff02cb63a4850d0bdee5fab69284b6eb0392b4538e1c462f82362c5becfa4",
    "burn_block_height": 230,
    "burn_header_timestamp": 1726797570,
    "sortition_id": "0xdaf479110cf859e58c56b6ae941f8a14e7c7992c57027183dfbda4a4b820897c",
    "parent_sortition_id": "0xf9058692055cbd879d7f71e566e44b905a887b2b182407ed596b5d6499ceae2a",
    "consensus_hash": "0x697357c72da55b759b1d6b721676c92c69f0b490",
    "was_sortition": true,
    "miner_pk_hash160": "0x6bc51b33e9f3626944eb879147e18111581f8f9b",
    "stacks_parent_ch": "0xf7d1bd7d9d5c5a5c368402b6ef9510bd014d70f7",
    "last_sortition_ch": "0xf7d1bd7d9d5c5a5c368402b6ef9510bd014d70f7",
    "committed_block_hash": "0x36ee5f7f7271de1c1d4cd830e36320b51e01605547621267ae6e9b4e9b10f95e"
  }
]

Get sortition by consensus hash

get
/v3/sortitions/consensus/{consensus_hash}

Get sortition information for a specific consensus hash. Returns a single-element array with the matching sortition.

Path parameters
consensus_hashstringRequired

Hex-encoded consensus hash (40 characters)

Pattern: ^[0-9a-f]{40}$
Responses
200

Sortition information for the consensus hash

application/json

Array of sortition information objects from the burnchain

burn_block_hashstringRequired

The burnchain header hash of the block that triggered this event

Pattern: ^0x[0-9a-f]{64}$
burn_block_heightintegerRequired

The burn height of the block that triggered this event

burn_header_timestampintegerRequired

The burn block time of the sortition (Unix timestamp)

sortition_idstringRequired

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.

Pattern: ^0x[0-9a-f]{64}$
parent_sortition_idstringRequired

The parent of this burn block's Sortition ID

Pattern: ^0x[0-9a-f]{64}$
consensus_hashstringRequired

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.

Pattern: ^0x[0-9a-f]{40}$
was_sortitionbooleanRequired

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.

miner_pk_hash160string · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
stacks_parent_chstring · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
last_sortition_chstring · nullableOptional

If sortition occurred, this will be the consensus hash of the most recent sortition before this one.

Pattern: ^0x[0-9a-f]{40}$
committed_block_hashstring · nullableOptional

In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.

Pattern: ^0x[0-9a-f]{64}$
vrf_seedstring · nullableOptional

This is the VRF seed generated by this sortition

Pattern: ^0x[0-9a-f]{64}$
get/v3/sortitions/consensus/{consensus_hash}
GET /v3/sortitions/consensus/{consensus_hash} HTTP/1.1
Host: localhost:20443
Accept: */*

[
  {
    "burn_block_hash": "0x00000000000000000002173857dc821186d17c6aee85e545a74625b6bc9c3656",
    "burn_block_height": 902499,
    "burn_header_timestamp": 1750747303,
    "sortition_id": "0x7ae9066d4c3cf4a5c5f5f89d30bd012317be1c10f520af6b8f35d169c3a424ba",
    "parent_sortition_id": "0x04d40e2ee2a9ee79c59c2e85b2f742c57bdeed5a2c32bb3bf659a77e892d8234",
    "consensus_hash": "0xe4a00a6c88722c7812ba0a2f780c42247c1d2d4c",
    "was_sortition": true,
    "miner_pk_hash160": "0x37e79a837b4071a1fc6c1b49208e7d2141a25905",
    "stacks_parent_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "last_sortition_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "committed_block_hash": "0xdeb48fe0b0600092968fb7de1b6d586b111be7cd61bf52a666d14d41d6835ded",
    "vrf_seed": "0x49b75b824fcf765264d6ec91889a146bf52d46e2688f1b7ae7f7e5187765e99d"
  }
]

Get sortition by burn header hash

get
/v3/sortitions/burn/{burn_header_hash}

Get sortition information for a specific burn header hash. Returns a single-element array with the matching sortition.

Path parameters
burn_header_hashstringRequired

Hex-encoded burn header hash (64 characters)

Pattern: ^[0-9a-f]{64}$
Responses
200

Sortition information for the burn header hash

application/json

Array of sortition information objects from the burnchain

burn_block_hashstringRequired

The burnchain header hash of the block that triggered this event

Pattern: ^0x[0-9a-f]{64}$
burn_block_heightintegerRequired

The burn height of the block that triggered this event

burn_header_timestampintegerRequired

The burn block time of the sortition (Unix timestamp)

sortition_idstringRequired

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.

Pattern: ^0x[0-9a-f]{64}$
parent_sortition_idstringRequired

The parent of this burn block's Sortition ID

Pattern: ^0x[0-9a-f]{64}$
consensus_hashstringRequired

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.

Pattern: ^0x[0-9a-f]{40}$
was_sortitionbooleanRequired

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.

miner_pk_hash160string · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
stacks_parent_chstring · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
last_sortition_chstring · nullableOptional

If sortition occurred, this will be the consensus hash of the most recent sortition before this one.

Pattern: ^0x[0-9a-f]{40}$
committed_block_hashstring · nullableOptional

In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.

Pattern: ^0x[0-9a-f]{64}$
vrf_seedstring · nullableOptional

This is the VRF seed generated by this sortition

Pattern: ^0x[0-9a-f]{64}$
get/v3/sortitions/burn/{burn_header_hash}
GET /v3/sortitions/burn/{burn_header_hash} HTTP/1.1
Host: localhost:20443
Accept: */*

[
  {
    "burn_block_hash": "0x00000000000000000002173857dc821186d17c6aee85e545a74625b6bc9c3656",
    "burn_block_height": 902499,
    "burn_header_timestamp": 1750747303,
    "sortition_id": "0x7ae9066d4c3cf4a5c5f5f89d30bd012317be1c10f520af6b8f35d169c3a424ba",
    "parent_sortition_id": "0x04d40e2ee2a9ee79c59c2e85b2f742c57bdeed5a2c32bb3bf659a77e892d8234",
    "consensus_hash": "0xe4a00a6c88722c7812ba0a2f780c42247c1d2d4c",
    "was_sortition": true,
    "miner_pk_hash160": "0x37e79a837b4071a1fc6c1b49208e7d2141a25905",
    "stacks_parent_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "last_sortition_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "committed_block_hash": "0xdeb48fe0b0600092968fb7de1b6d586b111be7cd61bf52a666d14d41d6835ded",
    "vrf_seed": "0x49b75b824fcf765264d6ec91889a146bf52d46e2688f1b7ae7f7e5187765e99d"
  }
]

Get sortition by burn block height

get
/v3/sortitions/burn_height/{height}

Get sortition information for a specific burn block height. Returns a single-element array with the matching sortition.

Path parameters
heightinteger · max: 4294967295Required

Burn block height (integer, max 4294967295)

Responses
200

Sortition information for the burn block height

application/json

Array of sortition information objects from the burnchain

burn_block_hashstringRequired

The burnchain header hash of the block that triggered this event

Pattern: ^0x[0-9a-f]{64}$
burn_block_heightintegerRequired

The burn height of the block that triggered this event

burn_header_timestampintegerRequired

The burn block time of the sortition (Unix timestamp)

sortition_idstringRequired

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.

Pattern: ^0x[0-9a-f]{64}$
parent_sortition_idstringRequired

The parent of this burn block's Sortition ID

Pattern: ^0x[0-9a-f]{64}$
consensus_hashstringRequired

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.

Pattern: ^0x[0-9a-f]{40}$
was_sortitionbooleanRequired

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.

miner_pk_hash160string · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
stacks_parent_chstring · nullableOptional

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.

Pattern: ^0x[0-9a-f]{40}$
last_sortition_chstring · nullableOptional

If sortition occurred, this will be the consensus hash of the most recent sortition before this one.

Pattern: ^0x[0-9a-f]{40}$
committed_block_hashstring · nullableOptional

In Stacks 2.x, this is the winning block. In Stacks 3.x, this is the first block of the parent tenure.

Pattern: ^0x[0-9a-f]{64}$
vrf_seedstring · nullableOptional

This is the VRF seed generated by this sortition

Pattern: ^0x[0-9a-f]{64}$
get/v3/sortitions/burn_height/{height}
GET /v3/sortitions/burn_height/{height} HTTP/1.1
Host: localhost:20443
Accept: */*

[
  {
    "burn_block_hash": "0x00000000000000000002173857dc821186d17c6aee85e545a74625b6bc9c3656",
    "burn_block_height": 902499,
    "burn_header_timestamp": 1750747303,
    "sortition_id": "0x7ae9066d4c3cf4a5c5f5f89d30bd012317be1c10f520af6b8f35d169c3a424ba",
    "parent_sortition_id": "0x04d40e2ee2a9ee79c59c2e85b2f742c57bdeed5a2c32bb3bf659a77e892d8234",
    "consensus_hash": "0xe4a00a6c88722c7812ba0a2f780c42247c1d2d4c",
    "was_sortition": true,
    "miner_pk_hash160": "0x37e79a837b4071a1fc6c1b49208e7d2141a25905",
    "stacks_parent_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "last_sortition_ch": "0x7d3094294fabc1948d15fca4566ee2175a1e9808",
    "committed_block_hash": "0xdeb48fe0b0600092968fb7de1b6d586b111be7cd61bf52a666d14d41d6835ded",
    "vrf_seed": "0x49b75b824fcf765264d6ec91889a146bf52d46e2688f1b7ae7f7e5187765e99d"
  }
]

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

get
/v3/signer/{signer_pubkey}/{cycle_number}

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

Path parameters
signer_pubkeystringRequired

Hex-encoded compressed Secp256k1 public key of signer

Pattern: ^0[23][0-9a-f]{64}$
cycle_numberintegerRequired

Reward cycle number

Query parameters
tipstring · max: 64Optional

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)
Example: latestPattern: ^(latest|[0-9a-f]{64})?$
Responses
200

Number of blocks signed

application/json
blocks_signedintegerRequired

Number of blocks signed by this signer

get/v3/signer/{signer_pubkey}/{cycle_number}
GET /v3/signer/{signer_pubkey}/{cycle_number} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "blocks_signed": 7
}

Get stream of confirmed microblocks (Epoch 2.x)

get
/v2/microblocks/confirmed/{block_id}

Get microblocks that were confirmed by the given anchored block. The microblocks are returned as a binary stream of concatenated microblock data.

Path parameters
block_idstringRequired

Hex-encoded Stacks block ID (64 characters)

Pattern: ^[0-9a-f]{64}$
Query parameters
tipstring · max: 64Optional

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)
Example: latestPattern: ^(latest|[0-9a-f]{64})?$
Responses
200

Stream of confirmed microblocks

application/octet-stream
string · binaryOptional
get/v2/microblocks/confirmed/{block_id}
GET /v2/microblocks/confirmed/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Get a stream of microblocks beginning with the given microblock (Epoch 2.x).

get
/v2/microblocks/{microblock_id}
Path parameters
microblock_idstringRequired

Hex-encoded microblock hash (64 characters)

Pattern: ^[0-9a-f]{64}$
Responses
200

The microblock data

application/octet-stream
string · binaryOptional
get/v2/microblocks/{microblock_id}
GET /v2/microblocks/{microblock_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Get stream of unconfirmed microblocks (Epoch 2.x)

get
/v2/microblocks/unconfirmed/{block_id}/{seq}

Get unconfirmed microblocks starting from a specific sequence number. The microblocks are returned as a binary stream.

Path parameters
block_idstringRequired

Hex-encoded parent block ID (64 characters)

Pattern: ^[0-9a-f]{64}$
seqinteger · max: 65535Required

Starting sequence number (0-65535)

Responses
200

Stream of unconfirmed microblocks

application/octet-stream
string · binaryOptional
get/v2/microblocks/unconfirmed/{block_id}/{seq}
GET /v2/microblocks/unconfirmed/{block_id}/{seq} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Submit a microblock (Epoch 2.x)

post
/v2/microblocks

Submit a microblock to the node for validation and relay. The body must be the SIP-003 binary serialization of a Microblock and sent with Content-Type: application/octet-stream.

Body
string · binary · min: 1Optional
Responses
200

Index-block hash of the accepted microblock

application/json
stringOptional

32-byte block-header hash (hex)

Pattern: ^[0-9a-f]{64}$
post/v2/microblocks
POST /v2/microblocks HTTP/1.1
Host: localhost:20443
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"
3e4f5d6b7c8a9e0ff1122303445566778899aabbccddeeff0011223344556677

Get recent 2.x block headers

get
/v2/headers/{quantity}

Deprecated: This endpoint is deprecated since Nakamoto.** Stream (as a JSON array) up to quantity most recent anchored Stacks block headers. The result is ordered from the current tip backwards.

Path parameters
quantityinteger · min: 1 · max: 256Required

Number of headers to return (max 256)

Query parameters
tipstring · max: 64Optional

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)
Example: latestPattern: ^(latest|[0-9a-f]{64})?$
Responses
200

Array of block headers

application/json

JSON array returned by /v2/headers/{quantity}. Each entry is an ExtendedStacksHeader.

consensus_hashstringRequired

20-byte burn-chain consensus hash (hex, no 0x prefix)

Pattern: ^[0-9a-f]{40}$
headerstringRequired

Hex-encoded SIP-003 serialization of the Stacks block header

Pattern: ^[0-9a-f]+$
parent_block_idstringRequired

32-byte index-block ID of the parent Stacks block (hex)

Pattern: ^[0-9a-f]{64}$
get/v2/headers/{quantity}
GET /v2/headers/{quantity} HTTP/1.1
Host: localhost:20443
Accept: */*

[
  {
    "consensus_hash": "text",
    "header": "text",
    "parent_block_id": "text"
  }
]

Get Stacks 2.x block by ID

get
/v2/blocks/{block_id}

Get a specific Stacks 2.x era block by its block ID. This endpoint streams the block data from the filesystem storage where traditional Stacks blocks are stored as individual files.

Compatibility: Works with all Stacks 2.x blocks. For Nakamoto blocks (Stacks 3.x+), use /v3/blocks/{block_id}.

Path parameters
block_idstringRequired

Hex-encoded block ID (64 characters)

Pattern: ^[0-9a-f]{64}$
Responses
200

The block data

application/octet-stream
string · binaryOptional
get/v2/blocks/{block_id}
GET /v2/blocks/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Get tenure fork information

get
/v3/tenures/fork_info/{start}/{stop}

Get information about tenure forking between two consensus hashes. This is used to identify conflicting tenures in the Nakamoto consensus.

Path parameters
startstringRequired

Starting consensus hash (40 hexadecimal characters, without 0x prefix)

Pattern: ^[0-9a-f]{40}$
stopstringRequired

Stopping consensus hash (40 hexadecimal characters, without 0x prefix)

Pattern: ^[0-9a-f]{40}$
Responses
200

Ordered list of tenure fork events from stop back to (and including) start

application/json

Information about a tenure used for fork-detection.

burn_block_hashstringRequired

0x-prefixed 32-byte Bitcoin block hash that triggered the tenure event

Pattern: ^0x[0-9a-fA-F]{64}$
burn_block_heightinteger · uint64Required
sortition_idstringRequired

0x-prefixed 32-byte sortition ID (unique across PoX and Bitcoin forks)

Pattern: ^0x[0-9a-fA-F]{64}$
parent_sortition_idstringRequired

0x-prefixed sortition ID of the parent burn block

Pattern: ^0x[0-9a-fA-F]{64}$
consensus_hashstringRequired

0x-prefixed 20-byte consensus hash identifying the tenure

Pattern: ^0x[0-9a-fA-F]{40}$
was_sortitionbooleanRequired

Whether a winning sortition occurred at this burn block

first_block_minedstring · nullableOptional

0x-prefixed index-block ID of the first Stacks block in the tenure (if any)

Pattern: ^0x[0-9a-fA-F]{64}$
nakamoto_blocksstring · nullableOptional

0x-prefixed SIP-003 binary encoding of all Nakamoto blocks mined in this tenure

get/v3/tenures/fork_info/{start}/{stop}
GET /v3/tenures/fork_info/{start}/{stop} HTTP/1.1
Host: localhost:20443
Accept: */*

[
  {
    "burn_block_hash": "text",
    "burn_block_height": 1,
    "sortition_id": "text",
    "parent_sortition_id": "text",
    "consensus_hash": "text",
    "was_sortition": true,
    "first_block_mined": null,
    "nakamoto_blocks": null
  }
]

Get tenure tip

get
/v3/tenures/tip/{consensus_hash}

Get the tip block of a tenure identified by consensus hash.

Path parameters
consensus_hashstringRequired

Consensus hash (40 characters)

Pattern: ^[0-9a-f]{40}$
Responses
200

Tenure tip block information

application/json

JSON encoding of StacksBlockHeaderTypes returned by /v3/tenures/tip. Exactly one variant property will be present: either Epoch2 or Nakamoto.

or
get/v3/tenures/tip/{consensus_hash}
GET /v3/tenures/tip/{consensus_hash} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "Nakamoto": {
    "version": 0,
    "chain_length": 1827432,
    "burn_spent": 417647583456,
    "consensus_hash": "16707a8b6d73e69605f37eab9917d83806035de1",
    "parent_block_id": "28abb89ad887807b74b7b1493080450d3a2af8f4799422b9191c83b0da50d046",
    "tx_merkle_root": "2661ea27ab74956a517f0239044511575c99230f635f19747671604db83fc4d7",
    "state_index_root": "dcf3d34ff3e599088c28ae45b781efa00a79eeae49972b5a526b46502092ca91",
    "timestamp": 1750774427,
    "miner_signature": "01ee6027b7388d8e1d543f0df5ed97c8a84898867c1f77405979bfeb70e6ed4b7579e9f134d9b99eba65bf6099b7e6631296cb629ac5520d679f63336dcff4d105",
    "signer_signature": [
      "00fb29e01245c97dad8d42b599437b68932b85279dd316a5a0616373e41293a9cf7fe48962252245cc3de8fa8772c2b0b13e014b3a49504eaba333c5577a1b61e6",
      "01d5148eb9512e695c32ab9ad08e5057df87e050bcd1fa8c14adb9ae46510663c072c869671a946add8006948d058d8ce8e8405cbe0a615e322a3c5754df61fab5",
      "006078e054d9b53a12ac729718be42b073674c07fbd000d557fced6e6a4030339f141c95761e9d15ab9781a85819bce21885fc712e82b771284f5c04fb47a42c36",
      "0007432cee54e945eace6b34dc7d55d8fbbefd22f0fbb89e133ecd9005fddefaaf2a8ad6a56d3ff8cb8e1d7db6dbf33e096d4e3b8ed03c4811e264f4686619053f",
      "00c207d4709ae3dbd56fdfbb6e719a32332d183fa5bd8cd3dd290e0333d3dffcf115f4b5ca5bad338557601c975ea82f31787351f9ad375058fe5d8232b8b41fd5",
      "01daea2a0f838407b2120d6a96c58daa2dbf65af27d4b46e43f467183a4ed46d67387f66acb64c6e9cd41520f006bed6dbd333b5153f501affe7d77b4951029c95",
      "003ac14920d3c37669ec185feb4c18789030de1fdcc1d7cec50c8c525120d1266a2928c0d9b820501b61540e349fece714d5fccddc73eab74243bbe0d3d7c70550",
      "005a60b091799388a6af8a61d9322323979d296678603500e1113d9fd42379a3a9041ea1bc396fbe47635356dfccaf804b95c42e67db2bdfbc6395a0a9244bdd43",
      "0148442563da3fbec0b40b631f6f421091afb03b628b089500e2f9d11d9d1689680d61687fa01f7cce286e55068f600311dea652040693985efeeb4bd4942a0106",
      "00094f3caf8a332788dba5e586fc366e1622340e335565b15521d0d6819eca1ffe588caa77d57fdc92fae4eb4800244e723bb845d4eafbc58a35f7ce6e4fb83497",
      "007647c92930d4a9517884e3c2a8060315e0e63d011bbcf87f03c47e7b384689a605b3e4a52052e3c34f37987631dcc7ef3ca935f17737e6c0dcee416f2da9c94f",
      "016f1ff69b141a0d4aec4c437db2a683c99430594d61cdb3e69f846b8021850bf86906fed631fc0954418a26002dfda3263a4955d2f8ea093a6d6de0008b22e219",
      "00a1694159603297b076c90050d784724373bf75bcfaa24d03b68587a98a4ab97267ec95f8ded366e63792880e8f45aeb5b9c752759e080248563e5a035488e188",
      "00dbd71a18855f323e6a9dc7a558d2469ea53c0ec7cae20e6e9eccad97c4bd93083a04d4ca3888575f4818037876902fbe79adfecafdee2046d16936f8f3044777",
      "008a797e8322470a68a74f4e3d4562d4c3b8c41ab9a50e7a13056e708935c2cf6c03c90a882ba4cb6b720eb41c1f7ced8400b44330dcf245ef44a48e66d7589207",
      "007cc0376eceb67c305aa4ca3c1ce90d78462223dbf30b6e5152e44dc827604e480082057df1bac7e2f7b44c10d5d0d26d0b300498eb4d2bad1076b53a55399b33",
      "0188d81d2dd3a071a9e4d802ddccdf5469892e69cfa3419acda8405eceaed6eb6d368b16f324ed252ad6364d8027f227fc5946fc498adde55c8f2753c597b6d85f",
      "00eb8bbc18b9c07a9f48607b1b04d61673b5db1fad81ffcdc2049bd7f75217369a66d47f2366af006931d0800cf90a048f6722d726403bc876024ec64b4fa04f77",
      "00ce98a988c8de55cda5a424cab99cd51a63b426e28f7fd7b6d0c0048bf0a16c7078ef30044e708da87e9a61105c1560aef6f4ed2678602abdf7671795c5812e2b",
      "01fa10444944f58aa58fed5f023ae083254b13b579b25f5cbf2c79692bda52da7e4cce4c34bb1105a8cb79e437a35ed71588d0275bb45e541cc534b4102858ffbc",
      "00d4bc9429e665b872ff973cbad786d4d5bbac9a68e8d6f4c010ab047c6e67ca3f7a59370b5e141c819235fcf2231ef6b20b3abd6a65e17b8771fafe7b485c3dd7",
      "002262beb4bb0c7002f6d94ed4529a98ce186037a7466e8890e8bda6963b8859cd0ecb70a5f03f9fc5ba91d1cf661c1a588882c857dfa9d9334f1ca5979b1d3dd4",
      "01bcd2139b34bebce77298c067941255fa433394660dc61f9a8d1cdca0787e8709191fe86e4224a03b2ce36f2b7e15b8ecf79edc9ef46dfac27b1c6bed550b0f47",
      "0125f2fe864f413570a5b671b368b161f0ca645433ecc0666c46435a0a5f0ef4123ddad0b013f194b68cb685ac91f2e4fc76b39f09cd7f2af97fc4170fc319b20c",
      "00c2460dbde6bd6ee5d02ab58b4180736ec307e1971d9cd98d72b5e5cdd88c654374f6f3939d07076b9d7c51b73c72e946fad918a0654a206bb1ee6fad7baffb99",
      "01d4eef757e133bc7caebe505cbdd9443e55827ca9f46981fab6a2b504b33543801d62784103a8ec986fd74f5b486f01790d83eb8294ee972bf79ee8233cf94486",
      "018b182276517c5c086ed2908baa5e914946d60124ea2787330dc271f7dd9769de7537f6d93910446b732085aac70c4f3c8b7de68498fe350f115d7ad079f08bef",
      "019b5d53ad14817d2723bb263a1df4892e0a381b4673c9c33dffaf07855d3ee4ea540cc1d9ab7e990da5d35e8ab6dffcbac965f0b2b17ec96ea8bcbe7e467297f8",
      "0136c976917663b492b0838fad3db0592de1a6237140e5b3e16800569dcb76a85707c32134bcea23ff5b9be6ee9cd2b359f07741d83ed59de3196f49c4b4af2c60",
      "008f0d59da1833e60fb30984710882ac6159faf12773aa982bf3482f9519d9dd003d1d3e843e76d48cca90aece2bb44fb504d0bcc9aae0d8fd003aeed53dc4d52c",
      "01d77eaf449638d33c92f346c0464aef2a678458f96cd1a4cc1e8b53155b8952b16ff72e1bc942c29deaee40900f8b00ab3c6ba7f0e91700881edbf53ef095ae6b"
    ],
    "pox_treatment": "0e7d000001d0ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff1f"
  }
}

Get tenure tip with metadata

get
/v3/tenures/tip_metadata/{consensus_hash}

Get the tip block and associated metadata of a tenure identified by consensus hash.

Path parameters
consensus_hashstringRequired

Consensus hash (40 characters)

Pattern: ^[0-9a-f]{40}$
Responses
200

Tenure tip block information

application/json

JSON encoding of BlockHeaderWithMetadata returned by /v3/tenures/tip_metadata. Exactly one variant property will be present: either Epoch2 or Nakamoto.

burn_viewstringOptional

Hex-encoded bitcoin block hash

anchored_headerone ofRequired
or
get/v3/tenures/tip_metadata/{consensus_hash}
GET /v3/tenures/tip_metadata/{consensus_hash} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "burn_view": "text",
  "anchored_header": {
    "Epoch2": {
      "version": 1,
      "total_work": {
        "burn": 1,
        "work": 1
      },
      "proof": "text",
      "parent_block": "text",
      "parent_microblock": "text",
      "parent_microblock_sequence": 1,
      "tx_merkle_root": "text",
      "state_index_root": "text",
      "microblock_pubkey_hash": "text"
    }
  }
}

Upload a Nakamoto block

post
/v3/blocks/upload

Upload a Nakamoto block to the node for processing.

  • Body - must be the binary (SIP-003) serialization of a NakamotoBlock.

  • Authentication - only required when the query parameter broadcast=1 is supplied. In that case the caller must include an Authorization header.

Authorizations
authorizationstringOptional

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.

Query parameters
broadcaststring · enumOptional

If set to "1" the node will broadcast the uploaded block to peers. When present the request must include a valid Authorization header.

Possible values:
Body
string · binary · min: 1Optional

Binary SIP-003 encoding of a NakamotoBlock

Responses
200

Block upload result.

application/json
stacks_block_idstringOptional

The ID of the uploaded block

acceptedbooleanOptional

Whether the block was accepted

post/v3/blocks/upload
POST /v3/blocks/upload HTTP/1.1
Host: localhost:20443
authorization: YOUR_API_KEY
Content-Type: application/octet-stream
Accept: */*
Content-Length: 8

"binary"
{
  "stacks_block_id": "abc123...",
  "accepted": true
}

Replay mining of a block and returns its content

get
/v3/blocks/replay/{block_id}

Replay the mining of a block (no data is written in the MARF) and returns its content.

Authorizations
authorizationstringRequired

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.

Path parameters
block_idstringRequired

The block ID hash

Pattern: ^[0-9a-f]{64}$
Responses
200

Content of the replayed block

application/json
block_hashstringOptional

Hash of the block

Pattern: ^[0-9a-f]{64}$
block_idstringOptional

Block ID (index block hash)

Pattern: ^[0-9a-f]{64}$
block_heightinteger · uint64Optional

Height of the Stacks block

consensus_hashstringOptional

Consensus hash of the tenure

Pattern: ^[0-9a-f]{40}$
feesintegerOptional

total fees for the block

miner_signaturestringOptional

Uncompressed signature of the miner

Pattern: ^[0-9a-f]{130}$
parent_block_idstringOptional

Parent Block ID (index block hash)

Pattern: ^[0-9a-f]{64}$
signer_signaturestring[]Optional

Uncompressed signature of the signer

state_index_rootstringOptional

block state index root computed from the MARF (got from the original block)

Pattern: ^[0-9a-f]{64}$
timestampintegerOptional
tx_merkle_rootstringOptional

merkle_root of the included transactions

valid_merkle_rootbooleanOptional

does the merkle_root matches the chain block and the simulated one?

get/v3/blocks/replay/{block_id}
GET /v3/blocks/replay/{block_id} HTTP/1.1
Host: localhost:20443
authorization: YOUR_API_KEY
Accept: */*

{
  "block_hash": "732f57eefc4dbfb015c9988d9943c47273d25fbe039220d53f311b307609c83f",
  "block_id": "856f6b08f338164df7422f66337c8ce916b6b0301fcaa09de06c61cfb79e2a45",
  "block_height": 123,
  "consensus_hash": "33dffda027e2ca3aaf278855c59a8a0b2d2dd51f",
  "fees": 1,
  "miner_signature": "004b2878d7639060c4d183b1338447c06ceb0ad55424856c550a4c988401fdf8cf1fe6e8c05cc0e3ff8d4383590bf700cb5dd1a8bb3269f7125f6e0704b66eade8",
  "parent_block_id": "3ac36fc1acfc86ba80ea27cd26017c675f75bc07fb042814b72e74cd7d331503",
  "signer_signature": [
    "00d4e08331db614d18d7b5af53cf9bc03add9c7a2dcb6f0448721de7ea98f662cf7dc43ee73e14d18dfae3d3d349ff67e0fd773a446fb8c949c93ae4676f4d34bc",
    "01619c6e69bad5b43e11bae3eb4d4626e5cf19d595923b0b5d2053e8883a266b41315fdaefd1eca03c5c0580b0f7fd28053c3f34eb0a12220b61392d342f5afb0d",
    "0078fa352e0e4d2d94b25d4070ae24a819f268b2260a1e4d0d867415dbdc39e2cf75e57de69375794073e22a75873a5e1ca33ed96eadd8086415e934f697b78fdb",
    "00b8d9b0d0cdfabe3c65237801e714185777f60507c773fcd2a72ed00b9d4c59cb5ab96e0e8d545bd562b5ca3de6db1d3b9fccd8f41c3bfa7de3528deb1acd30d6"
  ],
  "state_index_root": "839b826290027e5b92de415495be7bab2eab2ad4e2f8c371a1a773ae552fedba",
  "timestamp": 1758284349,
  "transactions": [
    {
      "data": {
        "anchor_mode": "OnChainOnly",
        "auth": {
          "Standard": {
            "Singlesig": {
              "hash_mode": "P2PKH",
              "key_encoding": "Compressed",
              "nonce": 99,
              "signature": "01e29229b386e1f69ffd91e339c878246235ec1cd4771b42a7f45e1ed108643bc9417d43dd96a02c93314ef4cf5bcbcc5642df2e1f5a177333ff983c8719d80661",
              "signer": "2965a4e6e4226868fa3ae88b2b9bb9e937d77fba",
              "tx_fee": 1
            }
          }
        },
        "chain_id": 2147483648,
        "payload": {
          "TokenTransfer": [
            {
              "Standard": [
                26,
                [
                  189,
                  65,
                  200,
                  147,
                  188,
                  192,
                  157,
                  152,
                  224,
                  211,
                  77,
                  255,
                  135,
                  190,
                  175,
                  153,
                  88,
                  51,
                  140,
                  222
                ]
              ]
            },
            1,
            "00000000000000000000000000000000000000000000000000000000000000000000"
          ]
        },
        "post_condition_mode": "Deny",
        "post_conditions": [],
        "version": "Testnet"
      },
      "events": [
        {
          "committed": true,
          "event_index": 0,
          "stx_transfer_event": {
            "amount": "1",
            "memo": "00000000000000000000000000000000000000000000000000000000000000000000",
            "recipient": "ST2YM3J4KQK09V670TD6ZZ1XYNYCNGCWCVTASN5VM",
            "sender": "STMPB976WGH6GT7T7BM8PAWVQ7MKFNVZQAXS4BFS"
          },
          "txid": "0xf14dd7dec56405fd7dac69c3080fb569fae4c49c591f9ad0e5cf5c797add9005",
          "type": "stx_transfer_event"
        }
      ],
      "execution_cost": {
        "read_count": 0,
        "read_length": 0,
        "runtime": 0,
        "write_count": 0,
        "write_length": 0
      },
      "hex": "808000000004002965a4e6e4226868fa3ae88b2b9bb9e937d77fba000000000000006300000000000000010001e29229b386e1f69ffd91e339c878246235ec1cd4771b42a7f45e1ed108643bc9417d43dd96a02c93314ef4cf5bcbcc5642df2e1f5a177333ff983c8719d8066101020000000000051abd41c893bcc09d98e0d34dff87beaf9958338cde000000000000000100000000000000000000000000000000000000000000000000000000000000000000",
      "result": {
        "Response": {
          "committed": true,
          "data": {
            "Bool": true
          }
        }
      },
      "result_hex": "0x0703",
      "post_condition_aborted": false,
      "stx_burned": 0,
      "tx_index": 0,
      "txid": "f14dd7dec56405fd7dac69c3080fb569fae4c49c591f9ad0e5cf5c797add9005"
    }
  ],
  "tx_merkle_root": "a68e3c76471d9e66b71a14165c4c9a2b980c51efb5b313425cffcef7172d6080",
  "valid_merkle_root": true
}

Simulate mining of a block with the specified transactions and returns its content

get
/v3/blocks/simulate/{block_id}

Simulate the mining of a block (no data is written in the MARF) with specified transactions and returns its content.

Authorizations
authorizationstringRequired

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.

Path parameters
block_idstringRequired

The block ID hash

Pattern: ^[0-9a-f]{64}$
Body
transactions_hexstring[]Optional

SIP-003-encoded Transaction in hex format

Responses
200

Content of the simulated block

application/json
block_hashstringOptional

Hash of the block

Pattern: ^[0-9a-f]{64}$
block_idstringOptional

Block ID (index block hash)

Pattern: ^[0-9a-f]{64}$
block_heightinteger · uint64Optional

Height of the Stacks block

consensus_hashstringOptional

Consensus hash of the tenure

Pattern: ^[0-9a-f]{40}$
feesintegerOptional

total fees for the block

miner_signaturestringOptional

Uncompressed signature of the miner

Pattern: ^[0-9a-f]{130}$
parent_block_idstringOptional

Parent Block ID (index block hash)

Pattern: ^[0-9a-f]{64}$
signer_signaturestring[]Optional

Uncompressed signature of the signer

state_index_rootstringOptional

block state index root computed from the MARF (got from the original block)

Pattern: ^[0-9a-f]{64}$
timestampintegerOptional
tx_merkle_rootstringOptional

merkle_root of the included transactions

valid_merkle_rootbooleanOptional

does the merkle_root matches the chain block and the simulated one?

get/v3/blocks/simulate/{block_id}
GET /v3/blocks/simulate/{block_id} HTTP/1.1
Host: localhost:20443
authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "transactions_hex": [
    "text"
  ],
  "mint": [
    {
      "principal": "text",
      "amount": 1
    }
  ]
}
{
  "summary": "Block replay response",
  "value": {
    "block_hash": "732f57eefc4dbfb015c9988d9943c47273d25fbe039220d53f311b307609c83f",
    "block_id": "856f6b08f338164df7422f66337c8ce916b6b0301fcaa09de06c61cfb79e2a45",
    "block_height": 123,
    "consensus_hash": "33dffda027e2ca3aaf278855c59a8a0b2d2dd51f",
    "fees": 1,
    "miner_signature": "004b2878d7639060c4d183b1338447c06ceb0ad55424856c550a4c988401fdf8cf1fe6e8c05cc0e3ff8d4383590bf700cb5dd1a8bb3269f7125f6e0704b66eade8",
    "parent_block_id": "3ac36fc1acfc86ba80ea27cd26017c675f75bc07fb042814b72e74cd7d331503",
    "signer_signature": [
      "00d4e08331db614d18d7b5af53cf9bc03add9c7a2dcb6f0448721de7ea98f662cf7dc43ee73e14d18dfae3d3d349ff67e0fd773a446fb8c949c93ae4676f4d34bc",
      "01619c6e69bad5b43e11bae3eb4d4626e5cf19d595923b0b5d2053e8883a266b41315fdaefd1eca03c5c0580b0f7fd28053c3f34eb0a12220b61392d342f5afb0d",
      "0078fa352e0e4d2d94b25d4070ae24a819f268b2260a1e4d0d867415dbdc39e2cf75e57de69375794073e22a75873a5e1ca33ed96eadd8086415e934f697b78fdb",
      "00b8d9b0d0cdfabe3c65237801e714185777f60507c773fcd2a72ed00b9d4c59cb5ab96e0e8d545bd562b5ca3de6db1d3b9fccd8f41c3bfa7de3528deb1acd30d6"
    ],
    "state_index_root": "839b826290027e5b92de415495be7bab2eab2ad4e2f8c371a1a773ae552fedba",
    "timestamp": 1758284349,
    "transactions": [
      {
        "data": {
          "anchor_mode": "OnChainOnly",
          "auth": {
            "Standard": {
              "Singlesig": {
                "hash_mode": "P2PKH",
                "key_encoding": "Compressed",
                "nonce": 99,
                "signature": "01e29229b386e1f69ffd91e339c878246235ec1cd4771b42a7f45e1ed108643bc9417d43dd96a02c93314ef4cf5bcbcc5642df2e1f5a177333ff983c8719d80661",
                "signer": "2965a4e6e4226868fa3ae88b2b9bb9e937d77fba",
                "tx_fee": 1
              }
            }
          },
          "chain_id": 2147483648,
          "payload": {
            "TokenTransfer": [
              {
                "Standard": [
                  26,
                  [
                    189,
                    65,
                    200,
                    147,
                    188,
                    192,
                    157,
                    152,
                    224,
                    211,
                    77,
                    255,
                    135,
                    190,
                    175,
                    153,
                    88,
                    51,
                    140,
                    222
                  ]
                ]
              },
              1,
              "00000000000000000000000000000000000000000000000000000000000000000000"
            ]
          },
          "post_condition_mode": "Deny",
          "post_conditions": [],
          "version": "Testnet"
        },
        "events": [
          {
            "committed": true,
            "event_index": 0,
            "stx_transfer_event": {
              "amount": "1",
              "memo": "00000000000000000000000000000000000000000000000000000000000000000000",
              "recipient": "ST2YM3J4KQK09V670TD6ZZ1XYNYCNGCWCVTASN5VM",
              "sender": "STMPB976WGH6GT7T7BM8PAWVQ7MKFNVZQAXS4BFS"
            },
            "txid": "0xf14dd7dec56405fd7dac69c3080fb569fae4c49c591f9ad0e5cf5c797add9005",
            "type": "stx_transfer_event"
          }
        ],
        "execution_cost": {
          "read_count": 0,
          "read_length": 0,
          "runtime": 0,
          "write_count": 0,
          "write_length": 0
        },
        "hex": "808000000004002965a4e6e4226868fa3ae88b2b9bb9e937d77fba000000000000006300000000000000010001e29229b386e1f69ffd91e339c878246235ec1cd4771b42a7f45e1ed108643bc9417d43dd96a02c93314ef4cf5bcbcc5642df2e1f5a177333ff983c8719d8066101020000000000051abd41c893bcc09d98e0d34dff87beaf9958338cde000000000000000100000000000000000000000000000000000000000000000000000000000000000000",
        "result": {
          "Response": {
            "committed": true,
            "data": {
              "Bool": true
            }
          }
        },
        "result_hex": "0x0703",
        "post_condition_aborted": false,
        "stx_burned": 0,
        "tx_index": 0,
        "txid": "f14dd7dec56405fd7dac69c3080fb569fae4c49c591f9ad0e5cf5c797add9005"
      }
    ],
    "tx_merkle_root": "a68e3c76471d9e66b71a14165c4c9a2b980c51efb5b313425cffcef7172d6080",
    "valid_merkle_root": true
  }
}
PreviousMining
NextSigners

Last updated

Was this helpful?