/v1/finality
Finalized & justified checkpoints with lag behind head
Try it live
10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.
It works. Grab an API key and use it in your project.
Get an API keyCode snippets
curl "https://api.oanor.com/beaconchain-api/v1/finality" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/beaconchain-api/v1/finality", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/beaconchain-api/v1/finality");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
"https://api.oanor.com/beaconchain-api/v1/finality",
headers={"x-oanor-key": "oanor_test_..."}
)
Example response
A real response from this endpoint, captured by the latest health check.
{
"data": {
"note": "The Beacon Chain's finality checkpoints in detail. finalized is the last irreversibly-finalized epoch; current_justified and previous_justified are the two most recent justified checkpoints (justification is the step before finalization). epochs_behind_head and finality_lag_minutes show how far behind the live head finality is — normally two epochs (~13 minutes); if it climbs, the chain is failing to finalize. healthy flags a lag of four epochs or fewer. Live, cached ~30s.",
"source": "public Ethereum consensus-layer (Beacon) API, keyless",
"healthy": true,
"finalized": {
"root": "0xaa44e9be9e04be1c83c61a300eb3ed82e6e1179d42ff00226959abbed14278c1",
"epoch": 454429,
"epochs_behind_head": 2
},
"head_epoch": 454431,
"current_justified": {
"root": "0xe31bb7dc26ac89333cc3637d285dec3fa0c34418fe25c3de0c19512a6462b3ee",
"epoch": 454430,
"epochs_behind_head": 1
},
"previous_justified": {
"root": "0xaa44e9be9e04be1c83c61a300eb3ed82e6e1179d42ff00226959abbed14278c1",
"epoch": 454429,
"epochs_behind_head": 2
},
"finality_lag_epochs": 2,
"finality_lag_minutes": 12.8
},
"meta": {
"timestamp": "2026-06-13T04:42:53.641Z",
"request_id": "f8443924-8eee-4b79-83bd-d262f72b87ed"
},
"status": "ok",
"message": "Finality retrieved successfully",
"success": true
}