curl --request POST \
--url https://beaconcha.in/api/v2/ethereum/validators/rewards-aggregate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"validator": {
"validator_identifiers": [
1
]
},
"range": {
"evaluation_window": "24h"
},
"chain": "mainnet"
}
'{
"data": {
"total": "<string>",
"total_reward": "<string>",
"total_penalty": "<string>",
"attestation": {
"head": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"source": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"target": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"inactivity_leak_penalty": "<string>",
"total": "<string>",
"inclusion_delay": {
"total": "<string>",
"missed_reward": "<string>"
}
},
"sync_committee": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"proposal": {
"total": "<string>",
"execution_layer_reward": "<string>",
"attestation_inclusion_reward": "<string>",
"sync_inclusion_reward": "<string>",
"slashing_inclusion_reward": "<string>",
"missed_cl_reward": "<string>",
"missed_el_reward": "<string>"
},
"total_missed": "<string>",
"finality": "not_finalized"
},
"range": {
"slot": {
"start": 1,
"end": 1
},
"epoch": {
"start": 1,
"end": 1
},
"timestamp": {
"start": 1,
"end": 1
}
}
}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 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.
curl --request POST \
--url https://beaconcha.in/api/v2/ethereum/validators/rewards-aggregate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"validator": {
"validator_identifiers": [
1
]
},
"range": {
"evaluation_window": "24h"
},
"chain": "mainnet"
}
'{
"data": {
"total": "<string>",
"total_reward": "<string>",
"total_penalty": "<string>",
"attestation": {
"head": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"source": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"target": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"inactivity_leak_penalty": "<string>",
"total": "<string>",
"inclusion_delay": {
"total": "<string>",
"missed_reward": "<string>"
}
},
"sync_committee": {
"total": "<string>",
"reward": "<string>",
"penalty": "<string>",
"missed_reward": "<string>"
},
"proposal": {
"total": "<string>",
"execution_layer_reward": "<string>",
"attestation_inclusion_reward": "<string>",
"sync_inclusion_reward": "<string>",
"slashing_inclusion_reward": "<string>",
"missed_cl_reward": "<string>",
"missed_el_reward": "<string>"
},
"total_missed": "<string>",
"finality": "not_finalized"
},
"range": {
"slot": {
"start": 1,
"end": 1
},
"epoch": {
"start": 1,
"end": 1
},
"timestamp": {
"start": 1,
"end": 1
}
}
}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.
- Indexes/Public Keys
- Dashboard
- 💎 Deposit
- 💎 Withdrawal
Show child attributes
Show child attributes
An array containing either validator indices or public keys. Index and public key can be mixed in the same array.
Premium users can include up to 100 entries; free users are limited to 20.
1 - 100 elementsValidator Index
x >= 0The Ethereum chain to query.
mainnet, hoodi Response
Successful response.
Response containing aggregated rewards information of the validators.
Show child attributes
Show child attributes
Total net rewards (rewards minus penalties) earned by the validator in the specified range.
Total rewards earned by the validator in the specified range.
Total penalties incurred by the validator in the specified range.
Show child attributes
Show child attributes
A detailed breakdown of rewards and penalties related to Head Vote duties.
Important Note on Penalty: The 'penalty' field for head votes was only applicable before the Altair hardfork (Epoch 74240, Oct 27, 2021). After Altair, there is no penalty for incorrect head votes; only missed rewards.
Show child attributes
Show child attributes
Net result for this duty (reward minus penalty).
Positive values indicate net rewards earned; negative values indicate net penalties.
Reward is the amount earned for correctly and promptly performing duties. Represents the positive balance increase received.
Penalty is the amount deducted from your balance for missing or incorrectly performing duties. This is always a positive value, representing the loss incurred in addition to missed rewards.
When missing a duty, you earn no reward and also incur a penalty, resulting in a net negative impact on your balance.
Missed rewards are the potential earnings lost due to missed or delayed duties that you could have earned if performed correctly. This value shows the difference between the maximum possible reward and the actual reward received.
Returned as a positive value representing unearned rewards.
Reward or penalty for correct or incorrect source votes in attestations.
Show child attributes
Show child attributes
Net result for this duty (reward minus penalty).
Positive values indicate net rewards earned; negative values indicate net penalties.
Reward is the amount earned for correctly and promptly performing duties. Represents the positive balance increase received.
Penalty is the amount deducted from your balance for missing or incorrectly performing duties. This is always a positive value, representing the loss incurred in addition to missed rewards.
When missing a duty, you earn no reward and also incur a penalty, resulting in a net negative impact on your balance.
Missed rewards are the potential earnings lost due to missed or delayed duties that you could have earned if performed correctly. This value shows the difference between the maximum possible reward and the actual reward received.
Returned as a positive value representing unearned rewards.
Reward or penalty for correct or incorrect target votes in attestations.
Show child attributes
Show child attributes
Net result for this duty (reward minus penalty).
Positive values indicate net rewards earned; negative values indicate net penalties.
Reward is the amount earned for correctly and promptly performing duties. Represents the positive balance increase received.
Penalty is the amount deducted from your balance for missing or incorrectly performing duties. This is always a positive value, representing the loss incurred in addition to missed rewards.
When missing a duty, you earn no reward and also incur a penalty, resulting in a net negative impact on your balance.
Missed rewards are the potential earnings lost due to missed or delayed duties that you could have earned if performed correctly. This value shows the difference between the maximum possible reward and the actual reward received.
Returned as a positive value representing unearned rewards.
If the chain fails to finalize, it enters "inactivity leak" mode. In this state, inactive validators receive escalating penalties that increase over time.
This mechanism encourages validators to resume participation and helps restore finality by gradually removing non-participating validators from the active set.
Total rewards earned from attestations.
Note: This reward was only applicable before the Altair hardfork (Epoch 74240, Oct 27, 2021).
Prior to Altair, validators earned extra rewards for including attestations with minimal delay—the faster the inclusion, the greater the reward. Since Altair, this incentive was removed and timely inclusion became a strict requirement: head votes must now be included in the immediate next slot. As a result, this field is always null for epochs after Altair, but may have nonzero values for earlier epochs.
Note: Do not confuse this metric with the performance.avg_inclusion_delay field found in the performance endpoint, which refers to the average delay in slots for attestations to be included on-chain.
Show child attributes
Show child attributes
Total rewards earned by the validator for timely inclusion of attestations. There is no penalty for delayed inclusion, only missed rewards.
Missed rewards are the potential earnings lost due delayed attestations that you could have earned if performed correctly. This value shows the difference between the maximum possible reward and the actual reward received. Returned as a positive value representing unearned rewards.
Show child attributes
Show child attributes
Net result for this duty (reward minus penalty).
Positive values indicate net rewards earned; negative values indicate net penalties.
Reward is the amount earned for correctly and promptly performing duties. Represents the positive balance increase received.
Penalty is the amount deducted from your balance for missing or incorrectly performing duties. This is always a positive value, representing the loss incurred in addition to missed rewards.
When missing a duty, you earn no reward and also incur a penalty, resulting in a net negative impact on your balance.
Missed rewards are the potential earnings lost due to missed or delayed duties that you could have earned if performed correctly. This value shows the difference between the maximum possible reward and the actual reward received.
Returned as a positive value representing unearned rewards.
Show child attributes
Show child attributes
Total rewards earned from block proposals.
Rewards earned from execution layer activities, which can be either transaction fees or MEV rewards, depending on the block.
Rewards for including attestations in the proposed block. Proposers receive a reward based on the attestation rewards included in their block.
Rewards for including sync committee contributions in the proposed block. Proposers receive a reward based on the sync committee rewards included in their block.
Rewards for including slashing proofs in the block. Proposers earn a portion of the slashed validators' effective balance.
Estimated consensus layer rewards lost due to missed or orphaned block proposals.
The actual missed value is impossible to be determined, we estimate it using the median reward from the 32 surrounding blocks - 16 before and 16 after, [n-16, n+16).
Estimated execution layer rewards lost due to missed or orphaned block proposals.
The actual missed value is impossible to be determined, we estimate it using the median reward from the 32 surrounding blocks - 16 before and 16 after, [n-16, n+16).
Total missed rewards by the validator in the specified range. Missed rewards could have been earned if the validator had performed perfectly.
Indicates the finality status of the data provided.
- Finalized data cannot be changed without slashing at least one-third of all validators, providing strong economic guarantees.
- Data marked as not_finalized does not have this guarantee and may still change.
not_finalized, finalized The range of data covered by the results, specified in slots, epochs, and Unix timestamps.
Show child attributes
Show child attributes
Was this page helpful?