Get recent burnchain reward for the given recipient

Retrieves a list of recent burnchain (e.g. Bitcoin) rewards for the given recipient with the associated amounts and block info.


GET
/extended/v1/burnchain/rewards/{address}

Get recent burnchain reward for the given recipient

Retrieves a list of recent burnchain (e.g. Bitcoin) rewards for the given recipient with the associated amounts and block info

Path Parameters

address
Required
string

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

Example: "36hQtSEXBMevo5chpxhfAGiCTSC34QKgda"

Query Parameters

limitinteger

max number of rewards to fetch

offsetinteger

index of first rewards to fetch

Example: 42000
Status codeDescription
200List of burnchain reward recipients and amounts
/extended/v1/burnchain/rewards/{address}

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

GET request that returns blocks

{
"limit": 30,
"offset": 0,
"results": [
{
"canonical": true,
"burn_block_hash": "string",
"burn_block_height": 0,
"burn_amount": "string",
"reward_recipient": "string",
"reward_amount": "string",
"reward_index": 0
}
]
}