v1

latestOpenAPI 3.0.42026-07-2233241175.9 KB
Rewards

Rewards

Returns a breakdown of rewards for each validator for a given epoch.

Use case guide: Validator rewards explains when to use per-epoch rewards and links to custom-range, tax, and missed-reward workflows.

Use Rewards Aggregated for a cumulative view of all validator rewards combined.

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.

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

Request body

chain'mainnet' | 'hoodi'

The Ethereum chain to query.

cursorstring

Cursor value for pagination. See our pagination guide for more details.

page_sizeinteger

The number of items to return per page.

epochinteger required

Response

Successful response.