Validators overview (POST)

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

import requests

url = "https://beaconcha.in/api/v1/validator?apikey="

payload = { "indicesOrPubkey": "1,2,3" }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({indicesOrPubkey: '1,2,3'})
};

fetch('https://beaconcha.in/api/v1/validator?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://beaconcha.in/api/v1/validator?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'indicesOrPubkey' => '1,2,3'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://beaconcha.in/api/v1/validator?apikey="

	payload := strings.NewReader("{\n  \"indicesOrPubkey\": \"1,2,3\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://beaconcha.in/api/v1/validator?apikey=")
  .header("Content-Type", "application/json")
  .body("{\n  \"indicesOrPubkey\": \"1,2,3\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://beaconcha.in/api/v1/validator?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"indicesOrPubkey\": \"1,2,3\"\n}"

response = http.request(request)
puts response.read_body

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

import requests

url = "https://beaconcha.in/api/v1/validator?apikey="

payload = { "indicesOrPubkey": "1,2,3" }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({indicesOrPubkey: '1,2,3'})
};

fetch('https://beaconcha.in/api/v1/validator?apikey=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://beaconcha.in/api/v1/validator?apikey=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'indicesOrPubkey' => '1,2,3'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://beaconcha.in/api/v1/validator?apikey="

	payload := strings.NewReader("{\n  \"indicesOrPubkey\": \"1,2,3\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://beaconcha.in/api/v1/validator?apikey=")
  .header("Content-Type", "application/json")
  .body("{\n  \"indicesOrPubkey\": \"1,2,3\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://beaconcha.in/api/v1/validator?apikey=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"indicesOrPubkey\": \"1,2,3\"\n}"

response = http.request(request)
puts response.read_body

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

Introduction

V2 API Docs

V1 API Docs

Validators overview (POST)

Authorizations

Body

Response