Pokemon Champions Battle Data API

const index = await fetch("https://championsbattledata.com/api")
  .then((response) => response.json());

const garchomp = await fetch(
  "https://championsbattledata.com/api/pokemon/garchomp?format=Doubles"
).then((response) => response.json());

const dailyRows = await fetch(
  "https://championsbattledata.com/api/battle/Doubles/garchomp?season=M4&days=7"
).then((response) => response.json());

pokemon_champions_assets/
  battle_data/
    Doubles/
      Garchomp.csv                    <- current Doubles data
      Raichu-Alola.csv                <- battle data files use Showdown names
    Singles/
      Garchomp.csv                    <- current Singles data
    M5/
      08_09_2026/
        Doubles/
          Garchomp.csv                <- daily Doubles snapshot
        Singles/
          Garchomp.csv                <- daily Singles snapshot
    M4/                               <- finished season, JSON API only
  metadata/
    Tauros.csv                        <- one file with all Tauros forms
  pokemon/
    Tauros.png
    Paldean Tauros Aqua Breed.png
  types/
    Dragon.png

GET /api/battle/Doubles/garchomp
GET /api/battle/Doubles/rotomwash
GET /api/battle/Doubles/taurospaldeaaqua
GET /api/battle/Singles/raichualola
GET /api/battle/Singles/taurospaldeaaqua
GET /api/battle/Singles/basculegionf

showdownId

The matched Pokemon Showdown internal ID, for example raichualola.

showdownName

The standardized Showdown species name, for example Raichu-Alola.

saved_name

The form-specific name sprite files are named after. Battle data CSVs use the Showdown name instead, for example Raichu-Alola.csv.

defaultSeason

Current, backed by battle_data/Doubles and battle_data/Singles.

dailyDataFolders

Dated snapshot folders such as M4/16_07_2026.

pokemon[].showdownId

The Pokemon Showdown internal ID accepted by API routes.

pokemon[].battleDataCsvs

Current and daily source CSV paths for that Pokemon.

{
  "season": "M6",
  "format": "Doubles",
  "seasons": ["Current", "M7", "M6", "M5", "M4", "M3", "M2", "M1"],
  "total": 262,
  "offset": 0,
  "count": 2,
  "rankings": [
    { "position": 1, "name": "Sneasler", "battleName": "Sneasler", "slug": "sneasler", "showdownId": "sneasler" },
    { "position": 2, "name": "Rillaboom", "battleName": "Rillaboom", "slug": "rillaboom", "showdownId": "rillaboom" }
  ]
}

format

Doubles (the default) or Singles.

season

Any season the index lists. Current by default; an archived season answers with the standings as it closed.

limit, offset

A slice of the list, in position order. The whole list is returned when neither is given.

name

One Pokemon, by Showdown ID, slug or name; answers with that entry and its position.

position

The rank, from 1. It is the game's own ordering; there is no species-level usage percentage in the battle data to report beside it.

{
  "name": "Garchomp",
  "showdownId": "garchomp",
  "requestedFormat": "Doubles",
  "requestedSeason": "Current",
  "battleDataCsv": {
    "season": "Current",
    "format": "Doubles",
    "path": "pokemon_champions_assets/battle_data/Doubles/Garchomp.csv"
  },
  "dailyBattleDataCsvs": [
    {
      "season": "M4",
      "date": "23_07_2026",
      "format": "Doubles",
      "path": "pokemon_champions_assets/battle_data/M4/23_07_2026/Doubles/Garchomp.csv"
    }
  ],
  "dailyBattleSummary": [
    {
      "season": "M4",
      "date": "23_07_2026",
      "format": "Doubles",
      "source": "pokemon_champions_assets/battle_data/M4/23_07_2026/Doubles/Garchomp.csv",
      "summary": { "top": { "move": { "name": "Dragon Claw" } } }
    }
  ]
}

