Skip to content
GET /v1/leaderboard

Top TETRA LEAGUE players

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/tetrio-api

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

Get an API key

Code snippets

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

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 25,
        "source": "TETR.IO",
        "leaderboard": [
            {
                "tr": 24834.84,
                "vs": 472.87,
                "apm": 241.75,
                "pps": 4.33,
                "rank": "x+",
                "country": "KR",
                "position": 1,
                "username": "frozenaccount"
            },
            {
                "tr": 24795.6,
                "vs": 441.92,
                "apm": 220.38,
                "pps": 3.82,
                "rank": "x+",
                "country": "US",
                "position": 2,
                "username": "blaarg"
            },
            {
                "tr": 24727.19,
                "vs": 437.19,
                "apm": 223.82,
                "pps": 3.91,
                "rank": "x+",
                "country": "US",
                "position": 3,
                "username": "caboozled_pie"
            },
            {
                "tr": 24711.3,
                "vs": 425.11,
                "apm": 211.12,
                "pps": 3.78,
                "rank": "x+",
                "country": "PH",
                "position": 4,
                "username": "vincehd"
            },
            {
                "tr": 24687.82,
                "vs": 408.12,
                "apm": 212.54,
                "pps": 3.81,
                "rank": "x+",
                "country": "CN",
                "position": 5,
                "username": "kafe11"
            },
            {
                "tr": 24667.38,
                "vs": 390.96,
                "apm": 201.19,
                "pps": 3.6,
                "rank": "x+",
                "country": "KR",
                "position": 6,
                "username": "turtle"
            },
            {
                "tr": 24645.08,
                "vs": 412.82,
                "apm": 204.99,
                "pps": 3.75,
                "rank": "x+",
                "country": "US",
                "position": 7,
                "username": "flyingdiarrhea"
            },
            {
                "tr": 24626.37,
                "vs": 383.52,
                "apm": 197.32,
                "pps": 3.47,
                "rank": "x+",
                "country": "PH",
                "position": 8,
                "username": "tiki2tgt"
            },
            {
                "tr": 24623.08,
                "vs": 384.46,
                "apm": 194.99,
                "pps": 3.55,
                "rank": "x+",
                "country": "CA",
                "position": 9,
                "username": "___sh4rk"
            },
            {
                "tr": 24615.97,
                "vs": 415.8,
                "apm": 216.96,
                "pps": 4.21,
                "rank": "x+",
                "country": "NU",
                "position": 10,
                "username": "promooooooo"
            },
            {
                "tr": 24589.43,
              
…