THE FINALS API

THE FINALS

Leaderboards of every season and mode, player profiles with rank history, daily movers, the ban list, clubs, name changes, the Hall of Fame and the whole item database — the same data that powers thefinals.arenyze.com.
Ranked boards refresh every few minutes from Embark; player history snapshots are taken every 20 minutes. Asset paths in responses (images, icons) are relative to https://thefinals.arenyze.com.

Base URLhttps://public-api.arenyze.com/thefinals/api

Players11 endpoints

Player profile

Current rank, score and league on the live Ranked board, best placements of every season and mode, platform handles, club and former names.

GET/player/{name}

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/player/Balise%232431" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/player/Balise%232431", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/player/Balise%232431",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "embarkName": "Balise#2431",
  "displayName": "Balise",
  "slug": "balise",
  "formerNames": [
    {
      "name": "Balise#9424",
      "handle": "Balise",
      "platform": "steam",
      "since": "2026-08-23T05:14:18.159Z"
    },
    {
      "name": "Balise",
      "handle": "Balise",
      "platform": "steam",
      "since": "2026-09-22T01:33:43.968Z"
    }
  ],
  "steamName": "Balise",
  "psnName": "BaliseTV",
  "xboxName": "",
  "clubTag": "VGG",
  "currentRank": 47,
  "currentScore": 54011,
  "currentLeague": "Diamond 1",
  "currentRankFormer": false,
  "bestRank": 1,
  "appearances": [
    {
      "leaderboardId": "s12",
      "platform": "crossplay",
      "season": "s12",
      "mode": "",
      "label": "Season 12",
      "live": true,
      "active": true,
      "rank": 47,
      "change": 5,
      "score": 54011,
      "scoreLabel": "RS",
      "league": "Diamond 1",
      "leagueNumber": 20,
      "clubTag": "BERGR",
      "underName": "Balise#2431"
    },
    {
      "leaderboardId": "s12worldtour",
      "platform": "crossplay",
      "season": "s12",
      "mode": "worldtour",
      "label": "Season 12 · World Tour",
      "live": true,
      "active": true,
      "rank": 872,
      "change": 0,
      "score": 9869199,
      "scoreLabel": "Cashouts",
      "league": null,
      "leagueNumber": null,
      "clubTag": "BERGR",
      "underName": "Balise#2431"
    },
    "… 40 more"
  ],
  "currentSeason": {
    "id": "s12",
    "label": "Season 12"
  },
  "fetchedAt": "2026-11-03T01:37:23.802Z",
  "searchCount": 341,
  "badges": [
    {
      "id": "goat",
      "cat": "legends",
      "tier": "legendary",
      "name": "The GOAT",
      "label": "The GOAT",
      "count": 1,
      "desc": "#1 of every player since Open Beta.",
      "how": "Be #1 on the all-time Legacy Index.",
      "image": "/assets/badges/goat.svg?v=2",
      "pct": 0.00027643400138217,
      "rarity": "Mythic"
    },
    {
      "id": "champion",
      "cat": "ranked",
      "tier": "legendary",
      "name": "Champion",
      "label": "Champion",
      "count": 1,
      "desc": "Finished #1: S5.",
      "how": "Finish a Ranked season at #1.",
      "image": "/assets/badges/champion.svg?v=2",
      "pct": 0.0027643400138217,
      "rarity": "Mythic"
    },
    "… 28 more"
  ]
}

Try it

name *path

Rank history

Snapshots of rank, score and league over time — the data behind the rank graph. One point every 20 minutes while the player is on the board.

GET/player/{name}/history

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

daysintegerquery

Window in days (default 30, max 90).

boardstringquery

Leaderboard id (default: the live Ranked board).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/history?days=7" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/player/Balise%232431/history?days=7", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/history?days=7",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "embarkName": "Balise#2431",
  "days": 7,
  "retentionDays": 90,
  "board": {
    "id": "s12",
    "label": "Season 12",
    "mode": "",
    "live": true,
    "scoreLabel": "RS"
  },
  "total": 56,
  "since": "2026-10-21T17:35:16.231Z",
  "history": [
    {
      "recorded_at": "2026-10-27T19:14:23.231Z",
      "rank": 36,
      "score": 51866,
      "league": "Diamond 1"
    },
    {
      "recorded_at": "2026-10-27T19:38:42.164Z",
      "rank": 35,
      "score": 51966,
      "league": "Diamond 1"
    },
    "… 18 more"
  ]
}

Try it

name *pathdaysqueryboardquery

Insights

Standings on every live board with percentile, players ahead and behind, distance to the next league and the median score.

GET/player/{name}/insights

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/insights" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/player/Balise%232431/insights", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/insights",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "embarkName": "Balise#2431",
  "primaryBoard": {
    "leaderboardId": "s12",
    "platform": "crossplay",
    "label": "Season 12",
    "mode": "",
    "scoreLabel": "RS"
  },
  "standings": [
    {
      "leaderboardId": "s12",
      "platform": "crossplay",
      "label": "Season 12",
      "mode": "",
      "live": true,
      "active": true,
      "rank": 47,
      "score": 54011,
      "scoreLabel": "RS",
      "league": "Diamond 1",
      "totalPlayers": 10000,
      "playersAhead": 46,
      "playersBehind": 9953,
      "percentile": 0.5,
      "medianScore": 36846,
      "nextLeague": null,
      "top500": {
        "at": 500,
        "score": 45270,
        "needed": 0,
        "reached": true
      },
      "top1000": {
        "at": 1000,
        "score": 42503,
        "needed": 0,
        "reached": true
      }
    },
    {
      "leaderboardId": "s12worldtour",
      "platform": "crossplay",
      "label": "Season 12 · World Tour",
      "mode": "worldtour",
      "live": true,
      "active": true,
      "rank": 872,
      "score": 9869199,
      "scoreLabel": "Cashouts",
      "league": null,
      "totalPlayers": 10000,
      "playersAhead": 871,
      "playersBehind": 9128,
      "percentile": 8.7,
      "medianScore": 6438095,
      "nextLeague": null,
      "top500": {
        "at": 500,
        "score": 11091905,
        "needed": 1222706,
        "reached": false
      },
      "top1000": {
        "at": 1000,
        "score": 9597754,
        "needed": 0,
        "reached": true
      }
    },
    "… 1 more"
  ],
  "rivals": {
    "above": [
      {
        "embarkName": "Turbo#3497",
        "rank": 44,
        "score": 54335,
        "league": "Diamond 1",
        "clubTag": "SYPHN"
      },
      {
        "embarkName": "Eshayy#3556",
        "rank": 45,
        "score": 54164,
        "league": "Diamond 1",
        "clubTag": "MTHRY"
      },
      "… 1 more"
    ],
    "below": [
      {
        "embarkName": "Shadow#0466",
        "rank": 48,
        "score": 53869,
        "league": "Diamond 1",
        "clubTag": "LIAR"
      },
      {
        "embarkName": "Demon#0377",
        "rank": 49,
        "score": 53826,
        "league": "Diamond 1",
        "clubTag": "1PEEK"
      },
      "… 1 more"
    ],
    "overtakes": {
      "by": [
        {
          "embarkName": "Turbo#3497",
          "rank": 44,
          "was": 142,
          "wasAt": "2026-10-27T01:58:11.406Z"
        },
        {
          "embarkName": "Eshayy#3556",
          "rank": 45,
          "was": 67,
          "wasAt": "2026-10-27T05:12:08.831Z"
        },
        "… 1 more"
      ],
      "of": [],
      "windowDays": 7,
      "since": "2026-10-27T19:14:23.231Z",
      "myRankThen": 36
    }
  },
  "club": {
    "clubTag": "BERGR",
    "members": 3,
    "placeInClub": 1,
    "avgScore": 43863,
    "vsAverage": 10148,
    "best": {
      "embarkName": "Balise#2431",
      "rank": 47,
      "score": 54011
    },
    "core": [
      {
        "embarkName": "Balise#2431",
        "rank": 47,
        "score": 54011
      },
      {
        "embarkName": "Fotuz#5366",
        "rank": 926,
        "score": 42739
      },
      "… 1 more"
    ]
  },
  "activity": {
    "leaderboardId": "s12",
    "windowFrom": "2026-10-21T17:35:16.231Z",
    "windowTo": "2026-11-02T23:56:36.817Z",
    "moves": 55,
    "activeDays": 10,
    "spanDays": 13,
    "currentStreak": 1,
    "longestStreak": 7,
    "net": 8429,
    "avgPerActiveDay": 843,
    "bestDay": {
      "day": "2026-10-22",
      "delta": 2352
    },
    "worstDay": {
      "day": "2026-10-27",
      "delta": -455
    },
    "lastMoveAt": "2026-11-02T23:56:36.817Z",
    "daysSinceLastMove": 0,
    "hours": [
      2,
      0,
      "… 22 more"
    ],
    "days": [
      {
        "day": "2026-10-21",
        "delta": 1438
      },
      {
        "day": "2026-10-22",
        "delta": 2352
      },
      "… 8 more"
    ]
  },
  "peaks": {
    "leaderboardId": "s12",
    "peakRank": 8,
    "peakRankAt": "2026-10-21T22:20:49.753Z",
    "peakScore": 54089,
    "peakScoreAt": "2026-11-02T23:36:10.747Z",
    "bestMove": {
      "at": "2026-10-24T20:40:22.789Z",
      "delta": 534
    },
    "worstMove": {
      "at": "2026-10-21T23:07:24.113Z",
      "delta": -452
    },
    "firstTop500": "2026-10-21T17:35:16.231Z",
    "firstTop1000": "2026-10-21T17:35:16.231Z",
    "leagueDays": [
      {
        "league": "Diamond 1",
        "days": 10,
        "rank": 20
      },
      {
        "league": "Diamond 2",
        "days": 2,
        "rank": 19
      }
    ]
  },
  "bestRankAllTime": 1
}

Try it

name *path

Name changes

The renames detected for a player, with the platform handle that linked the two names.

GET/player/{name}/events

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/events" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/player/Balise%232431/events", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/events",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "embarkName": "Balise#2431",
  "formerNames": [
    {
      "name": "Balise#9424",
      "handle": "Balise",
      "platform": "steam",
      "since": "2026-08-23T05:14:18.159Z"
    },
    {
      "name": "Balise",
      "handle": "Balise",
      "platform": "steam",
      "since": "2026-09-22T01:33:43.968Z"
    }
  ],
  "events": [
    {
      "kind": "name-change",
      "occurredAt": "2026-09-22T01:33:43.987Z",
      "embarkName": "Balise#2431",
      "prevName": "Balise",
      "handle": "Balise",
      "platform": "steam"
    },
    {
      "kind": "name-change",
      "occurredAt": "2026-08-23T05:14:18.178Z",
      "embarkName": "Balise#2431",
      "prevName": "Balise#9424",
      "handle": "Balise",
      "platform": "steam"
    }
  ]
}

Try it

name *path

Club activity

Joins, departures and big moves of the members of the player’s club over the last days.

GET/player/{name}/club-events

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/club-events" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/player/Balise%232431/club-events", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/club-events",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "clubTag": "VGG",
  "embarkName": "Balise#2431",
  "events": [
    {
      "day": "2026-10-31",
      "type": "joined",
      "embarkName": "Maria#6357",
      "displayName": "Maria",
      "slug": "maria",
      "rank": 2816,
      "prevRank": null,
      "rankDelta": null,
      "score": 38402,
      "scoreDelta": null,
      "league": "Platinum 1",
      "prevLeague": null
    },
    {
      "day": "2026-10-27",
      "type": "fell",
      "embarkName": "iri#5183",
      "displayName": "iri",
      "slug": "iri",
      "rank": 5620,
      "prevRank": 2495,
      "rankDelta": -3125,
      "score": 35112,
      "scoreDelta": -2535,
      "league": "Platinum 2",
      "prevLeague": "Platinum 1"
    },
    "… 1 more"
  ]
}

Try it

name *path

Ban status

{ "ban": null } for a clean player, otherwise the ban record (see Bans).

GET/player/{name}/ban

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/ban" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/player/Balise%232431/ban", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/player/Balise%232431/ban",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "ban": null
}

Try it

name *path

Compare two players

Side-by-side metrics of two players: current and best rank, peak score, leagues, seasons played.

GET/compare

Query Parameters

astringqueryrequired

First Embark name.

bstringqueryrequired