{
  "pokemon": "Garchomp",
  "showdownId": "garchomp",
  "format": "Doubles",
  "season": "Current",
  "source": "pokemon_champions_assets/battle_data/Doubles/Garchomp.csv",
  "rows": [
    {
      "position": 1,
      "category": "move",
      "rank": 1,
      "name": "Earthquake",
      "percentage": "90.3%",
      "percentage_value": 90.3
    }
  ]
}

{
  "pokemon": "Garchomp",
  "showdownId": "garchomp",
  "format": "Doubles",
  "requestedDays": 7,
  "season": "M4",
  "daily": [
    {
      "season": "M4",
      "date": "23_07_2026",
      "source": "pokemon_champions_assets/battle_data/M4/23_07_2026/Doubles/Garchomp.csv",
      "columns": ["pokemon", "column_position", "category", "rank", "name", "percentage"],
      "rows": []
    }
  ]
}

days

Integer from 1 to 31.

season

Optional season folder such as M4. If omitted, the newest daily snapshots across seasons are used.

daily[].date

Date folder in DD_MM_YYYY format.

{
  "pokemon": "Tauros",
  "source": "pokemon_champions_assets/metadata/Tauros.csv",
  "rows": [
    {
      "title": "Tauros [Paldean Form (Aqua Breed)]",
      "base_name": "Tauros",
      "saved_name": "Paldean Tauros Aqua Breed",
      "types": "Fighting/Water",
      "abilities": "Intimidate|Anger Point|Cud Chew",
      "image_path": "pokemon_champions_assets/pokemon/Paldean Tauros Aqua Breed.png",
      "form": "Paldean Aqua Breed",
      "hp": 150, "atk": 130, "def": 125,
      "spa": 50, "spd": 90, "spe": 120, "total": 665
    },
    {
      "title": "Tauros [Paldean Form (Blaze Breed)]",
      "base_name": "Tauros",
      "saved_name": "Paldean Tauros Blaze Breed",
      "types": "Fighting/Fire",
      "abilities": "Intimidate|Anger Point|Cud Chew",
      "image_path": "pokemon_champions_assets/pokemon/Paldean Tauros Blaze Breed.png",
      "form": "Paldean Blaze Breed",
      "hp": 150, "atk": 130, "def": 125,
      "spa": 50, "spd": 90, "spe": 120, "total": 665
    },
    {
      "title": "Tauros",
      "base_name": "Tauros",
      "saved_name": "Tauros",
      "types": "Normal",
      "abilities": "Intimidate|Anger Point|Sheer Force",
      "image_path": "pokemon_champions_assets/pokemon/Tauros.png",
      "form": "",
      "hp": 150, "atk": 120, "def": 115,
      "spa": 60, "spd": 90, "spe": 130, "total": 665
    }
  ]
}

base_name

The shared Pokémon name. Matches the metadata filename and the /api/metadata/:name route parameter.

saved_name

The form-specific name used for sprites. The /api/battle/:format/:name route accepts it as well as the Showdown ID.

form

Human-readable form label. Empty string for the base form.

abilities

Pipe-separated list of all abilities for this form.

GET /pokemon_champions_assets/battle_data/Doubles/Garchomp.csv
GET /pokemon_champions_assets/battle_data/Singles/Garchomp.csv


GET /pokemon_champions_assets/battle_data/M5/08_09_2026/Doubles/Garchomp.csv
GET /pokemon_champions_assets/battle_data/M5/08_09_2026/Singles/Garchomp.csv


GET /pokemon_champions_assets/metadata/Tauros.csv


GET /pokemon_champions_assets/pokemon/Tauros.png
GET /pokemon_champions_assets/pokemon/Paldean%20Tauros%20Aqua%20Breed.png


GET /pokemon_champions_assets/types/Dragon.png

const index = await fetch("/api")
  .then((response) => response.json());

const fastGroundTypes = index.pokemon.filter((entry) => {
  const stats = entry.summary?.baseStats ?? {};
  const types = entry.summary?.types ?? [];

  return types.includes("Ground")
    && Number(stats.speed ?? 0) >= 100;
});