--- title: "Onslaught leaderboard" method: GET path: "/{region}/players/onslaught" tags: ["Players"] --- # Onslaught leaderboard `GET /{region}/players/onslaught` ## Request - Base URL: `https://unicum.gg/api` - URL: `https://unicum.gg/api/{region}/players/onslaught` - Auth: none required The Onslaught (Competitive 7) ranked leaderboard for a region, ## Path parameters - `region` 'eu' | 'na' | 'asia', required: Game server region. ## Query parameters - `limit` integer: Maximum number of rows to return. Out-of-range values are clamped. - `season` string: Season event id to load (default the current season). From the seasons list in the response. ## Response `200` Successful response - OnslaughtResponse - `season` OnslaughtSeason, required: Onslaught season metadata. - `eventId` string, required - `name` string, required - `codename` string, nullable, required: Season codename ('Season of the Jade Dragon'), from the client; null if unavailable. - `seasonOrdinal` string, nullable, required: Season ordinal word ('third' for Jade), selecting its themed rank art. - `assetsRef` string, nullable, required: Mirror commit to build rank-art URLs from (null = live branch); pins a past season's art to when it was live. - `startDate` string, nullable, required - `endDate` string, nullable, required - `ended` boolean, required: True once the season has ended (standings are final). - `elitePosition` number, nullable, required: Top N ranks that are Elite tier. - `masterPosition` number, nullable, required: Top N ranks that are at least Master (as far as the board reaches). - `lastRecalculationTs` number, nullable, required: Unix seconds of the source's last leaderboard recompute. - `seasons` OnslaughtSeasonRef[], required - `key` string, required: Stable list key. - `label` string, required: Display label ('Season of the Jade Dragon' or 'Year of the Griffin'). - `ordinal` string, nullable, required: Season ordinal word ('third'), which is how the client keys its own season names. Null for a year archive. - `available` boolean, required: True when we hold standings for this season (selectable). - `eventId` string, nullable, required: Season id to navigate to (available seasons only). - `results` OnslaughtSummary[], required - `rank` number, required: Leaderboard position (1-based), from the game source. - `account_id` number, required - `nickname` string, required: Current nickname, resolved by account_id. - `clan_tag` string, nullable, required - `clan_color` string, nullable, required - `recordedNickname` string, required: Nickname as recorded on the leaderboard when ranked. - `recordedClanTag` string, nullable, required - `recordedClanColor` string, nullable, required - `rating` number, required: Season score / rating points (the ranking metric). - `battles` number, required: Battles played in the mode over the season. - `activeDays` number: Days this account was seen playing, from our own capture archive. Absent for a season we hold no captures of. - `battlesPerDay` number: Battles per day PLAYED (not per day of the season): observed battles divided by activeDays. - `pointsPerDay` number: Rating points won or lost per day played. Negative for a player who is losing ground. - `pointsPerBattle` number: Rating points per observed battle. Excludes the account's entry state, which belongs to no day. - `lastActiveAt` number: Unix seconds of the last capture where this account's battle count moved. - `entryBattles` number: Battles played in the mode by the time the account first appeared on the board: what qualifying cost. Absent for a season we hold no captures of, and for the few already ranked when the capture began. - `wn7` number, nullable, required: The account's overall WN7, for the board's tier summary. - `wn8` number, nullable, required - `wnx` number, nullable, required - `is_verified` boolean - `tournament_wins` number: Tournaments this account was on the winning roster of, for the winner's crest. - `tournament_featured_wins` number - `tournament_best_title` string, nullable - `onslaught_best_tier` string, nullable - `onslaught_best_rank` number, nullable - `onslaught_seasons` number - `is_supporter` boolean - `twitch_login` string, nullable - `previous` OnslaughtPreviousSeason, required: How the previous Onslaught season ended. - `eventId` string, required - `codename` string, nullable, required: That season's codename, for the reader's own language. - `seasonOrdinal` string, nullable, required - `startDate` string, nullable, required - `endDate` string, nullable, required - `ranked` number, required: Players holding a place when it settled, which is what the running season's count is heading towards. - `legendPoints` number, nullable, required: What Legend cost at the end: the rating at the last Legend position. - `championPoints` number, nullable, required: The board's floor at the end, which is Champion's threshold. - `legendBattles` number, nullable, required: Median battles its Legends had played over the WHOLE season. Comparable to a finished season, not to a running one, since the field nearly triples before it settles. - `championBattles` number, nullable, required: The same for the players who ended Champion. - `dropouts` OnslaughtDropout[], required: Players who held a place this season and lost it, newest first. Recovered from our own daily fold, since the standings only carry who is ranked now. Empty for a season we hold no captures of. - `account_id` number, required - `nickname` string, required - `clan_tag` string, nullable, required - `clan_color` string, nullable, required - `bestRank` number, required: The best position they reached before losing the place. - `lastRank` number, required: Where they stood the last time we saw them on the board. - `lastRating` number, required - `battles` number, required: Battles played in the mode when they were last seen. - `lastSeenAt` number, required: Unix seconds of the last capture that still had them on the board. - `is_verified` boolean - `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 - `is_supporter` boolean - `twitch_login` string, nullable --- [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)