Getting Started

import requests

response = requests.post(
    "https://beaconcha.in/api/v2/ethereum/state",
    headers={
        "Authorization": "Bearer <YOUR_API_KEY>",
        "Content-Type": "application/json"
    },
    json={"chain": "mainnet"}
)
print(response.json())

const response = await fetch("https://beaconcha.in/api/v2/ethereum/state", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ chain: "mainnet" })
});
const data: {
  data: {
    chain_health: { is_finalizing: boolean };
    chain_view: Record<string, unknown>;
    data_freshness: { slot_lag: number; finality_slot_lag: number };
  };
} = await response.json();
console.log(data);

const response = await fetch("https://beaconcha.in/api/v2/ethereum/state", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ chain: "mainnet" })
});
const data = await response.json();
console.log(data);

import requests

API_KEY = "<YOUR_API_KEY>"
BASE_URL = "https://beaconcha.in"

response = requests.post(
    f"{BASE_URL}/api/v2/ethereum/validators/rewards-list",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "validator": {"validator_identifiers": [1]},
        "chain": "mainnet",
        "page_size": 10,
        "epoch": 347566
    }
)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Error {response.status_code}: {response.json()}")

const API_KEY = "<YOUR_API_KEY>";
const BASE_URL = "https://beaconcha.in";

interface RewardsResponse {
  data: Array<{
    validator: { index: number; public_key: string };
    total: string;
    total_reward: string;
    total_penalty: string;
  }>;
  paging: { next_cursor?: string };
}

async function getValidatorRewards(): Promise<RewardsResponse> {
  const response = await fetch(
    `${BASE_URL}/api/v2/ethereum/validators/rewards-list`,
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${API_KEY}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        validator: { validator_identifiers: [1] },
        chain: "mainnet",
        page_size: 10,
        epoch: 347566
      })
    }
  );

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`API error ${response.status}: ${error.error}`);
  }

  return response.json();
}

const API_KEY = "<YOUR_API_KEY>";
const BASE_URL = "https://beaconcha.in";

async function getValidatorRewards() {
  const response = await fetch(
    `${BASE_URL}/api/v2/ethereum/validators/rewards-list`,
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${API_KEY}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        validator: { validator_identifiers: [1] },
        chain: "mainnet",
        page_size: 10,
        epoch: 347566
      })
    }
  );

  if (!response.ok) {
    const error = await response.json();
    throw new Error(`API error ${response.status}: ${error.error}`);
  }

  return response.json();
}