Skip to main content

Get total burnchain rewards for the given recipient

Retrieves the total burnchain (e.g. Bitcoin) rewards for a given recipient address

Path Parameters
address string REQUIRED

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
Responses
200

List of burnchain reward recipients and amounts

Schema OPTIONAL
reward_recipient string

The recipient address that received the burnchain rewards, in the format native to the burnchain (e.g. B58 encoded for Bitcoin)

reward_amount string

The total amount of burnchain tokens rewarded to the recipient, in the smallest unit (e.g. satoshis for Bitcoin)

get_burnchain_rewards_total_by_address
GET /extended/v1/burnchain/rewards/:address/total
address — path
https://api.mainnet.hiro.so
curl -L 'https://api.mainnet.hiro.so/extended/v1/burnchain/rewards/:address/total' \
-H 'Accept: application/json'