Validator Overview

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

Indexes/Public Keys · 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.

Indexes/Public Keys
Dashboard
💎 Deposit
💎 Withdrawal

Show child attributes

validator.validator_identifiers

(integer | string)[]

required

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.

Required array length: 1 - 100 elements

Validator Index

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

Response

Successful response.

Response containing basic information about the validator.

data

object[]

required

Show child attributes

data.validator

object

required

Show child attributes

data.validator.index

integer

Validator Index

Required range: x >= 0

data.validator.public_key

string

Public key of a validator

data.slashed

boolean

required

data.status

enum<string>

required

Available options:

pending_initialized,

pending_queued,

active_ongoing,

active_exiting,

active_slashed,

exited_unslashed,

exited_slashed,

withdrawal_possible,

withdrawal_done,

unknown

data.withdrawal_credentials

object

required

Show child attributes

data.withdrawal_credentials.type

enum<string>

required

Specifies whether the withdrawal credential is a BLS withdrawal credential or an execution address withdrawal credential.

Available options:

bls,

execution_address

data.withdrawal_credentials.prefix

enum<string>

required

Hexadecimal prefix indicating the type of withdrawal credential:

"0x00": BLS withdrawal credential
"0x01": Execution address withdrawal credential
"0x02": Execution address withdrawal credential with consolidation support (Electra Fork)

Credentials can be upgraded in one direction only:

From "0x00" (BLS) to "0x01" (execution address)
From "0x01" to "0x02" (consolidation-enabled execution address) Downgrades are not permitted.

Available options:

0x00,

0x01,

0x02

data.withdrawal_credentials.credential

string

required

A full 32-byte withdrawal credential represented as a hex string with 0x prefix.

data.withdrawal_credentials.address

string | null

Present only if type is execution_address

data.life_cycle_epochs

object

required

Epochs marking significant lifecycle events for the validator. Unlike the official spec, null is returned for events that have not yet occurred, instead of using "FAR_FUTURE_EPOCH" (max uint64), to simplify client handling.

Show child attributes

data.life_cycle_epochs.activation_eligibility

integer | null

The epoch at which the validator became eligible for activation by meeting the activation criteria.

data.life_cycle_epochs.activation

integer | null

The epoch at which the validator was activated and started participating in the consensus process & earning rewards.

data.life_cycle_epochs.exit

integer | null

The epoch at which the validator exited and stopped participating in the consensus process.

data.life_cycle_epochs.withdrawable

integer | null

The epoch at which the validator became eligible for withdrawal after they have exited.

data.balances

object

required

The balances object provides detailed information about a validator's balances at the head of the chain.

Balances are measured immediately before the first slot of the head chain. For example, a balance reported for epoch 10 reflects the state after the final slot of epoch 9 and before the first slot of epoch 10.

For more details about balances, see: https://eth2book.info/latest/part2/incentives/balances/

Show child attributes

data.balances.current

string

required

The validator's balance at a given state. This includes all rewards and penalties accrued up to that point, excluding any withdrawn amounts.

data.balances.effective

string

required

The effective balance is the amount used to calculate rewards and penalties for the validator on the consensus layer.

It relates to the current balance to some extent, but is not the same. Unlike the current balance, the effective balance is updated less frequently, only in whole ETH increments, and is subject to a maximum cap: 32 ETH for withdrawal credential prefixes "0x00" or "0x01", and 2048 ETH for prefix "0x02".

data.finality

enum<string>

required

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.

Available options:

not_finalized

data.online

boolean | null

range

object

required

The range of data covered by the results, specified in slots, epochs, and Unix timestamps.

Show child attributes

range.slot

object

required

Show child attributes

range.slot.start

integer

required

Slot by number.

Required range: x >= 0

range.slot.end

integer

required

Slot by number.

Required range: x >= 0

range.epoch

object

required

Show child attributes

range.epoch.start

integer

required

Required range: x >= 0

range.epoch.end

integer

required

Required range: x >= 0

range.timestamp

object

required

Show child attributes

range.timestamp.start

integer

required

Required range: x >= 0

range.timestamp.end

integer

required

Required range: x >= 0

paging

object

Show child attributes

paging.next_cursor

string

Cursor to the next page of results. See our pagination guide for more details.

Introduction

V2 API Docs

V1 API Docs

Authorizations

Body

Response