Performance Aggregated
Returns aggregated performance metrics for a known collection or group of validators. Known collections are referenced by index, public key, deposit address, or withdrawal address.
This endpoint includes the BeaconScore metric, which measures how well validators perform their duties. Learn more about how BeaconScore is calculated.
Coming Soon: Support for querying arbitrary time ranges using Unix timestamps, epochs, or slots — exclusively for Scale and Enterprise plans.
Authorizations
Body
Free selectors available to all users:
- validator_identifiers: One or more validator indices or public keys to filter by.
- dashboard_id: Your beaconcha.in dashboard ID (requires a free account).
Premium selectors for Scale & Enterprise plans (https://beaconcha.in/pricing):
- withdrawal: The validator's withdrawal credential or the Ethereum wallet address used for withdrawals.
- deposit_address: The Ethereum wallet address used for the validator's deposit.
- entity: The name of the assigned entity (e.g., "Lido", "Coinbase"). Optionally include
sub_entityfor more specific filtering. Matching is case-insensitive.
Note: The set of validators matched by deposit_address and withdrawal selectors is updated once per epoch (~6.4 minutes). Newly deposited validators may take up to one epoch to appear in query results.
Note: The set of validators matched by entity selector is updated once per day.
- Indices/Pubkeys
- Dashboard
- 💎 Deposit
- 💎 Withdrawal
- 💎 Entity
Specify a date range to receive aggregated data for that period — ideal for use cases like daily income tracking for income reporting.
Support for querying arbitrary time ranges using Unix timestamps, epochs, or slots will be coming soon, exclusively for Scale and Enterprise plans (https://beaconcha.in/pricing).
- Fixed Window
- 💎 Unix Timestamp
- 💎 Epoch
- 💎 Slot
The Ethereum chain to query.
mainnet, hoodi 
