Skip to content
GET /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.

Custom headers (optional)
api.oanor.com/beaconchain-api

It works. Grab an API key and use it in your project.

Get an API key

Code 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
}