---
title: "Top players"
method: GET
path: "/{region}/players/top"
tags: ["Players"]
---

# Top players

`GET /{region}/players/top`

## Request

- Base URL: `https://unicum.gg/api`
- URL: `https://unicum.gg/api/{region}/players/top`
- Auth: none required

Player leaderboard for a region.

## Path parameters

- `region` 'eu' | 'na' | 'asia', required: Game server region.

## Query parameters

- `period` '24h' | '7d' | '30d' | 'overall': Leaderboard time window.
- `limit` integer: Maximum number of rows to return. Out-of-range values are clamped.
- `metric` 'wn7' | 'wn8' | 'wnx': Rating metric the leaderboard is ranked by.
- `lang` string: Two-letter language code. When set, the leaderboard is filtered to players whose clan history infers this language, over the requested period like the unfiltered board.
- `language` string: Deprecated alias of `lang`, accepted while callers move. `lang` wins when both are given. Renamed because `language` elsewhere in this API asks for the language the ANSWER is written in, and this one selects which rows are in it.
- `strict` 'true' | 'false': With `lang`: only count clans that declare exactly this one language.
- `languages` 'true' | 'false': Return the lifetime by-language board (each row carries its inferred languages) without filtering to one language. The recent periods always carry them.

## Response `200`

Successful response

- TopPlayersResponse
  - `results` PlayerSummary[], required
    - `account_id` number, required
    - `nickname` string, required
    - `winrate` number, nullable
    - `wnx_30d` number, nullable
    - `battles_30d` number, nullable
    - `is_verified` boolean
    - `is_supporter` boolean
    - `twitch_login` string, nullable
    - `tournament_wins` number
    - `tournament_featured_wins` number
    - `tournament_best_title` string, nullable
    - `onslaught_best_tier` string, nullable
    - `onslaught_best_rank` number, nullable
    - `onslaught_seasons` number
  - `computed_at` string, nullable, required

---

[API](https://skmtc.dev/unicum/apis/unicum-gg-api.md) · [All operations](https://skmtc.dev/unicum/apis/unicum-gg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unicum/apis/unicum-gg-api/revisions/7a7d79a26001?raw)