Skip to main content
POST
Rewards

Authorizations

Authorization
string
header
required

Authorization header with value: Bearer YOUR_TOKEN. Refer to the API Keys section to create your API key.

Body

application/json
validator
Indices/Pubkeys · object
required

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.
  • entity: The name of the assigned entity (e.g., "Lido", "Coinbase"). Optionally include sub_entity for more specific filtering. Matching is case-sensitive.

Note: The set of validators matched by deposit_address and withdrawal selectors is updated once per epoch (~6.4 minutes). Newly deposited validators may take up to one epoch to appear in query results.

Note: The set of validators matched by entity selector is updated once per day.

epoch
integer
required
Required range: x >= 0
chain
enum<string>
default:mainnet

The Ethereum chain to query.

Available options:
mainnet,
hoodi
cursor
string
default:""

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

page_size
integer
default:10

The number of items to return per page.

Required range: 1 <= x <= 10
status_filter
enum<string>[] | null

Return only validators whose status at the requested epoch is in one of the listed groups. Omit the field (or pass an empty array) to return validators in every status.

A group of validator lifecycle statuses to filter by, evaluated at the requested epoch:

  • pending: not active yet (pending_initialized and pending_queued).
  • active: active, including validators that are exiting or slashed (active_ongoing, active_exiting and active_slashed).
  • exited: exited but not withdrawable yet (exited_unslashed and exited_slashed).
  • withdrawal: withdrawable (withdrawal_possible and withdrawal_done).
Available options:
pending,
active,
exited,
withdrawal

Response

Successful response.

Response containing detailed rewards information of the validators.

data
object[]
required
range
object
required

The time span actually covered by the returned results — from the first to the last matching data point — specified in slots, epochs, and Unix timestamps.

This reflects the data that was found, not the range that was queried. When no data is found, it falls back to the requested range, or to the full available history if no range was given.

For arbitrary (custom) time-range queries the queried range is expanded outward to whole UTC days, so the covered range may be wider than requested. As stated above, the reported range still reflects the data that was actually found — a touched UTC day with no data for the selected validators will not extend it.

paging
object