Rewards Rates API - Ethereum

Change Network: EthereumSolana Jump to: ETH Reward Rates

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 Ethereum Rewards Rates API endpoints found in your app's dashboard.

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

Here's some boilerplate to get you started.

Fetch with Header

fetch("https://eth-rewards.datahub.figment.io/rates", {
    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://eth-rewards.datahub.figment.io/apikey/{{apikey}}/rates", {
    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://eth-rewards.datahub.figment.io/rates' \
--header 'Content-Type: application/json' \
--header 'Authorization: <api_key>' \
--data '{
  // JSON Payload
}'

CURL with Parameter

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

Available Methods

ETH Reward Rates

This API returns a time series of daily network-wide annualized staking reward rates, in %.

Request Query (try it)

Example Response

[
  {
    "date": "2022-11-08",
    "value": "5.726611",
    "staking": "3.410072",
    "tips": "2.316538"
  },
  {
    "date": "2022-11-07",
    "value": "5.361810",
    "staking": "4.198922",
    "tips": "1.162887"
  },
  {
    "date": "2022-11-06",
    "value": "5.172277",
    "staking": "4.202448",
    "tips": "0.969829"
  },
  {
    "date": "2022-11-05",
    "value": "5.071560",
    "staking": "4.184485",
    "tips": "0.887075"
  }
]

SpecificationView Specification

Methodology

We first compute daily rates by aggregating all rewards (on both consensus and execution layers) received by all validators within a 24h period (from midnight UTC to midnight UTC) and divide this by the aggregated balances of all validators at the beginning of this 24h period. We then annualize this rate without compounding.

Query Parameters

• figment (optional): if true is passed we will return the reward rate for Figment validators only. If omitted or any other value is passed we will return the reward rate of the network as a whole.

Response

An array of following objects:

• date: timestamp for the day in format "YYYY-MM-DD"
• value: the total annualized reward rate for that day - in %
• staking: the piece due to consensus layer rewards (inflation) - in %
• tips: the piece due to execution layer rewards (transaction fees) - in %

---