ETH.Store daily aggregates

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

{
  "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
    }
  ]
}

ETH.Store®

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

ethstore

{day}

ETH.Store daily aggregates

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

{
  "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

apikey

string

query

required

Path Parameters

day

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

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

data.day

integer

Beaconchain-day index since genesis (>= 0). Typically one record per day.

Example:

435

data.day_start

string<date-time>

Start timestamp (UTC) of the 24-hour period in RFC 3339 format.

Example:

"2022-02-09T12:00:23Z"

data.day_end

string<date-time>

End timestamp (UTC) of the 24-hour period in RFC 3339 format.

Example:

"2022-02-10T12:00:23Z"

data.apr

number

Total annualized percentage rate for the day as a fraction (0..1), combining consensus-layer rewards and execution-layer fees.

Example:

0.0527609790864113

data.avgapr7d

number

7-day trailing average of total APR (0..1), centered on or including this day.

Example:

0.052764308760676414

data.avgapr31d

number

31-day trailing average of total APR (0..1), centered on or including this day.

Example:

0.053351525019046164

data.cl_apr

number

Consensus-layer APR component only (0..1) for the day (attestations, proposals, sync committee, etc.).

Example:

0.0527609790864113

data.cl_avgapr7d

number

7-day trailing average of consensus-layer APR (0..1).

Example:

0.052764308760676414

data.cl_avgapr31d

number

31-day trailing average of consensus-layer APR (0..1).

Example:

0.053351525019046164

data.el_apr

number

Execution-layer APR component only (0..1) for the day (e.g., priority fees, MEV). 0 for pre-Merge periods.

Example:

0.0063633204373217

data.el_avgapr7d

number

7-day trailing average of execution-layer APR (0..1).

Example:

0.005195252974383372

data.el_avgapr31d

number

31-day trailing average of execution-layer APR (0..1).

Example:

0.005679846878640752

data.consensus_rewards_sum_wei

number

Total consensus-layer rewards accrued during the day across all validators, in wei.

Example:

1.349850765807e+21

data.avgconsensus_rewards7d_wei

number

7-day trailing average of the daily consensus rewards sum, in wei.

Example:

1.345081426021e+21

data.avgconsensus_rewards31d_wei

number

31-day trailing average of the daily consensus rewards sum, in wei.

Example:

1.3378170064684515e+21

data.tx_fees_sum_wei

number

Total execution-layer priority transaction fees (excluding MEV tips) accrued during the day across all validators, in wei. 0 for pre-Merge periods.

Example:

503073827859422400000

data.avgtx_fees7d_wei

number | null

7-day trailing average of the daily transaction fees sum, in wei; null when not applicable (e.g., pre-Merge).

Example:

null

data.avgtx_fees31d_wei

number | null

31-day trailing average of the daily transaction fees sum, in wei; null when not applicable (e.g., pre-Merge).

Example:

null

data.deposits_sum_wei

number

Total amount of ETH deposited into the validator deposit contract during the day, in wei.

Example:

0

data.effective_balances_sum_wei

number

Sum of effective balances across all active validators at the end of the day, in wei.

Example:

9.338256e+24

data.start_balances_sum_wei

number

Sum of actual validator balances at the start of the day, in wei.

Example:

9.783046761967892e+24

data.end_balances_sum_wei

number

Sum of actual validator balances at the end of the day, in wei.

Example:

9.7843966127337e+24

data.total_rewards_wei

number

Total rewards earned during the day (consensus + execution), in wei.

Example:

1.349850765807e+21

Get Rocket Pool validator metadata by index or pubkey

Execution blocks produced by fee recipient, proposer index, or pubkey

Introduction

API Docs

ETH.Store daily aggregates

Authorizations

Path Parameters

Response