Rewards API - NEAR

Change Network: AvalancheEthereumNEARPolkadotSolana Jump to: Rewards by epoch

API AuthenticationClick to view API Authentication details

API calls require authentication with API key via Authorization request header or URL property. Calls are made to one of the Near Rewards API endpoints found in your app's dashboard.

For example: https://near-rewards.datahub.figment.io

Here's some boilerplate to get you started.

Fetch with Header

fetch("https://near-rewards.datahub.figment.io/v2/rewards", {
    method: 'POST', // can also be 'GET', 'PUT' or any appropriate method
    headers: {
        "Authorization" : "<api_key>",
        "Content-Type": "application/json" // if method is 'POST'
    },
    body: JSON.stringify({
      // JSON Payload
    })
})

Fetch with Parameter

fetch("https://near-rewards.datahub.figment.io/apikey/{{apikey}}/v2/rewards", {
    method: 'POST', // can also be 'GET', 'PUT' or any appropriate method
    headers: {
        "Content-Type": "application/json" // if method is 'POST'
    },
    body: JSON.stringify({
      // JSON Payload
    })
})

CURL with Header

curl -X POST 'https://near-rewards.datahub.figment.io/v2/rewards' \
--header 'Content-Type: application/json' \
--header 'Authorization: <api_key>' \
--data '{
  // JSON Payload
}'

CURL with Parameter

curl -X POST 'https://near-rewards.datahub.figment.io/apikey/{{apikey}}/v2/rewards' \
--header 'Content-Type: application/json' \
--data '{
  // JSON Payload
}'

Available Methods

Rewards by epoch

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

Request Body (try it)

{ "accounts": [ "figment.near" ] }

{
  "accounts": [
    "figment.near"
  ]
}

Example Response

{
  "data": [
    {
      "accounts": [
        "figment.near"
      ],
      "chain_id": "mainnet",
      "rewards": [
        {
          "text": "221.415622439422952523250579 NEAR",
          "currency": "NEAR",
          "numeric": 2.2141562243942295e+26,
          "exp": 24
        }
      ],
      "period": "75743490",
      "validator": "figment.poolv1.near",
      "timestamp": "2022-10-08T13:33:18.784283459Z"
    },
    {
      "accounts": [
        "figment.near"
      ],
      "chain_id": "mainnet",
      "rewards": [
        {
          "text": "0 NEAR",
          "currency": "NEAR",
          "numeric": 0,
          "exp": 24
        }
      ],
      "period": "75743490",
      "validator": "ledgerbyfigment.poolv1.near",
      "timestamp": "2022-10-08T13:33:18.784283459Z"
    }
  ],
  "meta": {
    "network": "near",
    "period_unit": "epoch"
  }
}

SpecificationView Specification

Body

• accounts takes in an array of delegator accounts addresses (required)
• start and end are epoch numbers, both inclusive (required)

Response

The response is broken down between meta and data

• meta
  • network is the name of the network queried
  • period_unit is the unit of the period field under data
• data is an array of objects - one for each epoch - containing:
  • validator returns the validator that distributed the rewards
  • period is the epoch number
  • timestamp is the timestamp of the end of the epoch
  • rewards is 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)

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.

---