Skip to main content
POST
/
api
/
v2
/
machine-metrics
Machine Metrics
curl --request POST \
  --url https://beaconcha.in/api/v2/machine-metrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "range": {
    "timestamp": {
      "start": 0,
      "end": 2147483647
    }
  },
  "machines": [
    "<string>"
  ],
  "cursor": "",
  "page_size": 10
}
'
{
  "data": {
    "system_metrics": [
      {
        "timestamp": 1,
        "machine": "<string>",
        "exporter_version": "<string>",
        "cpu_cores": 123,
        "cpu_threads": 123,
        "cpu_node_system_seconds_total": 123,
        "cpu_node_user_seconds_total": 123,
        "cpu_node_iowait_seconds_total": 123,
        "cpu_node_idle_seconds_total": 123,
        "memory_node_bytes_total": 123,
        "memory_node_bytes_free": 123,
        "memory_node_bytes_cached": 123,
        "memory_node_bytes_buffers": 123,
        "disk_node_bytes_total": 123,
        "disk_node_bytes_free": 123,
        "disk_node_io_seconds": 123,
        "disk_node_reads_total": 123,
        "disk_node_writes_total": 123,
        "network_node_bytes_total_receive": 123,
        "network_node_bytes_total_transmit": 123,
        "misc_node_boot_ts_seconds": 123,
        "misc_os": "<string>"
      }
    ],
    "validator_metrics": [
      {
        "timestamp": 1,
        "machine": "<string>",
        "exporter_version": "<string>",
        "cpu_process_seconds_total": 123,
        "memory_process_bytes": 123,
        "client_name": "<string>",
        "client_version": "<string>",
        "client_build": 123,
        "sync_eth2_fallback_configured": true,
        "sync_eth2_fallback_connected": true,
        "validator_total": 123,
        "validator_active": 123
      }
    ],
    "node_metrics": [
      {
        "timestamp": 1,
        "machine": "<string>",
        "exporter_version": "<string>",
        "cpu_process_seconds_total": 123,
        "memory_process_bytes": 123,
        "client_name": "<string>",
        "client_version": "<string>",
        "client_build": 123,
        "sync_eth2_fallback_configured": true,
        "sync_eth2_fallback_connected": true,
        "disk_beaconchain_bytes_total": 123,
        "network_libp2p_bytes_total_receive": 123,
        "network_libp2p_bytes_total_transmit": 123,
        "network_peers_connected": 123,
        "sync_eth1_connected": true,
        "sync_eth2_synced": true,
        "sync_beacon_head_slot": 123,
        "sync_eth1_fallback_configured": true,
        "sync_eth1_fallback_connected": true
      }
    ]
  },
  "paging": {
    "next_cursor": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt

Use this file to discover all available pages before exploring further.

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
Unix Timestamp · object
required

Time window to query via unix timestamps. Maximum range is 31 days (data retention limit). Data is returned at per-minute granularity, downsampled for large ranges.

machines
string[]

Optional list of machine names to filter by (max 20). If omitted, metrics for all machines are returned.

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

Response

Successful response.

Machine metrics grouped into system_metrics, validator_metrics, and node_metrics arrays. Each array is independently ordered by timestamp DESC, then machine ASC, and paginated toward older data.

data
object
required
paging
object