ETH.Store daily aggregates

Retrieve ETH.Store® daily aggregate metrics that represent the average financial return validators achieved over a 24-hour period. A “beaconchain-day” is defined as the number of full days elapsed since chain genesis, computed as blocks grouped into periods of (24 * 60 * 60) // SlotsPerEpoch // SecondsPerSlot epochs. Use this endpoint to analyze validator returns, moving averages, and reward composition (consensus-layer vs. execution-layer fees) on a per-day basis. See https://github.com/gobitfly/eth.store for additional context.

GET /api/v1/ethstore/{day}

ETH.Store daily aggregates

cURL

curl --request GET \
  --url 'https://beaconcha.in/api/v1/ethstore/{day}?apikey='

200

{
  "status": "OK",
  "data": [
    {
      "day": 435,
      "day_start": "2022-02-09T12:00:23Z",
      "day_end": "2022-02-10T12:00:23Z",
      "apr": 0.0527609790864113,
      "avgapr7d": 0.052764308760676414,
      "avgapr31d": 0.053351525019046164,
      "cl_apr": 0.0527609790864113,
      "cl_avgapr7d": 0.052764308760676414,
      "cl_avgapr31d": 0.053351525019046164,
      "el_apr": 0.0063633204373217,
      "el_avgapr7d": 0.005195252974383372,
      "el_avgapr31d": 0.005679846878640752,
      "consensus_rewards_sum_wei": 1.349850765807e+21,
      "avgconsensus_rewards7d_wei": 1.345081426021e+21,
      "avgconsensus_rewards31d_wei": 1.3378170064684515e+21,
      "tx_fees_sum_wei": 503073827859422400000,
      "avgtx_fees7d_wei": null,
      "avgtx_fees31d_wei": null,
      "deposits_sum_wei": 0,
      "effective_balances_sum_wei": 9.338256e+24,
      "start_balances_sum_wei": 9.783046761967892e+24,
      "end_balances_sum_wei": 9.7843966127337e+24,
      "total_rewards_wei": 1.349850765807e+21
    }
  ]
}

Authorizations

ApiKeyAuthQueryApiKeyAuthHeader

apikey · string · query · required

Path Parameters

day · enum<string> integer · required

The beaconchain-day to fetch. Provide an integer day index (>= 0), or the keyword latest for the most recently computed day. Special tag for convenience.

Available options: latest

Example:

"latest"

Response

200

application/json

The requested day was found and ETH.Store® aggregates are returned in the data array. This array contains a single record for the requested day.

Standard success envelope used by all API endpoints.

status · enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options: OK

data · object[]

Response payload specific to the endpoint.

Show child attributes