v1

latestOpenAPI 3.0.42026-07-2233241175.9 KB
Rewards

Rewards Aggregated

Returns the cumulative rewards for a set for a known collection or group of validators. Known collections are referenced by index, public key, deposit address, or withdrawal address.

Use case guide: Validator rewards explains when to use aggregate rewards and how to turn the response into reports and comparisons.

Use Rewards for a rewards breakdown of each validator.

Note: Only finalized epochs are supported for rewards data.

Attribution Required: If you display BeaconScore data publicly, you must include appropriate attribution. See our BeaconScore License and License Materials for badges and usage guidelines.

Coming Soon: Support for querying arbitrary time ranges using Unix timestamps, epochs, or slots — exclusively for Scale and Enterprise plans.

post/api/v2/ethereum/validators/rewards-aggregate

Request body

chain'mainnet' | 'hoodi'

The Ethereum chain to query.

Response

Successful response.