Validators overview (POST)

curl --request POST \
  --url 'https://beaconcha.in/api/v1/validator?apikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "indicesOrPubkey": "1,2,3"
}
'

{
  "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
    }
  ]
}

Validators

Validators overview (POST)

Retrieve validator information by index or public key using a JSON request body. Use this endpoint when the list of identifiers is too long for the GET path parameter. Provide up to 100 identifiers (higher limits may apply to authenticated premium users) as a comma-separated string in the indicesOrPubkey field. Each identifier must be either a validator index (base-10 integer) or a 48-byte BLS public key as 0x-prefixed hex (96 hex characters after 0x) or without the 0x prefix.

POST

api

validator

curl --request POST \
  --url 'https://beaconcha.in/api/v1/validator?apikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "indicesOrPubkey": "1,2,3"
}
'

{
  "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

Body

application/json

Comma-separated list of validator indices and/or public keys to query (maximum 100 items by default).

Validator lookup request specifying validator indices and/or public keys.

indicesOrPubkey

string

required

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

Validators overview

Attestation efficiency

Introduction

API Docs

Validators overview (POST)

Authorizations

Body

Response