Second Embark name.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/compare?a=Balise%232431&b=FitShotgun%236148" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/compare?a=Balise%232431&b=FitShotgun%236148", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/compare?a=Balise%232431&b=FitShotgun%236148",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "a": {
    "embarkName": "Balise#2431",
    "name": "Balise",
    "slug": "balise",
    "clubTag": "VGG",
    "steamName": "Balise",
    "psnName": "BaliseTV",
    "xboxName": "",
    "metrics": {
      "currentRank": 47,
      "currentScore": 54011,
      "currentLeague": "Diamond 1",
      "currentLeagueRank": 20,
      "currentChange": 5,
      "bestRank": 1,
      "peakScore": 125805,
      "peakLeague": "Ruby",
      "peakLeagueRank": 21,
      "avgRank": 36,
      "rankedSeasons": 18,
      "top100": 25,
      "boards": 42
    }
  },
  "b": {
    "embarkName": "FitShotgun#6148",
    "name": "FitShotgun",
    "slug": "fitshotgun",
    "clubTag": "",
    "steamName": "Blu3",
    "psnName": "",
    "xboxName": "",
    "metrics": {
      "currentRank": 3502,
      "currentScore": 38169,
      "currentLeague": "Platinum 1",
      "currentLeagueRank": 16,
      "currentChange": -183,
      "bestRank": 3502,
      "peakScore": 40464,
      "peakLeague": "Diamond 4",
      "peakLeagueRank": 17,
      "avgRank": 6507,
      "rankedSeasons": 5,
      "top100": 0,
      "boards": 8
    }
  },
  "winner": {
    "currentLeagueRank": "a",
    "currentRank": "a",
    "currentScore": "a",
    "currentChange": "a",
    "peakLeagueRank": "a",
    "bestRank": "a",
    "peakScore": "a",
    "avgRank": "a",
    "rankedSeasons": "a",
    "top100": "a",
    "boards": "a"
  }
}

Try it

a *queryb *query

Search players

Prefix search over every tracked player, best matches first.

GET/search

Query Parameters

qstringqueryrequired

At least 2 characters of an Embark name or platform handle.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/search?q=bal" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/search?q=bal", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/search?q=bal",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "query": "bal",
  "players": [
    {
      "embarkName": "Balise#2431",
      "displayName": "Balise",
      "slug": "balise",
      "rank": 47,
      "score": 54011,
      "scoreLabel": "RS",
      "league": "Diamond 1",
      "clubTag": "BERGR",
      "steamName": "Balise",
      "psnName": "TTV-Balise",
      "xboxName": ""
    },
    {
      "embarkName": "Balletikje#2807",
      "displayName": "Balletikje",
      "slug": "balletikje",
      "rank": 372,
      "score": 46498,
      "scoreLabel": "RS",
      "league": "Diamond 2",
      "clubTag": "LZ0",
      "steamName": "Balletikje",
      "psnName": "",
      "xboxName": ""
    },
    "… 12 more"
  ]
}

Try it

q *query

Search everything

Players, clubs and items in one query, with leaderboard filters.

GET/search/global

Query Parameters

qstringqueryrequired

Text to search.

typestringquery

all (default), players, clubs or items.

boardstringquery

Restrict players to a leaderboard id.

leaguestringquery

Filter by league, e.g. Diamond 1.

clubstringquery

Filter by club tag.

platformstringquery

steam, psn or xbox handle.

minRankintegerquery

Best rank at least…

maxRankintegerquery

…and at most.

pageintegerquery

Page number, from 1.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/search/global?q=bal" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/search/global?q=bal", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/search/global?q=bal",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "type": "all",
  "players": {
    "board": {
      "id": "s12",
      "label": "Season 12",
      "scoreLabel": "RS"
    },
    "total": 60,
    "page": 1,
    "perPage": 10,
    "totalPages": 6,
    "players": [
      {
        "embarkName": "Balise#2431",
        "displayName": "Balise",
        "slug": "balise",
        "rank": 47,
        "score": 54011,
        "league": "Diamond 1",
        "clubTag": "BERGR",
        "steamName": "Balise",
        "psnName": "TTV-Balise",
        "xboxName": null
      },
      {
        "embarkName": "Balletikje#2807",
        "displayName": "Balletikje",
        "slug": "balletikje",
        "rank": 372,
        "score": 46498,
        "league": "Diamond 2",
        "clubTag": "LZ0",
        "steamName": "Balletikje",
        "psnName": null,
        "xboxName": null
      },
      "… 8 more"
    ]
  },
  "clubs": {
    "fetchedAt": "2026-11-03T01:36:54.421Z",
    "total": 134,
    "page": 1,
    "perPage": 10,
    "totalPages": 14,
    "clubs": [
      {
        "clubTag": "BALUT",
        "memberCount": 3,
        "boardCount": 1,
        "bestRank": 88
      },
      {
        "clubTag": "BALDG",
        "memberCount": 4,
        "boardCount": 8,
        "bestRank": 111
      },
      "… 8 more"
    ]
  },
  "events": {
    "events": [
      {
        "kind": "name-change",
        "occurredAt": "2026-11-03T01:18:31.272Z",
        "embarkName": "BalletBuzz#1235",
        "prevName": "JohnJew#5192",
        "handle": "Chicken Kirky",
        "platform": "steam",
        "clubTag": "OBW",
        "rank": 8729,
        "score": 7459,
        "league": null
      },
      {
        "kind": "club-transfer",
        "occurredAt": "2026-10-31",
        "embarkName": "Balletikje#2807",
        "displayName": "Balletikje",
        "slug": "balletikje",
        "fromClub": "2X2",
        "toClub": "LZ0",
        "rank": 282,
        "league": "Diamond 2"
      },
      "… 6 more"
    ],
    "page": 1,
    "perPage": 8,
    "total": 397,
    "totalPages": 50
  },
  "overlay": [
    {
      "embarkName": "BALLETGAMER#2880",
      "displayName": "BALLETGAMER",
      "slug": "balletgamer",
      "clubTag": null,
      "overlayMatches": 1,
      "lastSeen": "2026-09-25T20:45:03.927Z"
    },
    {
      "embarkName": "MEGABALLS#2892",
      "displayName": "MEGABALLS",
      "slug": "megaballs",
      "clubTag": "MDNL",
      "overlayMatches": 1,
      "lastSeen": "2026-09-22T11:21:12.743Z"
    }
  ]
}

Try it

q *querytypequeryboardqueryleaguequeryclubqueryplatformqueryminRankquerymaxRankquerypagequery

Resolve a name

Turns any known name into the current canonical Embark name.

GET/resolve

Query Parameters

namestringqueryrequired

Embark name, former name or platform handle.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/resolve?name=Balise" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/resolve?name=Balise", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/resolve?name=Balise",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "found": true,
  "id": "Balise#2431",
  "name": "Balise",
  "slug": "balise",
  "url": "/player/Balise%232431/balise"
}

Try it

name *query

Player directory

The A–Z directory of every player ever seen on a leaderboard, with filters.

GET/players/search

Query Parameters

qstringquery

Name prefix.

activebooleanquery

true = only players on a live board.

minBestintegerquery

Best rank at least…

maxBestintegerquery

…and at most.

minBoardsintegerquery

Present on at least N boards.

pageintegerquery

Page number, from 1.

perPageintegerquery

Results per page (default 50, max 100).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/players/search?q=bal&perPage=3" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/players/search?q=bal&perPage=3", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/players/search?q=bal&perPage=3",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "page": 1,
  "perPage": 20,
  "hasMore": true,
  "filtered": true,
  "players": [
    {
      "embarkName": "01LMABALLZ#7288",
      "slug": "01lmaballz",
      "displayName": "01LMABALLZ",
      "bestRank": 9851,
      "currentRank": null,
      "boardCount": 1,
      "active": false
    },
    {
      "embarkName": "¹Garibaldi Schioppettato",
      "slug": "1garibaldi-schioppettato",
      "displayName": "¹Garibaldi Schioppettato",
      "bestRank": 1257,
      "currentRank": null,
      "boardCount": 2,
      "active": false
    },
    "… 18 more"
  ],
  "directoryTotal": 491445
}

Try it

qqueryactivequeryminBestquerymaxBestqueryminBoardsquerypagequeryperPagequery

Leaderboards5 endpoints

Leaderboard catalog

Every leaderboard id, grouped by season: Ranked, World Tour, Sponsor, Power Shift, Quick Cash, Team Deathmatch, Point Break, Solo Showdown and events.

GET/catalog

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/catalog" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/catalog", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/catalog",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "currentSeason": "s12",
  "total": 85,
  "groups": [
    {
      "season": "cb1",
      "seasonLabel": "Closed Beta 1",
      "live": false,
      "boards": [
        {
          "id": "cb1",
          "mode": "",
          "modeLabel": "Ranked",
          "label": "Closed Beta 1",
          "platforms": [],
          "kind": "leaderboard"
        }
      ]
    },
    {
      "season": "cb2",
      "seasonLabel": "Closed Beta 2",
      "live": false,
      "boards": [
        {
          "id": "cb2",
          "mode": "",
          "modeLabel": "Ranked",
          "label": "Closed Beta 2",
          "platforms": [],
          "kind": "leaderboard"
        }
      ]
    },
    "… 17 more"
  ]
}

Try it

Leaderboard

A full leaderboard page by page: rank, score, league, change, club and platform handles.

GET/leaderboard/{id}/{platform}

Parameters

idstringpathrequired

Leaderboard id from /catalog, e.g. s12 (Ranked), s12worldtour, s12powershift.

platformstringpath

crossplay (default) for current seasons; steam, psn or xbox on older boards that are split by platform.

namestringquery

Filter rows by name (case-insensitive substring).

countbooleanquery

true returns only the totals.

pageintegerquery

Page number, from 1.

perPageintegerquery

Results per page (default 50, max 200).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/leaderboard/s12/crossplay?perPage=3" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/leaderboard/s12/crossplay?perPage=3", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/leaderboard/s12/crossplay?perPage=3",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "meta": {
    "leaderboardId": "s12",
    "platform": "crossplay",
    "season": "s12",
    "mode": "",
    "label": "Season 12",
    "live": true,
    "updatedAt": "2026-11-03T01:18:04.573Z",
    "count": 10000,
    "nameFilter": null,
    "returnCountOnly": false
  },
  "pagination": {
    "page": 1,
    "perPage": 5,
    "total": 10000,
    "totalPages": 2000
  },
  "count": 10000,
  "data": [
    {
      "name": "Bilbil_Danbao#8368",
      "rank": 1,
      "extra": {},
      "score": 62508,
      "change": 0,
      "league": "Diamond 1",
      "clubTag": "SISAO",
      "psnName": "Borlnn",
      "xboxName": "Borlnn",
      "steamName": "Ugmfu",
      "scoreLabel": "RS",
      "leagueNumber": 20
    },
    {
      "name": "Rem#0634",
      "rank": 2,
      "extra": {
        "clubName": "TSM"
      },
      "score": 62272,
      "change": 3,
      "league": "Diamond 1",
      "clubTag": "TSM",
      "psnName": "LCJ_Joey_MPB",
      "xboxName": "",
      "steamName": "",
      "scoreLabel": "RS",
      "leagueNumber": 20
    },
    "… 3 more"
  ]
}

Try it

id *pathplatformpathnamequerycountquerypagequeryperPagequery

Leaderboard statistics

Score distribution of a board: min, max, average, median, top 1 % and the players per league.

GET/leaderboard-stats/{id}/{platform}

Parameters

idstringpathrequired

Leaderboard id from /catalog, e.g. s12 (Ranked), s12worldtour, s12powershift.

platformstringpath

crossplay (default) for current seasons; steam, psn or xbox on older boards that are split by platform.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/leaderboard-stats/s12/crossplay" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/leaderboard-stats/s12/crossplay", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/leaderboard-stats/s12/crossplay",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "meta": {
    "leaderboardId": "s12",
    "platform": "crossplay",
    "season": "s12",
    "mode": "",
    "label": "Season 12",
    "updatedAt": "2026-11-03T01:18:04.573Z",
    "scoreLabel": "RS"
  },
  "totalProfiles": 10000,
  "scored": 10000,
  "score": {
    "min": 33963,
    "max": 62508,
    "avg": 37892,
    "median": 36846,
    "top1pct": 51508
  },
  "leagues": [
    {
      "league": "Diamond 1",
      "count": 278,
      "minScore": 47501,
      "maxScore": 62508,
      "rank": 20,
      "pct": 2.8
    },
    {
      "league": "Diamond 2",
      "count": 257,
      "minScore": 45003,
      "maxScore": 47467,
      "rank": 19,
      "pct": 2.6
    },
    "… 5 more"
  ],
  "histogram": {
    "binSize": 2000,
    "bins": [
      {
        "from": 32000,
        "to": 34000,
        "count": 78,
        "league": "Platinum 3"
      },
      {
        "from": 34000,
        "to": 36000,
        "count": 3679,
        "league": "Platinum 3"
      },
      "… 14 more"
    ]
  }
}

Try it

id *pathplatformpath

Ranks & leagues

Every league with its score range, icon, the share of players in it and the score cut-off of the board.

GET/ranks

Query Parameters

boardstringquery

