Skip to main content

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

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

Query Parameters

limit

integer

max number of rewards to fetch

offset

integer

index of first rewards to fetch

Responses

200

List of burnchain reward recipients and amounts

Schema

OPTIONAL

limit

integer

Possible values: value ≤ 30

The number of burnchain rewards to return

offset

integer

The number to burnchain rewards to skip (starting at 0)

results

object[]

canonical

boolean

Set to true if block corresponds to the canonical burchchain tip

burn_block_hash

string

The hash representing the burnchain block

burn_block_height

integer

Height of the burnchain block

burn_amount

string

The total amount of burnchain tokens burned for this burnchain block, in the smallest unit (e.g. satoshis for Bitcoin)

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 amount of burnchain tokens rewarded to the recipient, in the smallest unit (e.g. satoshis for Bitcoin)

reward_index

integer

The index position of the reward entry, useful for ordering when there's more than one recipient per burnchain block