Validators overview

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}?apikey='

{
  "status": "OK",
  "data": [
    {
      "activation_eligibility_epoch": 289892,
      "activation_epoch": 290297,
      "balance": 32014494648,
      "effective_balance": 32000000000,
      "exit_epoch": 9223372036854776000,
      "last_attestation_slot": 12766062,
      "name": "name",
      "pubkey": "0xb73ecd964c9779506a3209ec40dd40d765b0464fef281d77ac8a559fa9e2a9cff8b6b2e09b8f6360b119ba7a963c5b81",
      "slashed": false,
      "status": "active_online",
      "validator_index": 1435245,
      "withdrawable_epoch": 9223372036854776000,
      "withdrawal_credentials": "0x0100000000000000000000005d652886f0b4ae0b1b7d6be5b7e2d555aafdc812",
      "total_withdrawals": 1072078769
    }
  ]
}

GET

api

validator

{indexOrPubkey}

Validators overview

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}?apikey='

{
  "status": "OK",
  "data": [
    {
      "activation_eligibility_epoch": 289892,
      "activation_epoch": 290297,
      "balance": 32014494648,
      "effective_balance": 32000000000,
      "exit_epoch": 9223372036854776000,
      "last_attestation_slot": 12766062,
      "name": "name",
      "pubkey": "0xb73ecd964c9779506a3209ec40dd40d765b0464fef281d77ac8a559fa9e2a9cff8b6b2e09b8f6360b119ba7a963c5b81",
      "slashed": false,
      "status": "active_online",
      "validator_index": 1435245,
      "withdrawable_epoch": 9223372036854776000,
      "withdrawal_credentials": "0x0100000000000000000000005d652886f0b4ae0b1b7d6be5b7e2d555aafdc812",
      "total_withdrawals": 1072078769
    }
  ]
}

Authorizations

apikey

string

query

required

Path Parameters

indexOrPubkey

string

required

Comma-separated validator indices and/or public keys (maximum 100 items by default). Comma-separated list (no spaces) of validator identifiers. Each identifier must be either:

A validator index as a base-10 integer (for example, 652648)
A BLS public key as a 96-hex-character string with or without the 0x prefix (case-insensitive)

Resolution and limits:

The server resolves public keys to validator indices before querying data.
The total number of identifiers must not exceed the server-enforced limit (default 100).
Identifiers that cannot be parsed or resolved result in HTTP 400.

Example:

"1,2,3"

Response

Matching validators were retrieved successfully. The data field contains either a single validator object (when one identifier is provided/resolved) or an array of validator objects (when multiple identifiers are provided/resolved).

Standard success envelope used by all API endpoints.

status

enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:

OK

data

object

State and metadata for a single validator, including status, balances, epochs, and withdrawal summary.

Multiple validators · object[]
Single validator · object

Show child attributes

data.activation_eligibility_epoch

integer

Epoch at which the validator became eligible for activation. Set to the FAR_FUTURE_EPOCH sentinel when not yet eligible.

Example:

289892

data.activation_epoch

integer

Epoch at which the validator entered the active set. FAR_FUTURE_EPOCH when not yet active.

Example:

290297

data.balance

integer

Current validator balance in gwei at the latest processed epoch for this response.

Example:

32014494648

data.effective_balance

integer

Effective balance used for reward/penalty calculations in gwei (capped at 32,000,000,000 gwei).

Example:

32000000000

data.exit_epoch

integer

Epoch at which the validator begins exiting. FAR_FUTURE_EPOCH when no exit is scheduled.

Example:

9223372036854776000

data.last_attestation_slot

integer

Most recent slot at which an attestation from this validator was observed in a canonical block.

Example:

12766062

data.name

string

Optional human-readable label associated with the validator. Empty string when not set.

Example:

"name"

data.pubkey

string

BLS12-381 validator public key (48 bytes; 0x-prefixed hex with 96 hex characters).

Example:

"0xb73ecd964c9779506a3209ec40dd40d765b0464fef281d77ac8a559fa9e2a9cff8b6b2e09b8f6360b119ba7a963c5b81"

data.slashed

boolean

True when the validator has been slashed.

Example:

false

data.status

enum<string>

Current validator state. One of: active_online, exiting_online, slashing_online, active_offline, exiting_offline, slashing_offline, pending_initialized, pending, deposited, exited, slashed.

Available options:

active_online,

exiting_online,

slashing_online,

active_offline,

exiting_offline,

slashing_offline,

pending_initialized,

pending,

deposited,

exited,

slashed

Example:

"active_online"

data.validator_index

integer

Validator index (>= 0).

Required range: x >= 0

Example:

1435245

data.withdrawable_epoch

integer

Epoch at which the validator’s balance becomes withdrawable after exit or slashing. FAR_FUTURE_EPOCH when not yet withdrawable.

Example:

9223372036854776000

data.withdrawal_credentials

string

32-byte withdrawal credentials (0x-prefixed hex). Prefix 0x01 encodes an execution address; 0x00 indicates BLS withdrawal credentials.

Example:

"0x0100000000000000000000005d652886f0b4ae0b1b7d6be5b7e2d555aafdc812"

data.total_withdrawals

integer

Cumulative amount withdrawn by this validator in gwei, including the latest exported day and canonical blocks of the current day.

Example:

1072078769

Withdrawals for a slot

Validators overview (POST)

Introduction

API Docs

Validators overview

Authorizations

Path Parameters

Response