Leaderboard id (default: live Ranked).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/ranks" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/ranks", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/ranks",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "meta": {
    "leaderboardId": "s12",
    "label": "Season 12",
    "updatedAt": "2026-11-03T01:18:04.573Z",
    "boardCutoff": 33963,
    "totalProfiles": 10000,
    "rsPerDivision": 2500,
    "rubyTop": 500
  },
  "ranks": [
    {
      "league": "Bronze 4",
      "tier": "Bronze",
      "division": 4,
      "slug": "bronze-4",
      "icon": "/assets/img/ranks/bronze-4.png",
      "minScore": 0,
      "maxScore": 2499,
      "scoreBased": true,
      "note": null,
      "players": 0,
      "pct": 0,
      "observedMin": null,
      "observedMax": null
    },
    {
      "league": "Bronze 3",
      "tier": "Bronze",
      "division": 3,
      "slug": "bronze-3",
      "icon": "/assets/img/ranks/bronze-3.png",
      "minScore": 2500,
      "maxScore": 4999,
      "scoreBased": true,
      "note": null,
      "players": 0,
      "pct": 0,
      "observedMin": null,
      "observedMax": null
    },
    "… 19 more"
  ]
}

Try it

boardquery

Community event board

Boards of community events (e.g. seasonal challenges) in the same format as a leaderboard.

GET/community-event/{id}/{platform}

Parameters

idstringpathrequired

Leaderboard id from /catalog, e.g. s12 (Ranked), s12worldtour, s12powershift.

platformstringpath

crossplay (default) for current seasons; steam, psn or xbox on older boards that are split by platform.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/community-event/{id}/{platform}" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/community-event/{id}/{platform}", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/community-event/{id}/{platform}",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Try it

id *pathplatformpath

Seasons & ranked4 endpoints

Seasons

Every season with its boards, entries and champion.

GET/seasons

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/seasons" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/seasons", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/seasons",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "seasons": [
    {
      "season": "s12",
      "label": "Season 12",
      "live": true,
      "boardCount": 8,
      "modes": 7,
      "entries": 80000,
      "rankedId": "s12",
      "champion": {
        "embarkName": "Bilbil_Danbao#8368",
        "displayName": "Bilbil_Danbao",
        "slug": "bilbil-danbao",
        "rank": 1,
        "score": 62508,
        "league": "Diamond 1",
        "clubTag": "SISAO"
      }
    },
    {
      "season": "s11",
      "label": "Season 11",
      "live": false,
      "boardCount": 9,
      "modes": 8,
      "entries": 80010,
      "rankedId": "s11",
      "champion": {
        "embarkName": "John15-18#6786",
        "displayName": "John15-18",
        "slug": "john15-18",
        "rank": 1,
        "score": 71710,
        "league": "Ruby",
        "clubTag": null
      }
    },
    "… 15 more"
  ],
  "currentSeason": "s12"
}

Try it

Season detail

One season: its boards, the top of each and the league split.

GET/seasons/{season}

Parameters

seasonstringpathrequired

Season id, e.g. s12, s11, ob.

topintegerquery

How many top players per board (default 10).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/seasons/s11?top=3" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/seasons/s11?top=3", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/seasons/s11?top=3",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "season": "s11",
  "label": "Season 11",
  "live": false,
  "rankedId": "s11",
  "rankedLabel": "Season 11",
  "scoreLabel": "RankScore",
  "champion": {
    "embarkName": "John15-18#6786",
    "displayName": "John15-18",
    "slug": "john15-18",
    "rank": 1,
    "score": 71710,
    "league": "Ruby",
    "clubTag": null
  },
  "top": [
    {
      "embarkName": "John15-18#6786",
      "displayName": "John15-18",
      "slug": "john15-18",
      "rank": 1,
      "score": 71710,
      "league": "Ruby",
      "clubTag": null
    },
    {
      "embarkName": "BLAD3R#2825",
      "displayName": "BLAD3R",
      "slug": "blad3r",
      "rank": 2,
      "score": 71609,
      "league": "Ruby",
      "clubTag": "APES"
    },
    "… 1 more"
  ],
  "modes": [
    {
      "id": "s11",
      "mode": "",
      "modeLabel": "Ranked",
      "label": "Season 11",
      "platform": "crossplay",
      "scoreLabel": "RankScore",
      "entryCount": 10000,
      "updatedAt": "2026-10-21T17:02:08.080Z",
      "podium": [
        {
          "embarkName": "John15-18#6786",
          "displayName": "John15-18",
          "slug": "john15-18",
          "rank": 1,
          "score": 71710,
          "league": "Ruby",
          "clubTag": null
        },
        {
          "embarkName": "BLAD3R#2825",
          "displayName": "BLAD3R",
          "slug": "blad3r",
          "rank": 2,
          "score": 71609,
          "league": "Ruby",
          "clubTag": "APES"
        },
        "… 1 more"
      ],
      "champion": {
        "embarkName": "John15-18#6786",
        "displayName": "John15-18",
        "slug": "john15-18",
        "rank": 1,
        "score": 71710,
        "league": "Ruby",
        "clubTag": null
      }
    },
    {
      "id": "s11orbitalhitters",
      "mode": "orbitalhitters",
      "modeLabel": "Orbital Hitters",
      "label": "Season 11 · Orbital Hitters",
      "platform": "crossplay",
      "scoreLabel": "Points",
      "entryCount": 10000,
      "updatedAt": "2026-10-21T17:03:27.761Z",
      "podium": [
        {
          "embarkName": "AverageMan#0535",
          "displayName": "AverageMan",
          "slug": "averageman",
          "rank": 1,
          "score": 17271,
          "league": null,
          "clubTag": "SLGE"
        },
        {
          "embarkName": "Ensso777#2210",
          "displayName": "Ensso777",
          "slug": "ensso777",
          "rank": 2,
          "score": 15396,
          "league": null,
          "clubTag": "7DK"
        },
        "… 1 more"
      ],
      "champion": {
        "embarkName": "AverageMan#0535",
        "displayName": "AverageMan",
        "slug": "averageman",
        "rank": 1,
        "score": 17271,
        "league": null,
        "clubTag": "SLGE"
      }
    },
    "… 7 more"
  ],
  "boardCount": 9,
  "totalEntries": 80010,
  "newer": {
    "season": "s12",
    "label": "Season 12"
  },
  "older": {
    "season": "s10",
    "label": "Season 10"
  }
}

Try it

season *pathtopquery

Wrapped seasons

Seasons that have a Wrapped recap.

GET/wrapped/seasons

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/wrapped/seasons" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/wrapped/seasons", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/wrapped/seasons",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "seasons": [
    {
      "id": "s11",
      "label": "Season 11",
      "live": false,
      "players": 23545
    },
    {
      "id": "s12",
      "label": "Season 12",
      "live": true
    }
  ]
}

Try it

Season Wrapped

The season recap of a player: final rank, best day, climb, league path and highlights.

GET/wrapped/{name}

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

seasonstringquery

Season id (default: latest finished season).

tzstringquery

IANA time zone for "best day" stats, e.g. Europe/Rome.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/wrapped/Balise%232431" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/wrapped/Balise%232431", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/wrapped/Balise%232431",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "available": true,
  "embarkName": "Balise#2431",
  "season": {
    "id": "s11",
    "label": "Season 11",
    "live": false
  },
  "boardSize": 21811,
  "topPercent": 0.01,
  "to": "2026-10-15T20:46:47.282Z",
  "up": 503,
  "down": 93,
  "from": "2026-07-23T17:45:00.545Z",
  "gain": 8613,
  "grid": [
    1,
    2,
    "… 166 more"
  ],
  "peak": {
    "at": "2026-10-13T22:44:41.388Z",
    "score": 71187,
    "league": "Ruby"
  },
  "bigUp": {
    "at": "2026-07-25T16:54:58.691Z",
    "delta": 123
  },
  "final": {
    "rank": 3,
    "score": 71181,
    "league": "Ruby"
  },
  "moves": 597,
  "spark": [
    62568,
    62994,
    "… 45 more"
  ],
  "start": {
    "rank": 1,
    "score": 62568,
    "league": "Diamond 1"
  },
  "tiers": [
    {
      "at": "2026-07-23T17:45:00.545Z",
      "tier": "Diamond",
      "league": "Diamond 1"
    },
    {
      "at": "2026-07-30T11:16:17.721Z",
      "tier": "Ruby",
      "league": "Ruby"
    }
  ],
  "streak": 31,
  "bestDay": {
    "day": "2026-07-26",
    "delta": 557
  },
  "bigDown": {
    "at": "2026-07-24T18:59:45.525Z",
    "delta": -96
  },
  "bestRank": {
    "at": "2026-07-23T17:45:00.545Z",
    "rank": 1,
    "league": "Diamond 1"
  },
  "worstDay": {
    "day": "2026-08-14",
    "delta": -25
  },
  "activeDays": 68,
  "…": "2 more fields"
}

Try it

name *pathseasonquerytzquery

Movers & events4 endpoints

Today’s movers

Biggest climbers and fallers of the live Ranked board in the last 24 hours, with entrants and dropouts.

GET/movers

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/movers" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/movers", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/movers",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "day": "2026-11-02",
  "leaderboardId": "s12",
  "platform": "crossplay",
  "label": "Season 12",
  "computedAt": "2026-11-02T18:06:31.978Z",
  "baselineAt": "2026-11-01T18:06:06.091Z",
  "gainers": [
    {
      "rank": 3437,
      "slug": "fitshotgun",
      "score": 38169,
      "league": "Platinum 1",
      "clubTag": null,
      "prevRank": 9853,
      "rankDelta": 6416,
      "embarkName": "FitShotgun#6148",
      "prevLeague": "Platinum 3",
      "scoreDelta": 4391,
      "displayName": "FitShotgun"
    },
    {
      "rank": 3466,
      "slug": "roz",
      "score": 38138,
      "league": "Platinum 1",
      "clubTag": null,
      "prevRank": 9580,
      "rankDelta": 6114,
      "embarkName": "ROZ#5770",
      "prevLeague": "Platinum 3",
      "scoreDelta": 4224,
      "displayName": "ROZ"
    },
    "… 98 more"
  ],
  "losers": [
    {
      "rank": 9242,
      "slug": "kezuga",
      "score": 34276,
      "league": "Platinum 3",
      "clubTag": "90YIM",
      "prevRank": 2778,
      "rankDelta": -6464,
      "embarkName": "KeZuGa#9556",
      "prevLeague": "Platinum 1",
      "scoreDelta": -4470,
      "displayName": "KeZuGa"
    },
    {
      "rank": 8281,
      "slug": "foreskinfungus",
      "score": 34773,
      "league": "Platinum 3",
      "clubTag": "BUZBA",
      "prevRank": 2306,
      "rankDelta": -5975,
      "embarkName": "ForeskinFungus#0148",
      "prevLeague": "Platinum 1",
      "scoreDelta": -4699,
      "displayName": "ForeskinFungus"
    },
    "… 98 more"
  ],
  "entrants": [
    {
      "rank": 69,
      "slug": "dill",
      "score": 52800,
      "league": "Diamond 1",
      "clubTag": null,
      "prevRank": null,
      "rankDelta": null,
      "embarkName": "dill#6627",
      "prevLeague": null,
      "scoreDelta": null,
      "displayName": "dill"
    },
    {
      "rank": 78,
      "slug": "6-8ftbillionaire",
      "score": 52221,
      "league": "Diamond 1",
      "clubTag": "ENVY",
      "prevRank": null,
      "rankDelta": null,
      "embarkName": "6-8FtBillionaire#0026",
      "prevLeague": null,
      "scoreDelta": null,
      "displayName": "6-8FtBillionaire"
    },
    "… 98 more"
  ],
  "dropouts": [
    {
      "rank": null,
      "slug": "dilltv",
      "score": 52893,
      "league": "Diamond 1",
      "clubTag": null,
      "prevRank": 54,
      "rankDelta": null,
      "embarkName": "dilltv#5940",
      "prevLeague": "Diamond 1",
      "scoreDelta": null,
      "displayName": "dilltv"
    },
    {
      "rank": null,
      "slug": "lycommit",
      "score": 52221,
      "league": "Diamond 1",
      "clubTag": "ENVY",
      "prevRank": 69,
      "rankDelta": null,
      "embarkName": "lycommit#0621",
      "prevLeague": "Diamond 1",
      "scoreDelta": null,
      "displayName": "lycommit"
    },
    "… 98 more"
  ],
  "clubMoves": [
    {
      "rank": 224,
      "slug": "ky",
      "score": 48211,
      "league": "Diamond 1",
      "toClub": "MTHRY",
      "fromClub": null,
      "embarkName": "ky#0234",
      "displayName": "ky"
    },
    {
      "rank": 361,
      "slug": "nyze",
      "score": 46399,
      "league": "Diamond 2",
      "toClub": "DRG",
      "fromClub": null,
      "embarkName": "nyze#6794",
      "displayName": "nyze"
    },
    "… 31 more"
  ],
  "stats": {
    "fell": 6955,
    "moved": 9233,
    "climbed": 2278,
    "topDrop": 6464,
    "topGain": 6416,
    "tracked": 10000,
    "dropouts": 752,
    "entrants": 752,
    "clubMoves": 33,
    "boardLabel": "Season 12"
  },
  "days": [
    {
      "day": "2026-11-02",
      "stats": {
        "fell": 6955,
        "moved": 9233,
        "climbed": 2278,
        "topDrop": 6464,
        "topGain": 6416,
        "tracked": 10000,
        "dropouts": 752,
        "entrants": 752,
        "clubMoves": 33,
        "boardLabel": "Season 12"
      }
    },
    {
      "day": "2026-11-01",
      "stats": {
        "fell": 6818,
        "moved": 9210,
        "climbed": 2392,
        "topDrop": 5952,
        "topGain": 7006,
        "tracked": 10000,
        "dropouts": 784,
        "entrants": 784,
        "clubMoves": 71,
        "boardLabel": "Season 12"
      }
    },
    "… 10 more"
  ]
}

