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>"
}
}Retrieve machine monitoring metrics for the authenticated user. Returns system, validator client, and beacon node metrics
that were previously pushed via the --monitoring-endpoint flag and set up via https://beaconcha.in/user/settings#app.
Users can only access metrics belonging to their own API key. Optionally filter by one or more machine names.
Provide a time range via unix timestamps to query a specific historical window (maximum 31 days, limited by data retention). Each array is ordered newest first, then paginated toward older data.
Pagination uses an opaque continuation token that tracks the last emitted (timestamp, machine) tuple separately for
system_metrics, validator_metrics, and node_metrics. Clients must treat paging.next_cursor as opaque.
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.
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.
Show child attributes
Optional list of machine names to filter by (max 20). If omitted, metrics for all machines are returned.
Cursor value for pagination. See our pagination guide for more details.
The number of items to return per page.
1 <= x <= 10Was this page helpful?