Stacking RewardsGet recent reward slot holder entries

Get recent reward slot holder entries

Retrieves a list of the Bitcoin addresses that would validly receive Proof-of-Transfer commitments for a given reward slot holder recipient address.

GET

/extended/v1/burnchain/reward_slot_holders/{address}

Retrieves a list of the Bitcoin addresses that would validly receive Proof-of-Transfer commitments for a given reward slot holder recipient address.

Path parameters

address
Required
string

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.

Example: "36hQtSEXBMevo5chpxhfAGiCTSC34QKgda"

Query parameters

limitinteger

Max number of items to fetch

offsetinteger

Index of the first items to fetch

Example: 42000
Status codeDescription
200List of burnchain reward recipients and amounts
Terminal
curl -X GET "https://api.mainnet.hiro.so/extended/v1/burnchain/reward_slot_holders/36hQtSEXBMevo5chpxhfAGiCTSC34QKgda"

GET request that returns reward slot holders

Example response
{
  "limit": 30,
  "offset": 0,
  "total": 0,
  "results": [
    {
      "canonical": true,
      "burn_block_hash": "string",
      "burn_block_height": 0,
      "address": "string",
      "slot_index": 0
    }
  ]
}

Get recent reward slot holders

Get recent burnchain reward recipients