Try it

Movers by day

The days with movers data and their totals.

GET/movers/days

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/movers/days" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/movers/days", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/movers/days",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "days": [
    {
      "day": "2026-11-02",
      "stats": {
        "fell": 6955,
        "moved": 9233,
        "climbed": 2278,
        "topDrop": 6464,
        "topGain": 6416,
        "tracked": 10000,
        "dropouts": 752,
        "entrants": 752,
        "clubMoves": 33,
        "boardLabel": "Season 12"
      }
    },
    {
      "day": "2026-11-01",
      "stats": {
        "fell": 6818,
        "moved": 9210,
        "climbed": 2392,
        "topDrop": 5952,
        "topGain": 7006,
        "tracked": 10000,
        "dropouts": 784,
        "entrants": 784,
        "clubMoves": 71,
        "boardLabel": "Season 12"
      }
    },
    "… 10 more"
  ]
}

Try it

Movers of a day

Movers of a past day.

GET/movers/{day}

Parameters

daydatepathrequired

Day in YYYY-MM-DD (UTC).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/movers/{day}" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/movers/{day}", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/movers/{day}",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Try it

day *path

Name-change feed

The live feed of detected renames across all boards, newest first. Subscribe to thefinals.renamed to receive it as a webhook.

GET/events

Query Parameters

limitintegerquery

How many (default 60, max 200).

kindstringquery

name-change (only kind today).

qstringquery

Filter by name.

offsetintegerquery

Skip N events.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/events?limit=3" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/events?limit=3", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/events?limit=3",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "events": [
    {
      "kind": "name-change",
      "occurredAt": "2026-11-03T01:18:31.340Z",
      "embarkName": "Thunder#4617",
      "prevName": "Bilal#4783",
      "handle": "wandercalm",
      "platform": "psn",
      "clubTag": null,
      "rank": 1415,
      "score": 87785,
      "league": null
    },
    {
      "kind": "name-change",
      "occurredAt": "2026-11-03T01:18:31.331Z",
      "embarkName": "Mr.Hands#2673",
      "prevName": "BarackOsama#6708",
      "handle": "the bandit",
      "platform": "steam",
      "clubTag": null,
      "rank": 4393,
      "score": 20160,
      "league": null
    },
    "… 1 more"
  ]
}

Try it

limitquerykindqueryqqueryoffsetquery

Bans2 endpoints

Ban list

Players removed from the leaderboards, with detection time, last rank and status. Subscribe to thefinals.ban_detected for webhooks.

GET/bans

Query Parameters

seasonstringquery

Season id.

qstringquery

Filter by name.

statusstringquery

suspected, confirmed or returned.

typestringquery

Ban type, e.g. removed.

sortstringquery

recent (default), rank or score.

pageintegerquery

Page number, from 1.

perPageintegerquery

Results per page (default 50, max 100).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/bans?perPage=2" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/bans?perPage=2", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/bans?perPage=2",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "bans": [
    {
      "embarkName": "embrione#3890",
      "displayName": "embrione",
      "slug": "embrione",
      "season": "s12",
      "seasonLabel": "Season 12",
      "leaderboardId": "s12",
      "status": "suspected",
      "banType": "removed",
      "banTypeLabel": "Removed from the leaderboard",
      "banReason": null,
      "banDuration": null,
      "detection": "live",
      "lastSeenAt": "2026-11-02T20:11:21.103Z",
      "detectedAt": "2026-11-02T20:31:50.648Z",
      "confirmedAt": null,
      "returnedAt": null,
      "lastRank": 6647,
      "lastScore": 35683,
      "lastLeague": "Platinum 2",
      "peakRank": 5842,
      "clubTag": "TUT9",
      "platforms": {
        "steam": "MYXTAP__SOBAKA",
        "psn": null,
        "xbox": null
      },
      "cutoffScore": 33913,
      "margin": 1770,
      "…": "3 more fields"
    },
    {
      "embarkName": "Sister_Fister#1812",
      "displayName": "Sister_Fister",
      "slug": "sister-fister",
      "season": "s12",
      "seasonLabel": "Season 12",
      "leaderboardId": "s12",
      "status": "suspected",
      "banType": "removed",
      "banTypeLabel": "Removed from the leaderboard",
      "banReason": null,
      "banDuration": null,
      "detection": "live",
      "lastSeenAt": "2026-11-02T16:49:23.087Z",
      "detectedAt": "2026-11-02T17:13:41.648Z",
      "confirmedAt": null,
      "returnedAt": null,
      "lastRank": 1272,
      "lastScore": 41493,
      "lastLeague": "Diamond 4",
      "peakRank": 1272,
      "clubTag": null,
      "platforms": {
        "steam": "BAKA",
        "psn": null,
        "xbox": null
      },
      "cutoffScore": 33900,
      "margin": 7593,
      "…": "3 more fields"
    }
  ],
  "total": 83,
  "page": 1,
  "perPage": 2,
  "totalPages": 42,
  "stats": {
    "daily": [
      {
        "day": "2026-10-22",
        "n": 3
      },
      {
        "day": "2026-10-23",
        "n": 4
      },
      "… 10 more"
    ],
    "spotlight": [
      {
        "embarkName": "colak#0003",
        "displayName": "colak",
        "slug": "colak",
        "season": "s12",
        "seasonLabel": "Season 12",
        "leaderboardId": "s12",
        "status": "confirmed",
        "banType": "removed",
        "banTypeLabel": "Removed from the leaderboard",
        "banReason": null,
        "banDuration": null,
        "detection": "backfill",
        "lastSeenAt": "2026-10-23T10:00:56.109Z",
        "detectedAt": "2026-10-23T10:48:01.536Z",
        "confirmedAt": "2026-10-23T10:48:01.536Z",
        "returnedAt": null,
        "lastRank": 31,
        "lastScore": 47437,
        "lastLeague": "Diamond 2",
        "peakRank": 22,
        "clubTag": "AYNON",
        "platforms": {
          "steam": "colak",
          "psn": "colaksito",
          "xbox": null
        },
        "cutoffScore": null,
        "margin": null,
        "…": "3 more fields"
      },
      {
        "embarkName": "HeartZ#0313",
        "displayName": "HeartZ",
        "slug": "heartz",
        "season": "s12",
        "seasonLabel": "Season 12",
        "leaderboardId": "s12",
        "status": "confirmed",
        "banType": "removed",
        "banTypeLabel": "Removed from the leaderboard",
        "banReason": null,
        "banDuration": null,
        "detection": "live",
        "lastSeenAt": "2026-10-30T15:29:33.189Z",
        "detectedAt": "2026-10-30T15:53:59.792Z",
        "confirmedAt": "2026-11-02T16:02:37.308Z",
        "returnedAt": null,
        "lastRank": 74,
        "lastScore": 51248,
        "lastLeague": "Diamond 1",
        "peakRank": 76,
        "clubTag": null,
        "platforms": {
          "steam": "imtek800iswear",
          "psn": null,
          "xbox": null
        },
        "cutoffScore": 33249,
        "margin": 17999,
        "…": "3 more fields"
      },
      "… 1 more"
    ],
    "season": "s12",
    "seasonLabel": "Season 12",
    "flagged": 83,
    "confirmed": 53,
    "suspected": 30,
    "returned": 76,
    "last24h": 11,
    "last7d": 54,
    "top500": 11,
    "latestAt": "2026-11-02T20:31:50.648Z",
    "allSeasons": 296,
    "rsWipes": 15
  },
  "seasons": [
    {
      "season": "s12",
      "label": "Season 12",
      "suspected": 35,
      "confirmed": 58,
      "returned": 81,
      "dismissed": 88
    },
    {
      "season": "s11",
      "label": "Season 11",
      "suspected": 0,
      "confirmed": 217,
      "returned": 5,
      "dismissed": 0
    }
  ],
  "disclaimer": "Embark does not publish a ban list. These accounts disappeared from the ranked leaderboard from a rank too high for dropping off the boar…"
}

Try it

seasonqueryqquerystatusquerytypequerysortquerypagequeryperPagequery

Ban record

The ban history of one player.

GET/bans/{name}

Parameters

namestringpathrequired

Embark name with its tag, URL-encoded (Balise#2431 → Balise%232431). Former names and platform handles resolve too.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/bans/{name}" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/bans/{name}", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/bans/{name}",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Try it

name *path

Clubs3 endpoints

Clubs

Every club tag with member count, boards and best rank.

GET/clubs

Query Parameters

qstringquery

Tag prefix.

pageintegerquery

Page number, from 1.

perPageintegerquery

Results per page (default 40, max 100).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/clubs?perPage=3" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/clubs?perPage=3", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/clubs?perPage=3",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "fetchedAt": "2026-11-03T01:36:54.597Z",
  "total": 126545,
  "page": 1,
  "perPage": 10,
  "totalPages": 12655,
  "clubs": [
    {
      "clubTag": "RAGER",
      "memberCount": 217,
      "boardCount": 66,
      "bestRank": 1
    },
    {
      "clubTag": "ALLOR",
      "memberCount": 185,
      "boardCount": 34,
      "bestRank": 1
    },
    "… 8 more"
  ]
}

Try it

qquerypagequeryperPagequery

Club ranking

Clubs ranked by the power of their best five players on the live board.

GET/clubs/ranking

Query Parameters

qstringquery

Tag prefix.

pageintegerquery

Page number, from 1.

perPageintegerquery

Results per page (default 50, max 100).

Example Request

curl "https://public-api.arenyze.com/thefinals/api/clubs/ranking?perPage=3" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/clubs/ranking?perPage=3", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/clubs/ranking?perPage=3",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "board": {
    "id": "s12",
    "platform": "crossplay",
    "label": "Season 12"
  },
  "coreSize": 5,
  "minMembers": 3,
  "page": 1,
  "perPage": 10,
  "total": 418,
  "totalPages": 42,
  "clubs": [
    {
      "clubTag": "NFNIT",
      "clubRank": 1,
      "power": 57274,
      "members": 8,
      "bestRank": 4,
      "bestPlayer": "LuiHuncho#3649",
      "avgScore": 49661,
      "totalScore": 397285,
      "topLeague": "Diamond 1",
      "updatedAt": "2026-11-02T02:02:26.786Z"
    },
    {
      "clubTag": "KNGZ",
      "clubRank": 2,
      "power": 53662,
      "members": 44,
      "bestRank": 3,
      "bestPlayer": "AOSHI#5527",
      "avgScore": 40867,
      "totalScore": 1798134,
      "topLeague": "Diamond 1",
      "updatedAt": "2026-11-02T02:02:26.786Z"
    },
    "… 8 more"
  ]
}

Try it

qquerypagequeryperPagequery

Club

Members of a club with their best rank.

GET/clubs/{tag}

Parameters

tagstringpathrequired

