Network Performance

curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/performance-aggregate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "range": {},
  "chain": "mainnet"
}
'

import requests

url = "https://beaconcha.in/api/v2/ethereum/performance-aggregate"

payload = {
    "range": {},
    "chain": "mainnet"
}
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({range: {}, chain: 'mainnet'})
};

fetch('https://beaconcha.in/api/v2/ethereum/performance-aggregate', 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/performance-aggregate",
  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([
    'range' => [
        
    ],
    'chain' => 'mainnet'
  ]),
  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/performance-aggregate"

	payload := strings.NewReader("{\n  \"range\": {},\n  \"chain\": \"mainnet\"\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/performance-aggregate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"range\": {},\n  \"chain\": \"mainnet\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://beaconcha.in/api/v2/ethereum/performance-aggregate")

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  \"range\": {},\n  \"chain\": \"mainnet\"\n}"

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

{
  "data": {
    "beaconscore": {
      "total": 0.5,
      "attestation": 0.5,
      "proposal": 0.5,
      "sync_committee": 0.5
    },
    "duties": {
      "attestation": {
        "included": 123,
        "assigned": 123,
        "correct_head": 123,
        "correct_source": 123,
        "correct_target": 123,
        "valuable_correct_head": 123,
        "valuable_correct_source": 123,
        "valuable_correct_target": 123,
        "avg_inclusion_delay": 1.2,
        "avg_inclusion_delay_excluding_missed_slots": 1.2,
        "missed": 123
      },
      "sync_committee": {
        "successful": 1,
        "assigned": 1,
        "missed": 1,
        "missed_including_missed_slots": 1,
        "scheduled": 1
      },
      "proposal": {
        "successful": 123,
        "assigned": 123,
        "missed": 123,
        "included_slashings": 123
      }
    },
    "finality": "finalized"
  },
  "range": {
    "slot": {
      "start": 1,
      "end": 1
    },
    "epoch": {
      "start": 1,
      "end": 1
    },
    "timestamp": {
      "start": 1,
      "end": 1
    }
  }
}

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

Statistics

Network Performance

Returns aggregated performance metrics for the entire network in the given time range.

Use case guide: Entity benchmarking uses this endpoint as the network baseline for public and private validator-set comparisons.

Must provide either start + end times or epochs

Custom time ranges: Query arbitrary time ranges using Unix timestamps, epochs, or slots — exclusively for Scale and Enterprise plans. Custom ranges are served at whole-UTC-day granularity (partial days are rounded outward), and the response range reports the actual covered range.

POST

api

ethereum

performance-aggregate

Network Performance

curl --request POST \
  --url https://beaconcha.in/api/v2/ethereum/performance-aggregate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "range": {},
  "chain": "mainnet"
}
'

import requests

url = "https://beaconcha.in/api/v2/ethereum/performance-aggregate"

payload = {
    "range": {},
    "chain": "mainnet"
}
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({range: {}, chain: 'mainnet'})
};

fetch('https://beaconcha.in/api/v2/ethereum/performance-aggregate', 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/performance-aggregate",
  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([
    'range' => [
        
    ],
    'chain' => 'mainnet'
  ]),
  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/performance-aggregate"

	payload := strings.NewReader("{\n  \"range\": {},\n  \"chain\": \"mainnet\"\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/performance-aggregate")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"range\": {},\n  \"chain\": \"mainnet\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://beaconcha.in/api/v2/ethereum/performance-aggregate")

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  \"range\": {},\n  \"chain\": \"mainnet\"\n}"

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

{
  "data": {
    "beaconscore": {
      "total": 0.5,
      "attestation": 0.5,
      "proposal": 0.5,
      "sync_committee": 0.5
    },
    "duties": {
      "attestation": {
        "included": 123,
        "assigned": 123,
        "correct_head": 123,
        "correct_source": 123,
        "correct_target": 123,
        "valuable_correct_head": 123,
        "valuable_correct_source": 123,
        "valuable_correct_target": 123,
        "avg_inclusion_delay": 1.2,
        "avg_inclusion_delay_excluding_missed_slots": 1.2,
        "missed": 123
      },
      "sync_committee": {
        "successful": 1,
        "assigned": 1,
        "missed": 1,
        "missed_including_missed_slots": 1,
        "scheduled": 1
      },
      "proposal": {
        "successful": 123,
        "assigned": 123,
        "missed": 123,
        "included_slashings": 123
      }
    },
    "finality": "finalized"
  },
  "range": {
    "slot": {
      "start": 1,
      "end": 1
    },
    "epoch": {
      "start": 1,
      "end": 1
    },
    "timestamp": {
      "start": 1,
      "end": 1
    }
  }
}

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

range

Fixed Window · object

required

Specify a date range to receive aggregated data for that period — ideal for use cases like daily income tracking for income reporting.

Arbitrary time ranges — using Unix timestamps, epochs, or slots — are supported exclusively for Scale and Enterprise plans.

Arbitrary ranges are served at whole-UTC-day granularity: a range that covers only part of a UTC day is expanded outward so every UTC day it touches is returned in full. The response range reports the range actually covered by the returned data — it can be wider than requested (outward day expansion) or narrower (leading or trailing days with no data for the selected validators are not included).

Fixed Window
💎 Unix Timestamp
💎 Epoch
💎 Slot

Show child attributes

chain

enum<string>

default:mainnet

The Ethereum chain to query.

Available options:

mainnet,

hoodi

Response

Successful response.

Response containing performance summary information of the entire network.

data

object

required

Show child attributes

range

object

required

The time span actually covered by the returned results — from the first to the last matching data point — specified in slots, epochs, and Unix timestamps.

This reflects the data that was found, not the range that was queried. When no data is found, it falls back to the requested range, or to the full available history if no range was given.

For arbitrary (custom) time-range queries the queried range is expanded outward to whole UTC days, so the covered range may be wider than requested. As stated above, the reported range still reflects the data that was actually found — a touched UTC day with no data for the selected validators will not extend it.

Show child attributes

Introduction

V2 API Docs

V1 API Docs

Network Performance

Authorizations

Body

Response