Skip to main content

Rewards - Polkadot

Rewards by era

Returns net delegator rewards (post-on-chain validator commission) by epoch.

URL

https://polkadot-rewards.datahub.figment.io/v2/rewards

Request

  • accounts* takes in an array of stash accounts addresses.
  • start* and end* are era numbers, both inclusive.

Response

The response is broken down between meta and data :

  • meta
    • network : The name of the network queried.
    • period_unit : The unit of the period field under data
  • data is an array of objects, one for each era containing:
    • validator : Returns the validator that distributed the rewards.
    • period : The era number.
    • timestamp : The timestamp of the end of the era.
    • rewards : An array of objects with four components: numeric, exp, and currency. The formula to compute the final rewards in the currency unit is numeric x 10^-exp (text is the string version of this)
    • balances: an array of objects. Staked balances only for now

Limitations

  • The API returns rewards for Figment validators only.
  • Data is available approximately an hour after the end of the day or epoch. When requesting daily for the current day, the data will be available but obviously partially complete as the day progresses.
Request (try it)
Example Response
{
  "data": [
    {
      "accounts": [
        "12m7XtVWZQuxTirqtzm2dm5J4r16vSQruPmahThMnskG8Bcp"
      ],
      "chain_id": "mainnet",
      "rewards": [
        {
          "text": "4.4045175383 DOT",
          "currency": "DOT",
          "numeric": 44045175383,
          "exp": 10
        }
      ],
      "period": "845",
      "validator": "138QdRbUTB9eNY94Q4Mj5r39FkgMiyHCAy8UFMNA5gvtrfSB",
      "timestamp": "2022-09-25T15:36:18Z"
    },
    {
      "accounts": [
        "12m7XtVWZQuxTirqtzm2dm5J4r16vSQruPmahThMnskG8Bcp"
      ],
      "chain_id": "mainnet",
      "rewards": [
        {
          "text": "3.6694634053 DOT",
          "currency": "DOT",
          "numeric": 36694634053,
          "exp": 10
        }
      ],
      "period": "846",
      "validator": "138QdRbUTB9eNY94Q4Mj5r39FkgMiyHCAy8UFMNA5gvtrfSB",
      "timestamp": "2022-09-26T15:36:18Z"
    }
  ],
  "meta": {
    "network": "polkadot",
    "period_unit": "era"
  }
}