Skip to main content

/eth/v1/beacon/rewards/attestations/{epoch} RPC Method

Retrieve attestation reward info for validators specified by array of public keys or validator index. If no array is provided, return reward info for every validator.

Updated on
Jan 18, 2024

/eth/v1/beacon/rewards/attestations/{epoch} RPC Method

Query Parameters

epoch
integer
REQUIRED
The epoch to get rewards info from

Body Parameters

public_key
string
REQUIRED
An array of either hex encoded public key (any bytes48 with 0x prefix) or validator index

Returns

execution_optimistic
boolean
A boolean indicating whether the execution of rewards for the specified epoch is done optimistically or not
finalized
boolean
(Optional) A boolean indicating whether the rewards for the specified epoch have been finalized
data
object
An object containing two arrays of reward-related information for attestations in the specified epoch
ideal_rewards
object
An array containing ideal reward metrics for attestations in the specified epoch
effective_balance
string
The effective balance for the ideal reward calculation
head
string
The reward for attesting to the head block
target
string
The reward for attesting to the target block
source
string
The reward for attesting to the source block
inclusion_delay
string
(Optional) The reward for including the attestation in a block with a specific delay
inactivity
string
(Optional) The inactivity penalty for the ideal reward calculation
total_rewards
object
An array containing total reward metrics for individual validators in the specified epoch
validator_index
string
The index of the validator
head
string
The reward for attesting to the head block for the specified validator
target
string
The reward for attesting to the target block for the specified validator
source
string
The reward for attesting to the source block for the specified validator
inclusion_delay
string
(Optional) The reward for including the attestation in a block with a specific delay for the specified validator
inactivity
string
(Optional) The inactivity penalty for the total reward calculation for the specified validator
Request
1
curl --location 'https://docs-demo.quiknode.pro/eth/v1/beacon/rewards/attestations/{EPOCH}' \
2
--header 'accept: application/json' \
3
--header 'Content-Type: application/json' \
4
--data '[
5
"294266"
6
]'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free