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}

Get recent reward slot holder entries for the given 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
/extended/v1/burnchain/reward_slot_holders/{address}

curl -X GET "https://api.mainnet.hiro.so/extended/v1/burnchain/reward_slot_holders/36hQtSEXBMevo5chpxhfAGiCTSC34QKgda?limit=0&offset=42000"

GET request that returns reward slot holders

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