Club tag, e.g. RAGER.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/clubs/RAGER" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/clubs/RAGER", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/clubs/RAGER",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "clubTag": "RAGER",
  "fetchedAt": "2026-11-03T01:17:07.456Z",
  "members": [
    {
      "name": "999#2398",
      "bestRank": 1
    },
    {
      "name": "KERALA_KID#1663",
      "bestRank": 1
    },
    "… 215 more"
  ],
  "boards": [
    {
      "leaderboardId": "s10teamdeathmatch",
      "label": "Season 10 · Team Deathmatch",
      "season": "s10",
      "rank": 1,
      "totalValue": 418944
    },
    {
      "leaderboardId": "s11teamdeathmatch",
      "label": "Season 11 · Team Deathmatch",
      "season": "s11",
      "rank": 1,
      "totalValue": 351555
    },
    "… 64 more"
  ],
  "memberCount": 217,
  "boardCount": 66,
  "bestRank": 1,
  "stats": {
    "clubTag": "RAGER",
    "clubRank": 170,
    "power": 39036,
    "members": 6,
    "bestRank": 1069,
    "bestPlayer": "999#2398",
    "avgScore": 38352,
    "totalScore": 230114,
    "topLeague": "Diamond 4",
    "updatedAt": "2026-11-02T02:02:26.786Z",
    "allMembers": 217,
    "dissolvedAt": null,
    "indexable": true,
    "officialName": null,
    "rankedClubs": 418,
    "coreSize": 5,
    "minMembers": 3
  },
  "roster": [
    {
      "embarkName": "999#2398",
      "rank": 685,
      "score": 43991,
      "league": "Diamond 3"
    },
    {
      "embarkName": "CheesyCrouton63#0594",
      "rank": 2156,
      "score": 40049,
      "league": "Diamond 4"
    },
    "… 4 more"
  ]
}

Try it

tag *path

Hall of Fame2 endpoints

Hall of Fame

Champions, veterans and records across every season since the closed betas.

