brawlstars-ranked

Brawl Stars Ranked Matches — season54

Ranked match telemetry from the public Brawl Stars API, one row per ranked set. A set is up to three games on one fixed map and mode, first team to two wins; record holds the game-by-game outcome.

Collected and published automatically by an open-source ETL pipeline.

At a glance

Seasons

This page shows season54, the season in progress. It is refreshed every time the crawler runs, so the numbers above move during the season.

Each season is its own config, because they are not interchangeable — see Limitations. Earlier seasons: season53.

Loading

from datasets import load_dataset

# season54, the current season — the default when no config is named.
ds = load_dataset("EliF77/brawlstars-ranked", split="train")

# An earlier season, by name.
old = load_dataset("EliF77/brawlstars-ranked", "season53", split="train")

Each season is one file, written in time order. Parquet stores the min and max of every row group, so a reader asking for a date range skips the groups that cannot match rather than scanning the season:

import pyarrow.dataset as ds_
table = ds_.dataset("data", partitioning="hive").to_table(
    filter=ds_.field("battle_time") >= "20251110T000000.000Z"
)

Columns

One row per ranked set. Core fields cover time, mode, map, and the record; the six drafted brawlers are flattened into t{team}_b{slot}_* columns.

Every participant is identified, not only the star player, so a set can be joined to all six players in it. star_player_tag matches one of the six.

Filter on skill_ns_ok = 1 for analyses that depend on the skill feature.

Why skill_ns exists

Ranked elo resets each season and re-stratifies over the following weeks, so an average of 16 in week one describes a very different match from an average of 16 in week three. skill_ns converts each set's avg_elo to a percentile within a fixed 3-day time bin and maps it to a symmetric unbounded scale, making matches comparable across the season.

Modes and maps

Modes: bounty, brawlBall, gemGrab, heist, hotZone, knockout

Maps: Belle's Rock, Bridge Too Far, Center Stage, Double Swoosh, Dry Season, Dueling Beetles, Flaring Phoenix, Gem Fort, Hard Rock Mine, Hideout, Hot Potato, In the Liminal, Kaboom Canyon, Layer Cake, New Horizons, Open Business, Out in the Open, Parallel Plays, Pinball Dreams, Quick Travel, Ring of Fire, Safe Zone, Shooting Star, Sneaky Fields, Triple Dribble, Undermine

Most-picked brawlers

Limitations

• No draft order and no bans. The API returns the six final brawlers with no pick sequence, and the slot index is positional, not draft order.
• Not a uniform sample. Rows are gathered by crawling the player graph breadth-first from seed players, filtered to a target elo band. Popular and higher-rated players are over-represented relative to the whole population.
• One season at a time. Balance changes shift the meta between seasons, so pooling them mixes distinct regimes. Each season is a separate config for that reason; loading two and concatenating them is a decision to make deliberately, not a default.
• Elo is per-brawler, not per-player: a strong player on an unfamiliar brawler carries a low rating into the match.

Provenance

Built from soloRanked battles only. Deduplicated on (battle_time, map, star_player_tag). Sets with an average elo above 23 are dropped as bot or corrupted records. Full pipeline documentation and design notes are in the source repository.

License and attribution

MIT for the pipeline and this dataset compilation. Derived from the public Brawl Stars API. Not affiliated with, endorsed, sponsored, or specifically approved by Supercell; fan content made under Supercell's Fan Content Policy.