Returns gross rewards, as earned by validators

Scope

• mainnet and hoodi.
• Returns data for any Figment validator created through the FigApp or the Create Validators endpoint.

Rewards

• Reports gross rewards.
• The response includes execution-layer rewards, swept consensus-layer rewards, and unswept consensus-layer rewards.

Timing & time-based rollups

• Rewards appear approximately 3 hours after the network distributes them on-chain.
• Set the granularity with time_rollup. The endpoint supports epoch, daily, and all_time.
• Daily rollups use UTC calendar days.

Filtering

• Filter by date with start and end. Both bounds are inclusive.
• Filter by validator with pubkeys, or by address with withdrawal_addresses.
• To query a single validator, pass one pubkey and omit withdrawal_addresses.
  

Missed attestation penalties

Missed or late attestations reduce consensus rewards.

• By default, these penalties net against rewards.
• To return them as a separate consensus_penalty entry, set include_penalties=true.
• Penalty data starts at epoch 427295 (2026-02-12). See the include_penalties param for the full caveat.

Slashing

• Slashing reduces the validator's balance through an initial and a correlation penalty. Both are reflected directly in the balances field.
  • The initial penalty applies at the moment of the slashing.
  • The correlation penalty applies about 18 days later. Its size scales with the total stake slashed across the network in the surrounding window.
• Slashing also forces the validator to exit. The inactivity penalties from this forced exit are reported as described in "Missed attestation penalties" above.

General features described in Rewards Overview