---
title: "Win rate by tier and rating band"
method: GET
path: "/{region}/players/winrate-by-tier"
tags: ["Players"]
---

# Win rate by tier and rating band

`GET /{region}/players/winrate-by-tier`

## Request

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

What each band of the region's players wins at each tier: the band's wins at that tier over its battles there. Rebuilt nightly as a by-product of the pass over the per-vehicle snapshots, the only place a win rate per tier exists. 404 until the first run. Dates are ISO 8601 strings.

## Path parameters

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

## Response `200`

Successful response

- TierWinrate: What each band of a region's players wins at each tier of vehicle.
  - `region` 'eu' | 'na' | 'asia', required: Game server region.
  - `minBattles` number, required: Battles a player needs on a vehicle before it counts towards their tiers, so the grid describes the tiers as played by the people who play them.
  - `metrics` object, required: One grid per rating metric, so a reader's chosen metric is served rather than one being picked for them.
    - `wn7` TierWinrateCell[], required
      - `tier` number, required
      - `band` 'veryBad' | 'bad' | 'belowAvg' | 'average' | 'good' | 'veryGood' | 'super' | 'excellent' | 'top', required: Rating band the players of this cell belong to, on the metric this grid is filed under. The band's numeric edges are the site's own rating colour thresholds.
      - `bandFrom` number, nullable, required: Lower edge of the band, included. Null at the bottom of the scale. These are the edges the row was banded with, not today's thresholds, so a threshold that moves later cannot relabel a row it never measured.
      - `bandTo` number, nullable, required: Upper edge of the band, excluded. Null at the top of the scale.
      - `players` number, required: Accounts of the band with a qualifying vehicle at the tier.
      - `battles` number, required
      - `wins` number, required
      - `winrate` number, required: Battle-weighted win rate, 0..1: the band's wins at this tier over its battles there, not the mean of its players' own win rates.
    - `wn8` TierWinrateCell[], required
      - `tier` number, required
      - `band` 'veryBad' | 'bad' | 'belowAvg' | 'average' | 'good' | 'veryGood' | 'super' | 'excellent' | 'top', required: Rating band the players of this cell belong to, on the metric this grid is filed under. The band's numeric edges are the site's own rating colour thresholds.
      - `bandFrom` number, nullable, required: Lower edge of the band, included. Null at the bottom of the scale. These are the edges the row was banded with, not today's thresholds, so a threshold that moves later cannot relabel a row it never measured.
      - `bandTo` number, nullable, required: Upper edge of the band, excluded. Null at the top of the scale.
      - `players` number, required: Accounts of the band with a qualifying vehicle at the tier.
      - `battles` number, required
      - `wins` number, required
      - `winrate` number, required: Battle-weighted win rate, 0..1: the band's wins at this tier over its battles there, not the mean of its players' own win rates.
    - `wnx` TierWinrateCell[], required
      - `tier` number, required
      - `band` 'veryBad' | 'bad' | 'belowAvg' | 'average' | 'good' | 'veryGood' | 'super' | 'excellent' | 'top', required: Rating band the players of this cell belong to, on the metric this grid is filed under. The band's numeric edges are the site's own rating colour thresholds.
      - `bandFrom` number, nullable, required: Lower edge of the band, included. Null at the bottom of the scale. These are the edges the row was banded with, not today's thresholds, so a threshold that moves later cannot relabel a row it never measured.
      - `bandTo` number, nullable, required: Upper edge of the band, excluded. Null at the top of the scale.
      - `players` number, required: Accounts of the band with a qualifying vehicle at the tier.
      - `battles` number, required
      - `wins` number, required
      - `winrate` number, required: Battle-weighted win rate, 0..1: the band's wins at this tier over its battles there, not the mean of its players' own win rates.
  - `computedAt` string, date-time, nullable, required: When the grid was last rebuilt. It is a by-product of the nightly pass over the per-vehicle snapshots, so it moves once a day.

---

[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)