GET/hall-of-fame

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/hall-of-fame" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/hall-of-fame", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/hall-of-fame",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "generatedAt": "2026-11-02T02:03:52.527Z",
  "currentSeason": "s12",
  "stats": {
    "players": 361750,
    "boards": 79,
    "entries": 789970,
    "seasons": 15,
    "veterans": 116
  },
  "seasons": [
    {
      "id": "ob",
      "label": "Open Beta",
      "short": "OB"
    },
    {
      "id": "s1",
      "label": "Season 1",
      "short": "S1"
    },
    "… 11 more"
  ],
  "method": {
    "weights": {
      "ranked": 1,
      "worldtour": 0.5,
      "other": 0.25
    },
    "preSeasonFactor": 0.5,
    "excluded": [
      "orf",
      "the-finals",
      "… 2 more"
    ]
  },
  "lists": {
    "alltime": [
      "Balise#2431",
      "lycommit#0621",
      "… 98 more"
    ],
    "peak": [
      "stewj#8610",
      "carnifex#7330",
      "… 98 more"
    ],
    "consistency": [
      "EkaZo#5318",
      "Appoh#9173",
      "… 98 more"
    ],
    "versatility": [
      "mdiym#9757",
      "Captain#8153",
      "… 98 more"
    ],
    "veterans": [
      "Balise#2431",
      "EkaZo#5318",
      "… 98 more"
    ]
  },
  "players": {
    "Balise#2431": {
      "name": "Balise#2431",
      "displayName": "Balise",
      "slug": "balise",
      "legacy": 1115,
      "rankedSeasons": 10,
      "top1000": 10,
      "top100": 9,
      "top10": 4,
      "best": {
        "rank": 1,
        "season": "s5"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 4 more"
      ],
      "firstBeta": "cb1",
      "current": {
        "rank": 52,
        "league": "Diamond 1"
      },
      "career": {
        "ob": {
          "rank": 5,
          "league": "Diamond 1"
        },
        "s3": {
          "rank": 49,
          "league": "Ruby"
        },
        "s4": {
          "rank": 6,
          "league": "Ruby"
        },
        "s5": {
          "rank": 1,
          "league": "Ruby"
        },
        "s6": {
          "rank": 12,
          "league": "Ruby"
        },
        "s7": {
          "rank": 25,
          "league": "Ruby"
        },
        "s8": {
          "rank": 410,
          "league": "Ruby"
        },
        "s9": {
          "rank": 8,
          "league": "Ruby"
        },
        "s10": {
          "rank": 16,
          "league": "Ruby"
        },
        "s11": {
          "rank": 3,
          "league": "Ruby"
        },
        "s12": {
          "rank": 52,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "BERGR",
      "badges": [
        {
          "id": "champion",
          "tier": "legendary",
          "label": "Champion",
          "desc": "Finished #1: S5.",
          "image": "/assets/badges/champion.svg?v=2"
        },
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×4",
          "desc": "Top 10: S4, S5, S9, S11.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        "… 1 more"
      ]
    },
    "lycommit#0621": {
      "name": "lycommit#0621",
      "displayName": "lycommit",
      "slug": "lycommit",
      "legacy": 1075,
      "rankedSeasons": 11,
      "top1000": 11,
      "top100": 6,
      "top10": 2,
      "best": {
        "rank": 1,
        "season": "s4"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 70,
        "league": "Diamond 1"
      },
      "career": {
        "s1": {
          "rank": 105,
          "league": "Diamond 1"
        },
        "s2": {
          "rank": 2,
          "league": "Diamond 1"
        },
        "s4": {
          "rank": 1,
          "league": "Ruby"
        },
        "s5": {
          "rank": 22,
          "league": "Ruby"
        },
        "s6": {
          "rank": 45,
          "league": "Ruby"
        },
        "s7": {
          "rank": 307,
          "league": "Ruby"
        },
        "s8": {
          "rank": 344,
          "league": "Ruby"
        },
        "s9": {
          "rank": 86,
          "league": "Ruby"
        },
        "s10": {
          "rank": 132,
          "league": "Ruby"
        },
        "s11": {
          "rank": 367,
          "league": "Ruby"
        },
        "s12": {
          "rank": 70,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "ENVY",
      "badges": [
        {
          "id": "champion",
          "tier": "legendary",
          "label": "Champion",
          "desc": "Finished #1: S4.",
          "image": "/assets/badges/champion.svg?v=2"
        },
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×2",
          "desc": "Top 10: S2, S4.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        "… 1 more"
      ]
    },
    "Palma#2038": {
      "name": "Palma#2038",
      "displayName": "Palma",
      "slug": "palma",
      "legacy": 889,
      "rankedSeasons": 11,
      "top1000": 11,
      "top100": 9,
      "top10": 4,
      "best": {
        "rank": 1,
        "season": "s8"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 1 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 118,
        "league": "Diamond 1"
      },
      "career": {
        "s2": {
          "rank": 48,
          "league": "Diamond 1"
        },
        "s3": {
          "rank": 24,
          "league": "Ruby"
        },
        "s4": {
          "rank": 15,
          "league": "Ruby"
        },
        "s5": {
          "rank": 58,
          "league": "Ruby"
        },
        "s6": {
          "rank": 2,
          "league": "Ruby"
        },
        "s7": {
          "rank": 2,
          "league": "Ruby"
        },
        "s8": {
          "rank": 1,
          "league": "Ruby"
        },
        "s9": {
          "rank": 2,
          "league": "Ruby"
        },
        "s10": {
          "rank": 33,
          "league": "Ruby"
        },
        "s11": {
          "rank": 113,
          "league": "Ruby"
        },
        "s12": {
          "rank": 118,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "ALL",
      "badges": [
        {
          "id": "champion",
          "tier": "legendary",
          "label": "Champion",
          "desc": "Finished #1: S8.",
          "image": "/assets/badges/champion.svg?v=2"
        },
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×4",
          "desc": "Top 10: S6, S7, S8, S9.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        "… 1 more"
      ]
    },
    "perzzonTTV#5485": {
      "name": "perzzonTTV#5485",
      "displayName": "perzzonTTV",
      "slug": "perzzonttv",
      "legacy": 868,
      "rankedSeasons": 10,
      "top1000": 8,
      "top100": 8,
      "top10": 5,
      "best": {
        "rank": 2,
        "season": "s10"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 2,
        "league": "Diamond 1"
      },
      "career": {
        "s2": {
          "rank": 1340,
          "league": "Diamond 2"
        },
        "s3": {
          "rank": 1090,
          "league": "Diamond 4"
        },
        "s5": {
          "rank": 19,
          "league": "Ruby"
        },
        "s6": {
          "rank": 16,
          "league": "Ruby"
        },
        "s7": {
          "rank": 8,
          "league": "Ruby"
        },
        "s8": {
          "rank": 3,
          "league": "Ruby"
        },
        "s9": {
          "rank": 4,
          "league": "Ruby"
        },
        "s10": {
          "rank": 2,
          "league": "Ruby"
        },
        "s11": {
          "rank": 23,
          "league": "Ruby"
        },
        "s12": {
          "rank": 2,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "PRZN",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×4",
          "desc": "Top 10: S7, S8, S9, S10.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×7",
          "desc": "Ruby in S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "Bizzy#0005": {
      "name": "Bizzy#0005",
      "displayName": "Bizzy",
      "slug": "bizzy",
      "legacy": 851,
      "rankedSeasons": 11,
      "top1000": 11,
      "top100": 9,
      "top10": 3,
      "best": {
        "rank": 3,
        "season": "s6"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 1 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 105,
        "league": "Diamond 1"
      },
      "career": {
        "s2": {
          "rank": 65,
          "league": "Diamond 1"
        },
        "s3": {
          "rank": 150,
          "league": "Ruby"
        },
        "s4": {
          "rank": 7,
          "league": "Ruby"
        },
        "s5": {
          "rank": 7,
          "league": "Ruby"
        },
        "s6": {
          "rank": 3,
          "league": "Ruby"
        },
        "s7": {
          "rank": 15,
          "league": "Ruby"
        },
        "s8": {
          "rank": 13,
          "league": "Ruby"
        },
        "s9": {
          "rank": 20,
          "league": "Ruby"
        },
        "s10": {
          "rank": 14,
          "league": "Ruby"
        },
        "s11": {
          "rank": 29,
          "league": "Ruby"
        },
        "s12": {
          "rank": 105,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "NTMR",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×3",
          "desc": "Top 10: S4, S5, S6.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×9",
          "desc": "Ruby in S3, S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "EkaZo#5318": {
      "name": "EkaZo#5318",
      "displayName": "EkaZo",
      "slug": "ekazo",
      "legacy": 838,
      "rankedSeasons": 12,
      "top1000": 12,
      "top100": 7,
      "top10": 1,
      "best": {
        "rank": 9,
        "season": "s9"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 7 more"
      ],
      "firstBeta": "ob",
      "current": {
        "rank": 521,
        "league": "Diamond 3"
      },
      "career": {
        "ob": {
          "rank": 242,
          "league": "Diamond 1"
        },
        "s1": {
          "rank": 291,
          "league": "Diamond 1"
        },
        "s2": {
          "rank": 199,
          "league": "Diamond 1"
        },
        "s3": {
          "rank": 294,
          "league": "Ruby"
        },
        "s4": {
          "rank": 82,
          "league": "Ruby"
        },
        "s5": {
          "rank": 25,
          "league": "Ruby"
        },
        "s6": {
          "rank": 24,
          "league": "Ruby"
        },
        "s7": {
          "rank": 40,
          "league": "Ruby"
        },
        "s8": {
          "rank": 15,
          "league": "Ruby"
        },
        "s9": {
          "rank": 9,
          "league": "Ruby"
        },
        "s10": {
          "rank": 26,
          "league": "Ruby"
        },
        "s11": {
          "rank": 232,
          "league": "Ruby"
        },
        "s12": {
          "rank": 521,
          "league": "Diamond 3"
        }
      },
      "league": "Ruby",
      "club": "GOONU",
      "badges": [
        {
          "id": "every-season",
          "tier": "epic",
          "label": "Ever-Present",
          "desc": "On the Ranked board in every season, S1 to S12.",
          "image": "/assets/badges/every-season.svg?v=2"
        },
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10",
          "desc": "Top 10: S9.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        "… 1 more"
      ]
    },
    "desrvd#0890": {
      "name": "desrvd#0890",
      "displayName": "desrvd",
      "slug": "desrvd",
      "legacy": 829,
      "rankedSeasons": 10,
      "top1000": 10,
      "top100": 8,
      "top10": 6,
      "best": {
        "rank": 3,
        "season": "s9"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": null,
      "career": {
        "s1": {
          "rank": 5,
          "league": "Diamond 1"
        },
        "s2": {
          "rank": 181,
          "league": "Diamond 1"
        },
        "s4": {
          "rank": 8,
          "league": "Ruby"
        },
        "s5": {
          "rank": 11,
          "league": "Ruby"
        },
        "s6": {
          "rank": 8,
          "league": "Ruby"
        },
        "s7": {
          "rank": 4,
          "league": "Ruby"
        },
        "s8": {
          "rank": 4,
          "league": "Ruby"
        },
        "s9": {
          "rank": 3,
          "league": "Ruby"
        },
        "s10": {
          "rank": 15,
          "league": "Ruby"
        },
        "s11": {
          "rank": 678,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "GOAT",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×6",
          "desc": "Top 10: S1, S4, S6, S7, S8, S9.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×7",
          "desc": "Ruby in S4, S5, S6, S7, S8, S9, S10.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "stewj#8610": {
      "name": "stewj#8610",
      "displayName": "stewj",
      "slug": "stewj",
      "legacy": 808,
      "rankedSeasons": 10,
      "top1000": 9,
      "top100": 7,
      "top10": 5,
      "best": {
        "rank": 1,
        "season": "s6"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 3 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 112,
        "league": "Diamond 1"
      },
      "career": {
        "s3": {
          "rank": 3275,
          "league": "Platinum 3"
        },
        "s4": {
          "rank": 286,
          "league": "Ruby"
        },
        "s5": {
          "rank": 6,
          "league": "Ruby"
        },
        "s6": {
          "rank": 1,
          "league": "Ruby"
        },
        "s7": {
          "rank": 16,
          "league": "Ruby"
        },
        "s8": {
          "rank": 10,
          "league": "Ruby"
        },
        "s9": {
          "rank": 6,
          "league": "Ruby"
        },
        "s10": {
          "rank": 39,
          "league": "Ruby"
        },
        "s11": {
          "rank": 7,
          "league": "Ruby"
        },
        "s12": {
          "rank": 112,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "NTMR",
      "badges": [
        {
          "id": "champion",
          "tier": "legendary",
          "label": "Champion",
          "desc": "Finished #1: S6.",
          "image": "/assets/badges/champion.svg?v=2"
        },
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×5",
          "desc": "Top 10: S5, S6, S8, S9, S11.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        "… 1 more"
      ]
    },
    "Appoh#9173": {
      "name": "Appoh#9173",
      "displayName": "Appoh",
      "slug": "appoh",
      "legacy": 803,
      "rankedSeasons": 12,
      "top1000": 12,
      "top100": 5,
      "top10": 0,
      "best": {
        "rank": 22,
        "season": "s10"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": "cb1",
      "current": {
        "rank": 146,
        "league": "Diamond 1"
      },
      "career": {
        "ob": {
          "rank": 3874,
          "league": "Diamond 4"
        },
        "s1": {
          "rank": 151,
          "league": "Diamond 1"
        },
        "s2": {
          "rank": 598,
          "league": "Diamond 1"
        },
        "s3": {
          "rank": 306,
          "league": "Ruby"
        },
        "s4": {
          "rank": 32,
          "league": "Ruby"
        },
        "s5": {
          "rank": 293,
          "league": "Ruby"
        },
        "s6": {
          "rank": 36,
          "league": "Ruby"
        },
        "s7": {
          "rank": 494,
          "league": "Ruby"
        },
        "s8": {
          "rank": 51,
          "league": "Ruby"
        },
        "s9": {
          "rank": 33,
          "league": "Ruby"
        },
        "s10": {
          "rank": 22,
          "league": "Ruby"
        },
        "s11": {
          "rank": 369,
          "league": "Ruby"
        },
        "s12": {
          "rank": 146,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "VGG",
      "badges": [
        {
          "id": "every-season",
          "tier": "epic",
          "label": "Ever-Present",
          "desc": "On the Ranked board in every season, S1 to S12.",
          "image": "/assets/badges/every-season.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×9",
          "desc": "Ruby in S3, S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "carnifex#7330": {
      "name": "carnifex#7330",
      "displayName": "carnifex",
      "slug": "carnifex",
      "legacy": 754,
      "rankedSeasons": 6,
      "top1000": 6,
      "top100": 6,
      "top10": 5,
      "best": {
        "rank": 1,
        "season": "s7"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 11,
        "league": "Diamond 1"
      },
      "career": {
        "s7": {
          "rank": 1,
          "league": "Ruby"
        },
        "s8": {
          "rank": 2,
          "league": "Ruby"
        },
        "s9": {
          "rank": 1,
          "league": "Ruby"
        },
        "s10": {
          "rank": 1,
          "league": "Ruby"
        },
        "s11": {
          "rank": 4,
          "league": "Ruby"
        },
        "s12": {
          "rank": 11,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "5F",
      "badges": [
        {
          "id": "champion",
          "tier": "legendary",
          "label": "Champion ×3",
          "desc": "Finished #1: S7, S9, S10.",
          "image": "/assets/badges/champion.svg?v=2"
        },
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×5",
          "desc": "Top 10: S7, S8, S9, S10, S11.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        "… 1 more"
      ]
    },
    "Digcron.TTV#3309": {
      "name": "Digcron.TTV#3309",
      "displayName": "Digcron.TTV",
      "slug": "digcron-ttv",
      "legacy": 753,
      "rankedSeasons": 10,
      "top1000": 10,
      "top100": 8,
      "top10": 1,
      "best": {
        "rank": 6,
        "season": "s10"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 139,
        "league": "Diamond 1"
      },
      "career": {
        "s3": {
          "rank": 276,
          "league": "Ruby"
        },
        "s4": {
          "rank": 89,
          "league": "Ruby"
        },
        "s5": {
          "rank": 26,
          "league": "Ruby"
        },
        "s6": {
          "rank": 38,
          "league": "Ruby"
        },
        "s7": {
          "rank": 61,
          "league": "Ruby"
        },
        "s8": {
          "rank": 30,
          "league": "Ruby"
        },
        "s9": {
          "rank": 36,
          "league": "Ruby"
        },
        "s10": {
          "rank": 6,
          "league": "Ruby"
        },
        "s11": {
          "rank": 41,
          "league": "Ruby"
        },
        "s12": {
          "rank": 139,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "DIGA",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10",
          "desc": "Top 10: S10.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×9",
          "desc": "Ruby in S3, S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "NAGHOSTX6#0212": {
      "name": "NAGHOSTX6#0212",
      "displayName": "NAGHOSTX6",
      "slug": "naghostx6",
      "legacy": 751,
      "rankedSeasons": 9,
      "top1000": 9,
      "top100": 6,
      "top10": 2,
      "best": {
        "rank": 5,
        "season": "s10"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 5 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 58,
        "league": "Diamond 1"
      },
      "career": {
        "s4": {
          "rank": 465,
          "league": "Ruby"
        },
        "s5": {
          "rank": 209,
          "league": "Ruby"
        },
        "s6": {
          "rank": 336,
          "league": "Ruby"
        },
        "s7": {
          "rank": 74,
          "league": "Ruby"
        },
        "s8": {
          "rank": 6,
          "league": "Ruby"
        },
        "s9": {
          "rank": 12,
          "league": "Ruby"
        },
        "s10": {
          "rank": 5,
          "league": "Ruby"
        },
        "s11": {
          "rank": 44,
          "league": "Ruby"
        },
        "s12": {
          "rank": 58,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "5F",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×2",
          "desc": "Top 10: S8, S10.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×8",
          "desc": "Ruby in S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "lamp#5944": {
      "name": "lamp#5944",
      "displayName": "lamp",
      "slug": "lamp",
      "legacy": 751,
      "rankedSeasons": 9,
      "top1000": 9,
      "top100": 8,
      "top10": 3,
      "best": {
        "rank": 2,
        "season": "s5"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 120,
        "league": "Diamond 1"
      },
      "career": {
        "s4": {
          "rank": 3,
          "league": "Ruby"
        },
        "s5": {
          "rank": 2,
          "league": "Ruby"
        },
        "s6": {
          "rank": 6,
          "league": "Ruby"
        },
        "s7": {
          "rank": 84,
          "league": "Ruby"
        },
        "s8": {
          "rank": 35,
          "league": "Ruby"
        },
        "s9": {
          "rank": 25,
          "league": "Ruby"
        },
        "s10": {
          "rank": 20,
          "league": "Ruby"
        },
        "s11": {
          "rank": 50,
          "league": "Ruby"
        },
        "s12": {
          "rank": 120,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "LUMN",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×3",
          "desc": "Top 10: S4, S5, S6.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×8",
          "desc": "Ruby in S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "Laske#2887": {
      "name": "Laske#2887",
      "displayName": "Laske",
      "slug": "laske",
      "legacy": 716,
      "rankedSeasons": 10,
      "top1000": 10,
      "top100": 9,
      "top10": 1,
      "best": {
        "rank": 3,
        "season": "s10"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 3 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 44,
        "league": "Diamond 1"
      },
      "career": {
        "s2": {
          "rank": 591,
          "league": "Diamond 1"
        },
        "s4": {
          "rank": 84,
          "league": "Ruby"
        },
        "s5": {
          "rank": 65,
          "league": "Ruby"
        },
        "s6": {
          "rank": 23,
          "league": "Ruby"
        },
        "s7": {
          "rank": 39,
          "league": "Ruby"
        },
        "s8": {
          "rank": 58,
          "league": "Ruby"
        },
        "s9": {
          "rank": 65,
          "league": "Ruby"
        },
        "s10": {
          "rank": 3,
          "league": "Ruby"
        },
        "s11": {
          "rank": 42,
          "league": "Ruby"
        },
        "s12": {
          "rank": 44,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "PLSR",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10",
          "desc": "Top 10: S10.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×8",
          "desc": "Ruby in S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "zuki#8633": {
      "name": "zuki#8633",
      "displayName": "zuki",
      "slug": "zuki",
      "legacy": 699,
      "rankedSeasons": 10,
      "top1000": 9,
      "top100": 7,
      "top10": 0,
      "best": {
        "rank": 14,
        "season": "s6"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 3 more"
      ],
      "firstBeta": "cb1",
      "current": {
        "rank": 73,
        "league": "Diamond 1"
      },
      "career": {
        "s2": {
          "rank": 1740,
          "league": "Diamond 2"
        },
        "s4": {
          "rank": 127,
          "league": "Ruby"
        },
        "s5": {
          "rank": 23,
          "league": "Ruby"
        },
        "s6": {
          "rank": 14,
          "league": "Ruby"
        },
        "s7": {
          "rank": 17,
          "league": "Ruby"
        },
        "s8": {
          "rank": 86,
          "league": "Ruby"
        },
        "s9": {
          "rank": 97,
          "league": "Ruby"
        },
        "s10": {
          "rank": 82,
          "league": "Ruby"
        },
        "s11": {
          "rank": 415,
          "league": "Ruby"
        },
        "s12": {
          "rank": 73,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "NTMR",
      "badges": [
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×8",
          "desc": "Ruby in S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "NV#0000": {
      "name": "NV#0000",
      "displayName": "NV",
      "slug": "nv",
      "legacy": 688,
      "rankedSeasons": 10,
      "top1000": 7,
      "top100": 4,
      "top10": 1,
      "best": {
        "rank": 3,
        "season": "s7"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": null,
      "career": {
        "s2": {
          "rank": 6815,
          "league": "Diamond 4"
        },
        "s3": {
          "rank": 6924,
          "league": "Platinum 4"
        },
        "s4": {
          "rank": 445,
          "league": "Ruby"
        },
        "s5": {
          "rank": 180,
          "league": "Ruby"
        },
        "s6": {
          "rank": 32,
          "league": "Ruby"
        },
        "s7": {
          "rank": 3,
          "league": "Ruby"
        },
        "s8": {
          "rank": 25,
          "league": "Ruby"
        },
        "s9": {
          "rank": 16,
          "league": "Ruby"
        },
        "s10": {
          "rank": 1942,
          "league": "Diamond 3"
        },
        "s11": {
          "rank": 193,
          "league": "Ruby"
        }
      },
      "league": "Ruby",
      "club": "GOAT",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10",
          "desc": "Top 10: S7.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×7",
          "desc": "Ruby in S4, S5, S6, S7, S8, S9, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "MonsterPig#7402": {
      "name": "MonsterPig#7402",
      "displayName": "MonsterPig",
      "slug": "monsterpig",
      "legacy": 685,
      "rankedSeasons": 11,
      "top1000": 11,
      "top100": 6,
      "top10": 1,
      "best": {
        "rank": 10,
        "season": "s9"
      },
      "modes": [
        "Ranked",
        "World Tour"
      ],
      "firstBeta": null,
      "current": {
        "rank": 18,
        "league": "Diamond 1"
      },
      "career": {
        "s1": {
          "rank": 465,
          "league": "Diamond 1"
        },
        "s3": {
          "rank": 240,
          "league": "Ruby"
        },
        "s4": {
          "rank": 42,
          "league": "Ruby"
        },
        "s5": {
          "rank": 255,
          "league": "Ruby"
        },
        "s6": {
          "rank": 109,
          "league": "Ruby"
        },
        "s7": {
          "rank": 295,
          "league": "Ruby"
        },
        "s8": {
          "rank": 17,
          "league": "Ruby"
        },
        "s9": {
          "rank": 10,
          "league": "Ruby"
        },
        "s10": {
          "rank": 18,
          "league": "Ruby"
        },
        "s11": {
          "rank": 33,
          "league": "Ruby"
        },
        "s12": {
          "rank": 18,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "SEXTV",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10",
          "desc": "Top 10: S9.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×9",
          "desc": "Ruby in S3, S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "normalize#0130": {
      "name": "normalize#0130",
      "displayName": "normalize",
      "slug": "normalize",
      "legacy": 662,
      "rankedSeasons": 10,
      "top1000": 9,
      "top100": 7,
      "top10": 3,
      "best": {
        "rank": 5,
        "season": "s6"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 2 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 74,
        "league": "Diamond 1"
      },
      "career": {
        "s1": {
          "rank": 255,
          "league": "Diamond 1"
        },
        "s2": {
          "rank": 752,
          "league": "Diamond 2"
        },
        "s4": {
          "rank": 1562,
          "league": "Diamond 4"
        },
        "s5": {
          "rank": 10,
          "league": "Ruby"
        },
        "s6": {
          "rank": 5,
          "league": "Ruby"
        },
        "s7": {
          "rank": 36,
          "league": "Ruby"
        },
        "s8": {
          "rank": 75,
          "league": "Ruby"
        },
        "s10": {
          "rank": 64,
          "league": "Ruby"
        },
        "s11": {
          "rank": 6,
          "league": "Ruby"
        },
        "s12": {
          "rank": 74,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "LUMN",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×3",
          "desc": "Top 10: S5, S6, S11.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×6",
          "desc": "Ruby in S5, S6, S7, S8, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "varieyn#1933": {
      "name": "varieyn#1933",
      "displayName": "varieyn",
      "slug": "varieyn",
      "legacy": 653,
      "rankedSeasons": 11,
      "top1000": 10,
      "top100": 6,
      "top10": 0,
      "best": {
        "rank": 24,
        "season": "s11"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 1 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 33,
        "league": "Diamond 1"
      },
      "career": {
        "s2": {
          "rank": 86,
          "league": "Diamond 1"
        },
        "s3": {
          "rank": 260,
          "league": "Ruby"
        },
        "s4": {
          "rank": 1098,
          "league": "Diamond 4"
        },
        "s5": {
          "rank": 48,
          "league": "Ruby"
        },
        "s6": {
          "rank": 126,
          "league": "Ruby"
        },
        "s7": {
          "rank": 213,
          "league": "Ruby"
        },
        "s8": {
          "rank": 101,
          "league": "Ruby"
        },
        "s9": {
          "rank": 78,
          "league": "Ruby"
        },
        "s10": {
          "rank": 40,
          "league": "Ruby"
        },
        "s11": {
          "rank": 24,
          "league": "Ruby"
        },
        "s12": {
          "rank": 33,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "KCP",
      "badges": [
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×8",
          "desc": "Ruby in S3, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "yrg#5891": {
      "name": "yrg#5891",
      "displayName": "yrg",
      "slug": "yrg",
      "legacy": 651,
      "rankedSeasons": 10,
      "top1000": 9,
      "top100": 7,
      "top10": 2,
      "best": {
        "rank": 8,
        "season": "s8"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 1 more"
      ],
      "firstBeta": null,
      "current": null,
      "career": {
        "s2": {
          "rank": 1752,
          "league": "Diamond 2"
        },
        "s3": {
          "rank": 291,
          "league": "Ruby"
        },
        "s4": {
          "rank": 19,
          "league": "Ruby"
        },
        "s5": {
          "rank": 95,
          "league": "Ruby"
        },
        "s6": {
          "rank": 10,
          "league": "Ruby"
        },
        "s7": {
          "rank": 29,
          "league": "Ruby"
        },
        "s8": {
          "rank": 8,
          "league": "Ruby"
        },
        "s9": {
          "rank": 11,
          "league": "Ruby"
        },
        "s10": {
          "rank": 32,
          "league": "Ruby"
        },
        "s11": {
          "rank": 115,
          "league": "Ruby"
        }
      },
      "league": "Ruby",
      "club": "GOLOD",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10 ×2",
          "desc": "Top 10: S6, S8.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×9",
          "desc": "Ruby in S3, S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "Velo_freeze_tihi#3718": {
      "name": "Velo_freeze_tihi#3718",
      "displayName": "Velo_freeze_tihi",
      "slug": "velo-freeze-tihi",
      "legacy": 648,
      "rankedSeasons": 10,
      "top1000": 10,
      "top100": 8,
      "top10": 1,
      "best": {
        "rank": 5,
        "season": "s8"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 1 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 93,
        "league": "Diamond 1"
      },
      "career": {
        "s3": {
          "rank": 40,
          "league": "Ruby"
        },
        "s4": {
          "rank": 38,
          "league": "Ruby"
        },
        "s5": {
          "rank": 42,
          "league": "Ruby"
        },
        "s6": {
          "rank": 267,
          "league": "Ruby"
        },
        "s7": {
          "rank": 47,
          "league": "Ruby"
        },
        "s8": {
          "rank": 5,
          "league": "Ruby"
        },
        "s9": {
          "rank": 23,
          "league": "Ruby"
        },
        "s10": {
          "rank": 55,
          "league": "Ruby"
        },
        "s11": {
          "rank": 199,
          "league": "Ruby"
        },
        "s12": {
          "rank": 93,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "SNUS",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10",
          "desc": "Top 10: S8.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×9",
          "desc": "Ruby in S3, S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "kireki#6075": {
      "name": "kireki#6075",
      "displayName": "kireki",
      "slug": "kireki",
      "legacy": 639,
      "rankedSeasons": 12,
      "top1000": 12,
      "top100": 2,
      "top10": 0,
      "best": {
        "rank": 50,
        "season": "s1"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 4 more"
      ],
      "firstBeta": "ob",
      "current": {
        "rank": 75,
        "league": "Diamond 1"
      },
      "career": {
        "ob": {
          "rank": 1642,
          "league": "Diamond 1"
        },
        "s1": {
          "rank": 50,
          "league": "Diamond 1"
        },
        "s2": {
          "rank": 697,
          "league": "Diamond 2"
        },
        "s3": {
          "rank": 217,
          "league": "Ruby"
        },
        "s4": {
          "rank": 511,
          "league": "Diamond 2"
        },
        "s5": {
          "rank": 246,
          "league": "Ruby"
        },
        "s6": {
          "rank": 127,
          "league": "Ruby"
        },
        "s7": {
          "rank": 214,
          "league": "Ruby"
        },
        "s8": {
          "rank": 214,
          "league": "Ruby"
        },
        "s9": {
          "rank": 359,
          "league": "Ruby"
        },
        "s10": {
          "rank": 171,
          "league": "Ruby"
        },
        "s11": {
          "rank": 117,
          "league": "Ruby"
        },
        "s12": {
          "rank": 75,
          "league": "Diamond 1"
        }
      },
      "league": "Diamond 1",
      "club": "GOLOD",
      "badges": [
        {
          "id": "every-season",
          "tier": "epic",
          "label": "Ever-Present",
          "desc": "On the Ranked board in every season, S1 to S12.",
          "image": "/assets/badges/every-season.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×8",
          "desc": "Ruby in S3, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "SangWoo#9265": {
      "name": "SangWoo#9265",
      "displayName": "SangWoo",
      "slug": "sangwoo",
      "legacy": 626,
      "rankedSeasons": 7,
      "top1000": 5,
      "top100": 0,
      "top10": 0,
      "best": {
        "rank": 127,
        "season": "s9"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 3 more"
      ],
      "firstBeta": null,
      "current": null,
      "career": {
        "s5": {
          "rank": 1095,
          "league": "Diamond 3"
        },
        "s6": {
          "rank": 767,
          "league": "Diamond 2"
        },
        "s7": {
          "rank": 833,
          "league": "Diamond 2"
        },
        "s8": {
          "rank": 433,
          "league": "Ruby"
        },
        "s9": {
          "rank": 127,
          "league": "Ruby"
        },
        "s10": {
          "rank": 137,
          "league": "Ruby"
        },
        "s11": {
          "rank": 2463,
          "league": "Diamond 2"
        }
      },
      "league": "Ruby",
      "club": "KFOUR",
      "badges": [
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×3",
          "desc": "Ruby in S8, S9, S10.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "YangDoun#0398": {
      "name": "YangDoun#0398",
      "displayName": "YangDoun",
      "slug": "yangdoun",
      "legacy": 623,
      "rankedSeasons": 9,
      "top1000": 9,
      "top100": 4,
      "top10": 1,
      "best": {
        "rank": 9,
        "season": "s7"
      },
      "modes": [
        "Ranked",
        "World Tour",
        "… 3 more"
      ],
      "firstBeta": null,
      "current": {
        "rank": 176,
        "league": "Diamond 1"
      },
      "career": {
        "s4": {
          "rank": 21,
          "league": "Ruby"
        },
        "s5": {
          "rank": 142,
          "league": "Ruby"
        },
        "s6": {
          "rank": 500,
          "league": "Ruby"
        },
        "s7": {
          "rank": 9,
          "league": "Ruby"
        },
        "s8": {
          "rank": 28,
          "league": "Ruby"
        },
        "s9": {
          "rank": 14,
          "league": "Ruby"
        },
        "s10": {
          "rank": 249,
          "league": "Ruby"
        },
        "s11": {
          "rank": 154,
          "league": "Ruby"
        },
        "s12": {
          "rank": 176,
          "league": "Diamond 1"
        }
      },
      "league": "Ruby",
      "club": "APES",
      "badges": [
        {
          "id": "top10",
          "tier": "epic",
          "label": "Top 10",
          "desc": "Top 10: S7.",
          "image": "/assets/badges/top10.svg?v=2"
        },
        {
          "id": "ruby",
          "tier": "epic",
          "label": "Ruby ×8",
          "desc": "Ruby in S4, S5, S6, S7, S8, S9, S10, S11.",
          "image": "/assets/badges/ruby.svg?v=2"
        }
      ]
    },
    "…": "327 more fields"
  }
}

Try it

Badges

The badge catalogue: ranked finishes, leagues, modes and veteran badges, with how many players hold each.

GET/badges

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/badges" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/badges", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/badges",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "generatedAt": "2026-11-02T02:04:38.083Z",
  "players": 361750,
  "categories": [
    {
      "id": "ranked",
      "label": "Ranked finishes",
      "blurb": "Where you ended a Ranked season."
    },
    {
      "id": "leagues",
      "label": "Leagues",
      "blurb": "The league you finished a season in."
    },
    "… 4 more"
  ],
  "badges": [
    {
      "id": "champion",
      "cat": "ranked",
      "tier": "legendary",
      "name": "Champion",
      "how": "Finish a Ranked season at #1.",
      "image": "/assets/badges/champion.svg?v=2",
      "holders": 10,
      "pct": 0.0027643400138217,
      "rarity": "Mythic"
    },
    {
      "id": "dynasty",
      "cat": "ranked",
      "tier": "legendary",
      "name": "Dynasty",
      "how": "Finish #1 in Ranked in two or more seasons.",
      "image": "/assets/badges/dynasty.svg?v=2",
      "holders": 1,
      "pct": 0.00027643400138217,
      "rarity": "Mythic"
    },
    "… 44 more"
  ]
}

Try it

Items6 endpoints

Item sections

Weapons, gadgets, specializations, maps, modes, sponsors and cosmetics with counts and previews.

GET/items

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/items" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/items", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/items",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "sections": [
    {
      "key": "weapons",
      "label": "Weapons",
      "icon": "swords",
      "count": 38,
      "preview": [
        {
          "name": ".50 Akimbo",
          "url": "/items/weapons/50-akimbo",
          "image": {
            "url": "/assets/items/c5/50-akimbo-sideview-c564dcd5.webp",
            "width": 640,
            "height": 360
          }
        },
        {
          "name": "93R",
          "url": "/items/weapons/93r",
          "image": {
            "url": "/assets/items/44/93r-sideview-4451db49.webp",
            "width": 640,
            "height": 360
          }
        },
        "… 2 more"
      ]
    },
    {
      "key": "gadgets",
      "label": "Gadgets",
      "icon": "bolt",
      "count": 39,
      "preview": [
        {
          "name": "ANTI-GRAVITY CUBE",
          "url": "/items/gadgets/anti-gravity-cube",
          "image": {
            "url": "/assets/items/77/anti-gravity-cube-77c66eaf.webp",
            "width": 640,
            "height": 360
          }
        },
        {
          "name": "APS TURRET",
          "url": "/items/gadgets/aps-turret",
          "image": {
            "url": "/assets/items/5b/aps-turret-5ba076cb.webp",
            "width": 640,
            "height": 360
          }
        },
        "… 2 more"
      ]
    },
    "… 5 more"
  ],
  "builds": {
    "patch": "12.0.0",
    "list": [
      {
        "name": "Light",
        "health": 175,
        "regenDelay": 8,
        "blurb": "Smallest and fastest build. Lowest health, quickest regeneration."
      },
      {
        "name": "Medium",
        "health": 250,
        "regenDelay": 9,
        "blurb": "Balanced health and mobility. Support, healing and revives."
      },
      "… 1 more"
    ]
  },
  "cosmeticTypes": [
    {
      "type": "SKIN",
      "count": 3445
    },
    {
      "type": "BUNDLE",
      "count": 698
    },
    "… 43 more"
  ],
  "featured": [
    {
      "name": "CB2 GOOD EGG",
      "type": "STICKER",
      "rarity": "LEGENDARY",
      "url": "/items/cosmetics/cb2-good-egg-2",
      "image": {
        "url": "/assets/items/e1/epic-cb2-good-egg-e1f39cf9.webp",
        "width": 320,
        "height": 320
      }
    },
    {
      "name": "OSPUZE PERFORMIN'",
      "type": "SKIN",
      "rarity": "LEGENDARY",
      "url": "/items/cosmetics/ospuze-performin",
      "image": {
        "url": "/assets/items/6a/legendary-ospuze-performin-m60-6abe0bbb.webp",
        "width": 320,
        "height": 320
      }
    },
    "… 10 more"
  ]
}

Try it

Items of a section

Every item of a section with stats and images.

GET/items/{section}

Parameters

sectionstringpathrequired

weapons, gadgets, specializations, maps, modes, sponsors or cosmetics.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/items/weapons" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/items/weapons", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/items/weapons",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "kind": "weapon",
  "section": "weapons",
  "items": [
    {
      "kind": "weapon",
      "slug": "50-akimbo",
      "name": ".50 Akimbo",
      "url": "/items/weapons/50-akimbo",
      "build": "Heavy",
      "builds": [
        "Heavy"
      ],
      "category": "Handgun",
      "unlock": "Free",
      "tagline": "Dual, high-caliber handguns that deal high damage while sacrificing precision",
      "image": {
        "url": "/assets/items/c5/50-akimbo-sideview-c564dcd5.webp",
        "width": 640,
        "height": 360
      },
      "stats": {
        "bodyDamage": 46,
        "headshotDamage": 92,
        "rpm": 230,
        "magSize": 14,
        "reloadFull": 3,
        "reloadTactical": 2.2,
        "falloffMin": 32,
        "falloffMax": 39,
        "falloffMultiplier": 0.5,
        "damage": null,
        "cooldown": null,
        "ammo": null,
        "uses": null,
        "duration": null,
        "health": null
      },
      "skinCount": 75
    },
    {
      "kind": "weapon",
      "slug": "93r",
      "name": "93R",
      "url": "/items/weapons/93r",
      "build": "Light",
      "builds": [
        "Light"
      ],
      "category": "Handgun",
      "unlock": "500",
      "tagline": "Burst-fire machine pistol",
      "image": {
        "url": "/assets/items/44/93r-sideview-4451db49.webp",
        "width": 640,
        "height": 360
      },
      "stats": {
        "bodyDamage": 24,
        "headshotDamage": 36,
        "rpm": 210,
        "magSize": 27,
        "reloadFull": 1.75,
        "reloadTactical": 1.45,
        "falloffMin": 30,
        "falloffMax": 37.5,
        "falloffMultiplier": 0.5,
        "damage": null,
        "cooldown": null,
        "ammo": null,
        "uses": null,
        "duration": null,
        "health": null
      },
      "skinCount": 59
    },
    "… 36 more"
  ],
  "builds": [
    "Light",
    "Medium",
    "… 1 more"
  ],
  "categories": [
    "Assault Rifle",
    "Grenade Launcher",
    "… 8 more"
  ]
}

Try it

section *path

Item

Full detail of one item: damage, fire rate, magazine, class, images.

GET/items/{section}/{slug}

Parameters

sectionstringpathrequired

As above.

slugstringpathrequired

Item slug, e.g. akm.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/items/weapons/akm" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/items/weapons/akm", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/items/weapons/akm",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "kind": "weapon",
  "slug": "akm",
  "name": "AKM",
  "url": "/items/weapons/akm",
  "build": "Medium",
  "builds": [
    "Medium"
  ],
  "category": "Assault Rifle",
  "unlock": "Free",
  "tagline": "Fully automatic assault rifle",
  "summary": "The AKM (Avtomat Kalashnikova Modernizirovanny) is an automatic assault rifle available to the Medium class. It is best suited for dealin…",
  "image": {
    "url": "/assets/items/2a/akm-sideview-2a15ac6e.webp",
    "width": 640,
    "height": 360
  },
  "stats": {
    "bodyDamage": 21,
    "headshotDamage": 31.5,
    "rpm": 600,
    "magSize": 34,
    "reloadFull": 2.35,
    "reloadTactical": 2.35,
    "falloffMin": 30,
    "falloffMax": 37.5,
    "falloffMultiplier": 0.55,
    "damage": null,
    "cooldown": null,
    "ammo": null,
    "uses": null,
    "duration": null,
    "health": null
  },
  "raw": {
    "dps": "200",
    "rpm": "600",
    "crit": "31.5 (1.5×)",
    "build": "Medium",
    "wtype": "Assault Rifle",
    "unlock": "Free",
    "magsize": "34",
    "tacreload": "2.35s",
    "bodydamage": "21",
    "falloffmax": "37.5m",
    "falloffmin": "30m",
    "fullreload": "2.35s",
    "falloffmulti": "0.55",
    "environmentaldmgbar": "10"
  },
  "skinCount": 98,
  "statMax": {
    "bodyDamage": 122,
    "headshotDamage": 244,
    "rpm": 1500,
    "magSize": 300,
    "reloadFull": 5.25,
    "reloadTactical": 5,
    "falloffMin": 80,
    "falloffMax": 100,
    "falloffMultiplier": 0.8
  },
  "skins": [
    {
      "name": "YINYANG BANG",
      "rarity": "MYTHIC",
      "season": 8,
      "url": "/items/cosmetics/yinyang-bang",
      "image": {
        "url": "/assets/items/4c/mythic-yinyang-bang-akm-4cabd769.webp",
        "width": 320,
        "height": 320
      }
    },
    {
      "name": "OPEN BETA SHINE",
      "rarity": "LEGENDARY",
      "season": null,
      "url": "/items/cosmetics/open-beta-shine",
      "image": {
        "url": "/assets/items/06/legendary-open-beta-shine-akm-06be35ce.webp",
        "width": 320,
        "height": 320
      }
    },
    "… 46 more"
  ],
  "related": [
    {
      "name": "FAMAS",
      "url": "/items/weapons/famas",
      "image": {
        "url": "/assets/items/3c/famas-sideview-3c9abea3.webp",
        "width": 640,
        "height": 360
      },
      "category": "Assault Rifle"
    },
    {
      "name": "FCAR",
      "url": "/items/weapons/fcar",
      "image": {
        "url": "/assets/items/9d/fcar-side-view-9ddba35d.webp",
        "width": 640,
        "height": 360
      },
      "category": "Assault Rifle"
    },
    "… 6 more"
  ]
}

Try it

section *pathslug *path

Search items

Search across the whole item database.

GET/items/search

Query Parameters

qstringqueryrequired

Text.

kindstringquery

Restrict to a section.

limitintegerquery

Max results.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/items/search?q=ak&limit=3" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/items/search?q=ak&limit=3", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/items/search?q=ak&limit=3",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "query": "ak",
  "results": [
    {
      "kind": "weapon",
      "section": "weapons",
      "slug": "akm",
      "name": "AKM",
      "subtitle": "Medium · Assault Rifle",
      "rarity": null,
      "url": "/items/weapons/akm",
      "image": {
        "url": "/assets/items/2a/akm-sideview-2a15ac6e.webp",
        "width": 640,
        "height": 360
      }
    },
    {
      "kind": "cosmetic",
      "section": "cosmetics",
      "slug": "akimbanana",
      "name": "AKIMBANANA",
      "subtitle": "SKIN · .50 Akimbo",
      "rarity": "MYTHIC",
      "url": "/items/cosmetics/akimbanana",
      "image": {
        "url": "/assets/items/da/mythic-akimbanana-50-akimbo-dab04de2.webp",
        "width": 320,
        "height": 320
      }
    },
    "… 1 more"
  ]
}

Try it

q *querykindquerylimitquery

Cosmetic filters

Rarities, slots and sources available to filter cosmetics.

GET/items/cosmetics/facets

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/items/cosmetics/facets" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/items/cosmetics/facets", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/items/cosmetics/facets",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "types": [
    {
      "value": "BACKGROUND",
      "count": 208
    },
    {
      "value": "BADGE",
      "count": 112
    },
    "… 43 more"
  ],
  "rarities": [
    "COMMON",
    "RARE",
    "… 3 more"
  ],
  "seasons": [
    {
      "value": 12,
      "count": 231
    },
    {
      "value": 11,
      "count": 715
    },
    "… 10 more"
  ],
  "builds": [
    "Light",
    "Medium",
    "… 1 more"
  ],
  "equipment": [
    {
      "value": "50-akimbo",
      "label": ".50 Akimbo",
      "kind": "weapon",
      "count": 75
    },
    {
      "value": "93r",
      "label": "93R",
      "kind": "weapon",
      "count": 59
    },
    "… 86 more"
  ],
  "sponsors": [
    {
      "value": "alfa-acta",
      "label": "ALFA ACTA",
      "count": 156
    },
    {
      "value": "cometa",
      "label": "COMETA",
      "count": 86
    },
    "… 8 more"
  ],
  "sources": [
    {
      "value": "store",
      "label": "Store"
    },
    {
      "value": "battlepass",
      "label": "Battle pass"
    },
    "… 8 more"
  ]
}

Try it

Community loadouts

Loadouts shared by the community, with votes. /loadouts/meta gives the most used builds.

GET/loadouts

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/loadouts/meta" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/loadouts/meta", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/loadouts/meta",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "light": {
    "builds": 0,
    "specs": [],
    "weapons": [],
    "gadgets": []
  },
  "medium": {
    "builds": 0,
    "specs": [],
    "weapons": [],
    "gadgets": []
  },
  "heavy": {
    "builds": 0,
    "specs": [],
    "weapons": [],
    "gadgets": []
  }
}

Try it

Population1 endpoint

Player count

Live players and the estimate across platforms, today’s peak and the weekly pattern. /player-count/now gives just the live number.

GET/player-count

Query Parameters

No parameters.

Example Request

curl "https://public-api.arenyze.com/thefinals/api/player-count" \
  -H "api-key: YOUR_API_KEY"

const res = await fetch("https://public-api.arenyze.com/thefinals/api/player-count", {
  headers: { "api-key": process.env.ARENYZE_API_KEY },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://public-api.arenyze.com/thefinals/api/player-count",
    headers={"api-key": os.environ["ARENYZE_API_KEY"]},
    timeout=20,
)
data = r.json()

Example Response · live sample, trimmed

ResponseJSON

{
  "appId": 2073850,
  "now": {
    "steam": 18009,
    "at": "2026-11-03T01:36:54.919Z",
    "measured": true
  },
  "estimate": {
    "pc": 18009,
    "total": {
      "low": 30015,
      "mid": 36018,
      "high": 45023
    },
    "consoles": {
      "low": 12006,
      "mid": 18009,
      "high": 27014
    },
    "playstation": 11166,
    "xbox": 6843
  },
  "day": {
    "peak": 22893,
    "peakHourUtc": 20,
    "low": 8241,
    "lowHourUtc": 8,
    "avg": 15637,
    "position": 0.67
  },
  "week": {
    "days": [
      17249,
      14347,
      "… 5 more"
    ],
    "busiest": {
      "day": 6,
      "avg": 18378
    },
    "quietest": {
      "day": 1,
      "avg": 14347
    },
    "today": 2
  },
  "vsUsual": 21,
  "players": {
    "dailySteam": {
      "low": 150115,
      "mid": 187644,
      "high": 250192
    },
    "dailyAll": {
      "low": 250192,
      "mid": 375288,
      "high": 625480
    },
    "monthlyAll": {
      "low": 833973,
      "mid": 1501152,
      "high": 3127400
    }
  },
  "allTime": {
    "peak": 242399,
    "month": "2023-12"
  },
  "rhythm": {
    "hourFactorUtc": [
      1.19,
      1.18,
      "… 22 more"
    ],
    "weekdayFactorUtc": [
      1.07,
      0.89,
      "… 5 more"
    ]
  },
  "model": {
    "consoleShare": {
      "low": 0.4,
      "mid": 0.5,
      "high": 0.6
    },
    "playstationShareOfConsole": 0.62,
    "sessionHours": {
      "low": 2.5,
      "mid": 2,
      "high": 1.5
    },
    "stickiness": {
      "low": 0.3,
      "mid": 0.25,
      "high": 0.2
    },
    "baselineSteam": 13000
  },
  "milestones": [
    {
      "at": "2023-11-05",
      "label": "Open beta",
      "value": 7500000,
      "text": "players across PC, PS5 and Xbox in the week-long open beta"
    },
    {
      "at": "2023-12-07",
      "label": "Launch",
      "value": null,
      "text": "Season 1 launch on PC, PS5 and Xbox Series X|S"
    },
    "… 1 more"
  ]
}

Try it