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

addressstring

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

Query Parameters

limit?Limit

Results per page

Default96

Rangevalue <= 250

offset?Offset

Result offset

Default0

Response Body

List of burnchain reward recipients and amounts

TypeScript Definitions

Use the response body type in TypeScript.

limitinteger

offsetinteger

resultsarray<BurnchainReward>

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring

message?string

[key: string]any

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

fetch("https://api.hiro.so//extended/v1/burnchain/rewards/36hQtSEXBMevo5chpxhfAGiCTSC34QKgda?limit=96&offset=0")

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//extended/v1/burnchain/rewards/36hQtSEXBMevo5chpxhfAGiCTSC34QKgda?limit=96&offset=0"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

import requests

url = "https://api.hiro.so//extended/v1/burnchain/rewards/36hQtSEXBMevo5chpxhfAGiCTSC34QKgda?limit=96&offset=0"

response = requests.request("GET", url)

print(response.text)

{
  "limit": 0,
  "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
    }
  ]
}

{
  "error": "string",
  "message": "string"
}