List historical rewards

Lists historical rewards on the Primary Network for the supplied addresses.

Authorizations

x-glacier-api-key

string

headerrequired

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.

Path Parameters

network

enum<string>

required

Either mainnet or testnet/fuji.

Available options:

mainnet,

fuji,

testnet,

devnet

Query Parameters

addresses

string

A comma separated list of X-Chain or P-Chain wallet addresses, starting with "avax"/"fuji", "P-avax"/"P-fuji" or "X-avax"/"X-fuji". Optional, but at least one of addresses or nodeIds is required.

pageToken

string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize

integer

default: 10

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Required range: 1 < x < 100

nodeIds

string

A comma separated list of node ids to filter by. Optional, but at least one of addresses or nodeIds is required.

sortOrder

enum<string>

The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the sortBy query parameter, if provided.

Available options:

asc,

desc

currency

enum<string>

The currency that return values should use. Defaults to USD.

Available options:

usd,

eur,

aud,

cad,

chf,

clp,

cny,

czk,

dkk,

gbp,

hkd,

huf,

jpy,

nzd

Response

200 - application/json

historicalRewards

object[]

required

Show child attributes

historicalRewards.addresses

string[]

required

An array of P-Chain wallet addresses.

historicalRewards.txHash

string

required

historicalRewards.amountStaked

string

required

historicalRewards.nodeId

string

required

historicalRewards.startTimestamp

number

required

historicalRewards.endTimestamp

number

required

historicalRewards.rewardType

enum<string>

required

Available options:

VALIDATOR,

DELEGATOR,

VALIDATOR_FEE

historicalRewards.utxoId

string

required

historicalRewards.outputIndex

number

required

historicalRewards.reward

object

required

Show child attributes

historicalRewards.reward.assetId

string

required

Unique ID for an asset.

historicalRewards.reward.name

string

required

Name of this asset.

historicalRewards.reward.symbol

string

required

Symbol for this asset (max 4 characters).

historicalRewards.reward.denomination

number

required

Denomination of this asset to represent fungibility.

historicalRewards.reward.type

enum<string>

required

Type of asset like SECP256K1 or NFT.

Available options:

secp256k1,

nft

historicalRewards.reward.amount

string

required

Amount of the asset.

historicalRewards.reward.historicalPrice

object

The historical asset price at the time the reward was granted, if available. Note, this is only provided if the reward occured more than 24 hours ago.

Show child attributes

historicalRewards.reward.historicalPrice.currencyCode

enum<string>

required

ISO 4217 currency code.

Available options:

usd,

eur,

aud,

cad,

chf,

clp,

cny,

czk,

dkk,

gbp,

hkd,

huf,

jpy,

nzd

historicalRewards.reward.historicalPrice.value

number

required

Monetary value in base 10 decimals.

historicalRewards.rewardTxHash

string

required

nextPageToken

string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.