Rewards

post

https://api.figment.io/ethereum/rewards

Returns gross rewards, as earned by validators

Notes:

For mainnet and hoodi
Returns data for any Figment validator that was created through Create Validators
Daily and all time rollups
Filters by date (start and end timestamps, inclusive), by validator pubkey or by withdrawal address/credentials.
For a single validator’s rewards, pass only pubkey and omit withdrawal_addresses.
Rewards are available approximatively 3 hours after they are distributed onchain. Daily rollups are done based on UTC days
Includes execution layer rewards, swept consensus layer rewards and unswept consensus layer rewards
Slashing penalties are reflected in the "balances" field, and subsequent missed attestations appear as negative values in consensus rewards.

General features described in Rewards Overview

Body Params

time_rollup

string

enum

required

The granularity of the rewards data. Use epoch for one record per validator per epoch, daily for rewards aggregated by UTC calendar day, or all_time for cumulative rewards since validator activation.

Allowed:

start

string

required

Lower bound of rewards data. For epoch time_rollup: accepts an epoch number as an integer (e.g. 261702) or a date string ("YYYY-MM-DD"). For daily time_rollup: accepts a date string ("YYYY-MM-DD"). Ignored for all_time time_rollup.

end

string

required

Upper bound of rewards data. For epoch time_rollup: accepts an epoch number as an integer (e.g. 261703) or a date string ("YYYY-MM-DD"). For daily time_rollup: accepts a date string ("YYYY-MM-DD"). Ignored for all_time time_rollup.

groups

string

Filter using comma-separated group uuids.

network

string

enum

Defaults to mainnet

Allowed:

pubkeys

array of strings

A list of validator pubkeys for filtering.

pubkeys

withdrawal_addresses

array of strings

A list of withdrawal addresses or credentials for filtering.

withdrawal_addresses

page

object

include_penalties

boolean

Defaults to false

When true, includes a separate consensus_penalty entry in the rewards array representing attestation and sync committee penalties for the period. Defaults to false.
Data availability: Penalty data is available from epoch 427295 (2026-02-12) onward. For periods before this epoch/date, no consensus_penalty entry will be present in the response regardless of whether penalties were incurred. For all_time rollups, the penalty represents the sum from epoch 427295 (2026-02-12) to present, not the validator's full lifetime.

Responses

200List of rewards and balances aggregated for all addresses registered to the organization and rolled up to the requested time_rollup.

400Parameter error

401Unauthorized

500System error