Hiro Stacking Rewards API
Read-only endpoints to obtain Stacking reward details
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/hiro-stacking-rewards-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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Stacks Blockchain Stacking Rewards API
description: "Welcome to the API reference overview for the [Stacks Blockchain API](https://docs.hiro.so/stacks-blockchain-api).\n\n [Download Postman collection](https://hirosystems.github.io/stacks-blockchain-api/collection.json)"
version: v8.14.2
servers:
- url: https://api.hiro.so/
description: mainnet
tags:
- name: Stacking Rewards
description: Read-only endpoints to obtain Stacking reward details
externalDocs:
description: Stacks Documentation - Stacking
url: https://docs.stacks.co/block-production/stacking
paths:
/extended/v1/burnchain/reward_slot_holders:
get:
operationId: get_burnchain_reward_slot_holders
summary: Get recent reward slot holders
tags:
- Stacking Rewards
description: Retrieves a list of the Bitcoin addresses that would validly receive Proof-of-Transfer commitments.
parameters:
- schema:
minimum: 0
default: 96
maximum: 250
title: Limit
type: integer
in: query
name: limit
required: false
description: max number of items to fetch
- schema:
minimum: 0
default: 0
title: Offset
type: integer
in: query
name: offset
required: false
description: Result offset
responses:
'200':
description: Default Response
content:
application/json:
schema:
title: List of burnchain reward recipients and amounts
type: object
properties:
limit:
type: integer
example: 20
offset:
type: integer
example: 0
total:
type: integer
example: 1
results:
type: array
items:
title: BurnchainRewardSlotHolder
description: Reward slot holder on the burnchain
type: object
properties:
canonical:
description: Set to `true` if block corresponds to the canonical burchchain tip
type: boolean
burn_block_hash:
description: The hash representing the burnchain block
type: string
burn_block_height:
description: Height of the burnchain block
type: integer
address:
description: The recipient address that validly received PoX commitments, in the format native to the burnchain (e.g. B58 encoded for Bitcoin)
type: string
slot_index:
description: The index position of the reward entry, useful for ordering when there's more than one slot per burnchain block
type: integer
required:
- canonical
- burn_block_hash
- burn_block_height
- address
- slot_index
required:
- limit
- offset
- total
- results
4XX:
description: Default Response
content:
application/json:
schema:
title: Error Response
additionalProperties: true
type: object
properties:
error:
type: string
message:
type: string
required:
- error
/extended/v1/burnchain/reward_slot_holders/{address}:
get:
operationId: get_burnchain_reward_slot_holders_by_address
summary: Get recent reward slot holder entries for the given address
tags:
- Stacking Rewards
description: Retrieves a list of the Bitcoin addresses that would validly receive Proof-of-Transfer commitments for a given reward slot holder recipient address.
parameters:
- schema:
minimum: 0
default: 96
maximum: 250
title: Limit
type: integer
in: query
name: limit
required: false
description: Results per page
- schema:
minimum: 0
default: 0
title: Offset
type: integer
in: query
name: offset
required: false
description: Result offset
- schema:
type: string
example: 36hQtSEXBMevo5chpxhfAGiCTSC34QKgda
in: path
name: address
required: true
description: Reward slot holder recipient address. Should either be in the native burnchain's format (e.g. B58 for Bitcoin), or if a STX principal address is provided it will be encoded as into the equivalent burnchain format
responses:
'200':
description: List of burnchain reward recipients and amounts
content:
application/json:
schema:
title: BurnchainRewardSlotHolderListResponse
description: List of burnchain reward recipients and amounts
type: object
properties:
limit:
type: integer
example: 20
offset:
type: integer
example: 0
total:
type: integer
example: 1
results:
type: array
items:
title: BurnchainRewardSlotHolder
description: Reward slot holder on the burnchain
type: object
properties:
canonical:
description: Set to `true` if block corresponds to the canonical burchchain tip
type: boolean
burn_block_hash:
description: The hash representing the burnchain block
type: string
burn_block_height:
description: Height of the burnchain block
type: integer
address:
description: The recipient address that validly received PoX commitments, in the format native to the burnchain (e.g. B58 encoded for Bitcoin)
type: string
slot_index:
description: The index position of the reward entry, useful for ordering when there's more than one slot per burnchain block
type: integer
required:
- canonical
- burn_block_hash
- burn_block_height
- address
- slot_index
required:
- limit
- offset
- total
- results
4XX:
description: Default Response
content:
application/json:
schema:
title: Error Response
additionalProperties: true
type: object
properties:
error:
type: string
message:
type: string
required:
- error
/extended/v1/burnchain/rewards:
get:
operationId: get_burnchain_reward_list
summary: Get recent burnchain reward recipients
tags:
- Stacking Rewards
description: Retrieves a list of recent burnchain (e.g. Bitcoin) reward recipients with the associated amounts and block info
parameters:
- schema:
minimum: 0
default: 96
maximum: 250
title: Limit
type: integer
in: query
name: limit
required: false
description: Results per page
- schema:
minimum: 0
default: 0
title: Offset
type: integer
in: query
name: offset
required: false
description: Result offset
responses:
'200':
description: List of burnchain reward recipients and amounts
content:
application/json:
schema:
description: List of burnchain reward recipients and amounts
type: object
properties:
limit:
type: integer
offset:
type: integer
results:
type: array
items:
title: BurnchainReward
description: Reward payment made on the burnchain
type: object
properties:
canonical:
description: Set to `true` if block corresponds to the canonical burchchain tip
type: boolean
burn_block_hash:
description: The hash representing the burnchain block
type: string
burn_block_height:
description: Height of the burnchain block
type: integer
burn_amount:
description: The total amount of burnchain tokens burned for this burnchain block, in the smallest unit (e.g. satoshis for Bitcoin)
type: string
reward_recipient:
description: The recipient address that received the burnchain rewards, in the format native to the burnchain (e.g. B58 encoded for Bitcoin)
type: string
reward_amount:
description: The amount of burnchain tokens rewarded to the recipient, in the smallest unit (e.g. satoshis for Bitcoin)
type: string
reward_index:
description: The index position of the reward entry, useful for ordering when there's more than one recipient per burnchain block
type: integer
required:
- canonical
- burn_block_hash
- burn_block_height
- burn_amount
- reward_recipient
- reward_amount
- reward_index
required:
- limit
- offset
- results
4XX:
description: Default Response
content:
application/json:
schema:
title: Error Response
additionalProperties: true
type: object
properties:
error:
type: string
message:
type: string
required:
- error
/extended/v1/burnchain/rewards/{address}:
get:
operationId: get_burnchain_reward_list_by_address
summary: Get recent burnchain reward for the given recipient
tags:
- Stacking Rewards
description: Retrieves a list of recent burnchain (e.g. Bitcoin) rewards for the given recipient with the associated amounts and block info
parameters:
- schema:
minimum: 0
default: 96
maximum: 250
title: Limit
type: integer
in: query
name: limit
required: false
description: Results per page
- schema:
minimum: 0
default: 0
title: Offset
type: integer
in: query
name: offset
required: false
description: Result offset
- schema:
type: string
example: 36hQtSEXBMevo5chpxhfAGiCTSC34QKgda
in: path
name: address
required: true
description: Reward recipient address. Should either be in the native burnchain's format (e.g. B58 for Bitcoin), or if a STX principal address is provided it will be encoded as into the equivalent burnchain format
responses:
'200':
description: List of burnchain reward recipients and amounts
content:
application/json:
schema:
description: List of burnchain reward recipients and amounts
type: object
properties:
limit:
type: integer
offset:
type: integer
results:
type: array
items:
title: BurnchainReward
description: Reward payment made on the burnchain
type: object
properties:
canonical:
description: Set to `true` if block corresponds to the canonical burchchain tip
type: boolean
burn_block_hash:
description: The hash representing the burnchain block
type: string
burn_block_height:
description: Height of the burnchain block
type: integer
burn_amount:
description: The total amount of burnchain tokens burned for this burnchain block, in the smallest unit (e.g. satoshis for Bitcoin)
type: string
reward_recipient:
description: The recipient address that received the burnchain rewards, in the format native to the burnchain (e.g. B58 encoded for Bitcoin)
type: string
reward_amount:
description: The amount of burnchain tokens rewarded to the recipient, in the smallest unit (e.g. satoshis for Bitcoin)
type: string
reward_index:
description: The index position of the reward entry, useful for ordering when there's more than one recipient per burnchain block
type: integer
required:
- canonical
- burn_block_hash
- burn_block_height
- burn_amount
- reward_recipient
- reward_amount
- reward_index
required:
- limit
- offset
- results
4XX:
description: Default Response
content:
application/json:
schema:
title: Error Response
additionalProperties: true
type: object
properties:
error:
type: string
message:
type: string
required:
- error
/extended/v1/burnchain/rewards/{address}/total:
get:
operationId: get_burnchain_rewards_total_by_address
summary: Get total burnchain rewards for the given recipient
tags:
- Stacking Rewards
description: Retrieves the total burnchain (e.g. Bitcoin) rewards for a given recipient `address`
parameters:
- schema:
type: string
example: 36hQtSEXBMevo5chpxhfAGiCTSC34QKgda
in: path
name: address
required: true
description: Reward recipient address. Should either be in the native burnchain's format (e.g. B58 for Bitcoin), or if a STX principal address is provided it will be encoded as into the equivalent burnchain format
responses:
'200':
description: Total burnchain rewards made to a recipient
content:
application/json:
schema:
title: BurnchainRewardsTotal
description: Total burnchain rewards made to a recipient
type: object
properties:
reward_recipient:
description: The recipient address that received the burnchain rewards, in the format native to the burnchain (e.g. B58 encoded for Bitcoin)
type: string
reward_amount:
description: The total amount of burnchain tokens rewarded to the recipient, in the smallest unit (e.g. satoshis for Bitcoin)
type: string
required:
- reward_recipient
- reward_amount
4XX:
description: Default Response
content:
application/json:
schema:
title: Error Response
additionalProperties: true
type: object
properties:
error:
type: string
message:
type: string
required:
- error
externalDocs:
url: https://github.com/hirosystems/stacks-blockchain-api
description: Source Repository