Hiro

Hiro Blocks API

The Blocks API from Hiro — 37 operation(s) for blocks.

GitHub OpenAPI

Operations 37

GET /signer-metrics/v1/blocks Aggregated signer information for most recent blocks #
GET /signer-metrics/v1/blocks/{height_or_hash} Aggregated signer information for a block #
GET /extended/v1/block/ Get recent blocks #
GET /extended/v1/block/by_height/{height} Get block by height #
GET /extended/v1/block/by_burn_block_height/{burn_block_height} Get block by burnchain height #
GET /extended/v1/block/{hash} Get block by hash #
GET /extended/v1/block/by_burn_block_hash/{burn_block_hash} Get block by burnchain block hash #
GET /extended/v2/blocks/ Get blocks #
GET /extended/v2/blocks/average-times Get average block times #
GET /extended/v2/blocks/{height_or_hash} Get block #
GET /extended/v2/blocks/{height_or_hash}/signer-signatures Get signer signatures for block #
GET /extended/v2/block-tenures/{tenure_height}/blocks Get blocks by tenure #
GET /v3/blocks/{block_id} Get Nakamoto block by ID #
GET /v3/blocks/height/{block_height} Fetch a Nakamoto block by its height and optional tip #
GET /v3/tenures/info Fetch metadata about the ongoing Nakamoto tenure #
GET /v3/tenures/{block_id} Fetch a sequence of Nakamoto blocks in a tenure #
GET /v3/tenures/blocks/{consensus_hash} Get the list of Stacks blocks in a tenure #
GET /v3/tenures/blocks/hash/{burnchain_block_hash} Get the list of Nakamoto Stacks blocks in a tenure given Bitcoin block hash #
GET /v3/tenures/blocks/height/{burnchain_block_height} Get the list of Nakamoto Stacks blocks in a tenure given Bitcoin block height #
GET /v3/sortitions Get latest sortition information #
GET /v3/sortitions/latest_and_last Get latest and last winning sortitions #
GET /v3/sortitions/consensus/{consensus_hash} Get sortition by consensus hash #
GET /v3/sortitions/burn/{burn_header_hash} Get sortition by burn header hash #
GET /v3/sortitions/burn_height/{height} Get sortition by burn block height #
GET /v3/signer/{signer_pubkey}/{cycle_number} Get number of blocks signed by signer during a given reward cycle #
GET /v2/microblocks/confirmed/{block_id} Get stream of confirmed microblocks (Epoch 2.x) #
GET /v2/microblocks/{microblock_id} Get a stream of microblocks beginning with the given microblock (Epoch 2.x) #
GET /v2/microblocks/unconfirmed/{block_id}/{seq} Get stream of unconfirmed microblocks (Epoch 2.x) #
POST /v2/microblocks Submit a microblock (Epoch 2.x) #
GET /v2/headers/{quantity} Get recent 2.x block headers #
GET /v2/blocks/{block_id} Get Stacks 2.x block by ID #
GET /v3/tenures/fork_info/{start}/{stop} Get tenure fork information #
GET /v3/tenures/tip/{consensus_hash} Get tenure tip #
GET /v3/tenures/tip_metadata/{consensus_hash} Get tenure tip with metadata #
POST /v3/blocks/upload Upload a Nakamoto block #
GET /v3/blocks/replay/{block_id} Replay mining of a block and returns its content #
GET /v3/blocks/simulate/{block_id} Simulate mining of a block with the specified transactions and returns its… #

Documentation

📖
Documentation
https://docs.hiro.so/stacks/api
📖
Documentation
https://docs.hiro.so/stacks/rpc-api
📖
Documentation
https://docs.hiro.so/stacks/token-metadata-api
📖
Documentation
https://docs.hiro.so/stacks/signer-metrics-api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/hiro/refs/heads/main/openapi/hiro-blocks-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hiro-blocks-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hiro-blocks-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hiro Blocks API
  version: '1.0'
  description: 'Operations tagged Blocks across 3 of this provider''s published API definitions: hiro-signer-metrics-api-openapi.yaml, hiro-stacks-blockchain-api-openapi.yaml, hiro-stacks-node-rpc-api-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.hiro.so/
  description: mainnet
- url: https://api.testnet.hiro.so/
  description: testnet
- url: http://localhost:20443
  description: Local Stacks Node
tags:


# --- truncated at 32 KB (104 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/hiro/refs/heads/main/openapi/hiro-blocks-api-openapi.yml