Skip to main content

Rewards Rates API - Ethereum


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("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
})
})

Available Methods

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 %