Validator Queue Compounding Switch Details

curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "validator": {
    "validator_identifiers": [
      1
    ]
  },
  "chain": "mainnet",
  "cursor": "",
  "page_size": 10,
  "status_filter": "rejected"
}
'

import requests

url = "https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches"

payload = {
    "validator": { "validator_identifiers": [1] },
    "chain": "mainnet",
    "cursor": "",
    "page_size": 10,
    "status_filter": "rejected"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    validator: {validator_identifiers: [1]},
    chain: 'mainnet',
    cursor: '',
    page_size: 10,
    status_filter: 'rejected'
  })
};

fetch('https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches', 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/v2/ethereum/validators/queues/compounding-switches",
  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([
    'validator' => [
        'validator_identifiers' => [
                1
        ]
    ],
    'chain' => 'mainnet',
    'cursor' => '',
    'page_size' => 10,
    'status_filter' => 'rejected'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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/v2/ethereum/validators/queues/compounding-switches"

	payload := strings.NewReader("{\n  \"validator\": {\n    \"validator_identifiers\": [\n      1\n    ]\n  },\n  \"chain\": \"mainnet\",\n  \"cursor\": \"\",\n  \"page_size\": 10,\n  \"status_filter\": \"rejected\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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/v2/ethereum/validators/queues/compounding-switches")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"validator\": {\n    \"validator_identifiers\": [\n      1\n    ]\n  },\n  \"chain\": \"mainnet\",\n  \"cursor\": \"\",\n  \"page_size\": 10,\n  \"status_filter\": \"rejected\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"validator\": {\n    \"validator_identifiers\": [\n      1\n    ]\n  },\n  \"chain\": \"mainnet\",\n  \"cursor\": \"\",\n  \"page_size\": 10,\n  \"status_filter\": \"rejected\"\n}"

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

{
  "data": [
    {
      "validator": {
        "index": 1,
        "public_key": "<string>"
      },
      "status": "rejected",
      "execution_layer": {
        "tx_hash": "<string>",
        "from_address": "<string>"
      },
      "reject_reason": "source_inactive",
      "processed_slot": 123
    }
  ],
  "paging": {
    "next_cursor": "<string>"
  }
}

{
  "error": "Bad request. Please check your input and try again."
}

{
  "error": "Unauthorized. Please provide a valid API key."
}

{
  "error": "endpoint not allowed for your subscription tier. upgrade your subscription at https://beaconcha.in/pricing."
}

{
  "error": "The requested resource was not found."
}

{
  "error": "method not allowed: GET. all public API endpoints use POST."
}

{
  "error": "Rate limit exceeded. Please try again later."
}

{
  "error": "internal server error. please try again later."
}

{
  "error": "An unexpected error occurred."
}

Consolidations

Validator Queue Compounding Switch Details

Returns a paginated list of compounding switch requests for the selected validators.

A compounding switch changes a validator’s withdrawal credential prefix from 0x01 to 0x02, unlocking effective balances above 32 ETH (up to 2048 ETH). Unlike a consolidation, the validator stays active throughout — no exit, no balance transfer.

This endpoint covers self-consolidation requests only (source pubkey equals target pubkey). For cross-validator consolidations where one validator’s balance is merged into another, use /api/v2/ethereum/validators/queues/consolidations.

A pending entry becomes completed or rejected once the consensus layer picks the request up out of the execution-layer contract, which releases at most two requests per block. Unlike consolidations, switches have no intermediate queued phase — they are accepted or rejected immediately at consensus-layer inclusion.

Pending entries appear first. Completed and rejected entries follow, ordered by submission time (most recent first).

Use status_filter to narrow the response to a single status, e.g. only rejected entries.

Use this endpoint alongside the queue overview at /api/v2/ethereum/validators/queues for a complete picture.

Temporary restriction: the validator selector must resolve to no more than 50,000 validators. A larger selection returns 400. Narrow the selection — for example, select a sub-entity instead of a whole entity — or page through it with a set of validator indices. This limit will be raised.

POST

api

ethereum

validators

queues

compounding-switches

Validator Queue Compounding Switch Details

curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "validator": {
    "validator_identifiers": [
      1
    ]
  },
  "chain": "mainnet",
  "cursor": "",
  "page_size": 10,
  "status_filter": "rejected"
}
'

import requests

url = "https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches"

payload = {
    "validator": { "validator_identifiers": [1] },
    "chain": "mainnet",
    "cursor": "",
    "page_size": 10,
    "status_filter": "rejected"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    validator: {validator_identifiers: [1]},
    chain: 'mainnet',
    cursor: '',
    page_size: 10,
    status_filter: 'rejected'
  })
};

fetch('https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches', 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/v2/ethereum/validators/queues/compounding-switches",
  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([
    'validator' => [
        'validator_identifiers' => [
                1
        ]
    ],
    'chain' => 'mainnet',
    'cursor' => '',
    'page_size' => 10,
    'status_filter' => 'rejected'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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/v2/ethereum/validators/queues/compounding-switches"

	payload := strings.NewReader("{\n  \"validator\": {\n    \"validator_identifiers\": [\n      1\n    ]\n  },\n  \"chain\": \"mainnet\",\n  \"cursor\": \"\",\n  \"page_size\": 10,\n  \"status_filter\": \"rejected\"\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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/v2/ethereum/validators/queues/compounding-switches")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"validator\": {\n    \"validator_identifiers\": [\n      1\n    ]\n  },\n  \"chain\": \"mainnet\",\n  \"cursor\": \"\",\n  \"page_size\": 10,\n  \"status_filter\": \"rejected\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://beaconcha.in/api/v2/ethereum/validators/queues/compounding-switches")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"validator\": {\n    \"validator_identifiers\": [\n      1\n    ]\n  },\n  \"chain\": \"mainnet\",\n  \"cursor\": \"\",\n  \"page_size\": 10,\n  \"status_filter\": \"rejected\"\n}"

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

{
  "data": [
    {
      "validator": {
        "index": 1,
        "public_key": "<string>"
      },
      "status": "rejected",
      "execution_layer": {
        "tx_hash": "<string>",
        "from_address": "<string>"
      },
      "reject_reason": "source_inactive",
      "processed_slot": 123
    }
  ],
  "paging": {
    "next_cursor": "<string>"
  }
}

{
  "error": "Bad request. Please check your input and try again."
}

{
  "error": "Unauthorized. Please provide a valid API key."
}

{
  "error": "endpoint not allowed for your subscription tier. upgrade your subscription at https://beaconcha.in/pricing."
}

{
  "error": "The requested resource was not found."
}

{
  "error": "method not allowed: GET. all public API endpoints use POST."
}

{
  "error": "Rate limit exceeded. Please try again later."
}

{
  "error": "internal server error. please try again later."
}

{
  "error": "An unexpected error occurred."
}

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.

Indices/Pubkeys
Dashboard
💎 Deposit
💎 Withdrawal
💎 Entity

Show child attributes

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

Filter results to a single compounding switch status. If not specified, results include all statuses.

pending: recorded on the execution layer; not yet included by the consensus layer.
completed: the switch was applied.
rejected: rejected at consensus-layer inclusion.

Available options:

pending,

completed,

rejected

Example:

"rejected"

Response

Successful response.

data

object[]

required

Show child attributes

paging

object

required

Show child attributes

Introduction

V2 API Docs

V1 API Docs

Validator Queue Compounding Switch Details

Authorizations

Body

Response