chain

Get Historical Rewards

Retrieves historical staking reward data for specified addresses, including transaction hashes, unique IDs (UTXO or node), and the staked amount with start/end timestamps. The response also provides asset details (identifier, name, symbol, etc.), reward amounts, and reward types (e.g., DELEGATOR), supporting thorough audits and portfolio integrations.

💡 Compute Unit Value: 50 (Fixed)

get/defi/v1/chain/gethistoricalrewards

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/chain/gethistoricalrewards
Auth
API key in header X-API-Key

Query parameters

chainId'43115'

The unique ID to direct queries or transactions to the correct blockchain. Find more here.

Example:43115

chainSymbolstring

The abbreviated chain name for queries or transactions.

Example:ETH

addressstring required

Comma-separated value of user addresses.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

pageTokenstring

Token to fetch the next page of data, found at the end of the response.

Example:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwYWdlIjoxLCJjb250cmFjdEFkZHJlc3MiOiIweGZhZThlNjRjZGRlNzM1NTBlN2Q3ZjA0Njk1NTdhMzNhNDE3YjI4NjgiLCJjb250cmFjdFR5cGUiOiJlcmMyMCIsImFwcHJvdmVyQWRkcmVzcyI6IjB4NjVhOGYwN2JkOWE4NTk4ZTFiNWI2YzBhODhmNDc3OWRiYzA3NzY3NSIsInNwZW5kZXJBZGRyZXNzIjoiMHgxMTExMTExMjU0ZmI2YzQ0YmFjMGJlZDI4NTRlNzZmOTA2NDMwOTdkIiwiaWF0IjoxNzMzMzkzODE2fQ.y7FANxpXgtdgk83CIqPHHk2jutj1NZrueTu4XR39jnk

sortOrder'desc' | 'asc'

The sorting order for transactions. Either 'asc' or 'desc'.

Example:desc

currencystring

A currency symbol to convert the amount into, such as ['USD', 'EUR']. This parameter is optional and can be used to get the value in single fiat currency.

Example:INR

Response

Successful response

statusinteger

msgstring

dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "historicalRewards": [
      {
        "addresses": [
          "avax1h2ccj9f5ay5acl6tyn9mwmw32p8wref8vl8ctg"
        ],
        "txHash": "2mTm1C6vWjZimKUds7UwocLEyHSA8AMpx6uUbEf4ApuvxaDdjU",
        "utxoId": "zkB6uffuTxnYTVfpEYTaj6VeiqBK5Pd38hTroz99q3xW4mBWn",
        "outputIndex": 5,
        "amountStaked": "20250000000000",
        "nodeId": "NodeID-Le5rVEBBPdgYEcEJpvYeKo36hRs75WE5S",
        "startTimestamp": 1608624860,
        "endTimestamp": 1615247434,
        "reward": {
          "assetId": "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z",
          "name": "Avalanche",
          "symbol": "AVAX",
          "denomination": 9,
          "type": "secp256k1",
          "amount": "20573884941",
          "prices": {
            "cny": [
              {
                "FvwEAhmxKfeiG8SnEvq42hc6whRyY3EFYAvebMqDNDGCgxN5Z": "172.60229554545396"
              }
            ]
          }
        },
        "rewardType": "VALIDATOR_FEE",
        "rewardTxHash": "eD3oKFuC6rScRRfGdmwqtXxYz72Qjin8Pm5CT9jt1o8Zm7WLg"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.