Blocks

Operations for retrieving block and microblock data.

Get Nakamoto block by ID

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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_idstringRequired

The block"s ID hash

Responses

200

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

application/octet-stream

Responsestring · binary

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/blocks/{block_id}

HTTPcURLJavaScriptPython

GET /v3/blocks/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Fetch a Nakamoto block by its height and optional tip

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/v3/blocks/height/{block_height}

Fetch a Nakamoto block by its height and optional tip.

Path parameters

block_heightintegerRequired

The block's height

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

Responsestring · binary

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/blocks/height/{block_height}

HTTPcURLJavaScriptPython

GET /v3/blocks/height/{block_height} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Fetch metadata about the ongoing Nakamoto tenure

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

get

/v3/tenures/info

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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_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/octet-stream

Responsestring · binary

get

/v3/tenures/{block_id}

HTTPcURLJavaScriptPython

GET /v3/tenures/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*

200

SIP-003-encoded Nakamoto blocks, concatenated together

binary

Get the list of Stacks blocks in a tenure

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/tenures/blocks/{consensus_hash}

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

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

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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_heightintegerRequired

The Bitcoin block height of the tenure to query

Responses

200

List of Stacks blocks in the tenure

application/json

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

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

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/sortitions

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/sortitions/latest_and_last

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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: ^(0x)?[0-9a-f]{40}$

Responses

200

Sortition information for the consensus hash

application/json

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/sortitions/consensus/{consensus_hash}

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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: ^(0x)?[0-9a-f]{64}$

Responses

200

Sortition information for the burn header hash

application/json

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/sortitions/burn/{burn_header_hash}

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

heightintegerRequired

Burn block height (integer)

Responses

200

Sortition information for the burn block height

application/json

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/sortitions/burn_height/{height}

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

get

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

HTTPcURLJavaScriptPython

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

200

Number of blocks signed

{
  "blocks_signed": 7
}

Get stream of confirmed microblocks (Epoch 2.x)

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

Responsestring · binary

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v2/microblocks/confirmed/{block_id}

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

Responsestring · binary

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v2/microblocks/{microblock_id}

HTTPcURLJavaScriptPython

GET /v2/microblocks/{microblock_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Get stream of unconfirmed microblocks (Epoch 2.x)

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

Responsestring · binary

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

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

HTTPcURLJavaScriptPython

GET /v2/microblocks/unconfirmed/{block_id}/{seq} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Submit a microblock (Epoch 2.x)

post

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

application/octet-stream

string · binaryOptional

Responses

200

Index-block hash of the accepted microblock

application/json

Responsestring

32-byte block-header hash (hex)

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

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

post

/v2/microblocks

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v2/headers/{quantity}

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

Responsestring · binary

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v2/blocks/{block_id}

HTTPcURLJavaScriptPython

GET /v2/blocks/{block_id} HTTP/1.1
Host: localhost:20443
Accept: */*

binary

Get tenure fork information

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

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

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

Responseone of

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

or

400

Bad request

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/tenures/tip/{consensus_hash}

HTTPcURLJavaScriptPython

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"
  }
}

Upload a Nakamoto block

post

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/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

rpcAuth

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

application/octet-stream

string · binaryOptional

Binary SIP-003 encoding of a NakamotoBlock

Responses

200

Block upload result.

application/json

400

Bad request

text/plain

401

Unauthorized. Invalid or missing authentication token.

text/plain

500

Internal Server Error

text/plain

post

/v3/blocks/upload

HTTPcURLJavaScriptPython

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

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/v3/blocks/replay/{block_id}

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

Authorizations

rpcAuth

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

400

Bad request

text/plain

401

Unauthorized. Invalid or missing authentication token.

text/plain

404

Not found

text/plain

500

Internal Server Error

text/plain

get

/v3/blocks/replay/{block_id}

HTTPcURLJavaScriptPython

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
}