Naar de inhoud
GET /v1/leaderboard

Top players for a perf

Probeer het live

10 gratis calls per dag — geen registratie, geen API-key. Loopt via de oanor-gateway.

Aangepaste headers (optioneel)
api.oanor.com/lichess-api

Het werkt. Haal een API-key op en gebruik hem in je project.

Verkrijg een API-sleutel

Codefragmenten

curl "https://api.oanor.com/lichess-api/v1/leaderboard" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/lichess-api/v1/leaderboard", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/lichess-api/v1/leaderboard");
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/lichess-api/v1/leaderboard",
    headers={"x-oanor-key": "oanor_test_..."}
)

Voorbeeldrespons

Een echte respons van dit endpoint, vastgelegd bij de laatste health check.

{
    "data": {
        "perf": "blitz",
        "count": 10,
        "users": [
            {
                "id": "asdert9",
                "online": false,
                "rating": 3042,
                "progress": 11,
                "username": "asdert9"
            },
            {
                "id": "wonderland305",
                "online": false,
                "rating": 3017,
                "progress": -1,
                "username": "wonderland305"
            },
            {
                "id": "cutemouse83",
                "title": "GM",
                "online": false,
                "rating": 2989,
                "progress": 12,
                "username": "cutemouse83"
            },
            {
                "id": "lu_shanglei",
                "online": false,
                "rating": 2944,
                "progress": -19,
                "username": "Lu_Shanglei"
            },
            {
                "id": "ivy_25",
                "online": false,
                "rating": 2937,
                "progress": 26,
                "username": "ivy_25"
            },
            {
                "id": "polyclinical",
                "online": false,
                "rating": 2928,
                "progress": 7,
                "username": "Polyclinical"
            },
            {
                "id": "fmshawnrl123",
                "title": "GM",
                "online": false,
                "rating": 2928,
                "progress": 3,
                "username": "fmshawnrl123"
            },
            {
                "id": "gmbrewchess",
                "title": "GM",
                "online": true,
                "rating": 2925,
                "progress": 14,
                "username": "gmbrewchess"
            },
            {
                "id": "may6enexttime",
                "title": "GM",
                "online": true,
                "rating": 2923,
                "progress": -20,
                "username": "may6enexttime"
            },
            {
                "id": "functionjunkie",
                "online": false,
                "rating": 2923,
                "progress": -18,
                "username": "FunctionJunkie"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-07T16:46:57.319Z",
        "request_id": "5d24a9bc-6310-416b-abdd-ff4a95ee677d"
    },
    "status": "ok",
    "message": "Leaderboard retrieved successfully",
    "success": true
}