SWU Meta Stats / Crimson Dawn LogoSWU Meta Stats / Crimson Dawn LogoSWUMeta Stats
Meta Window
SWU Meta Stats / Crimson Dawn LogoSWU Meta Stats / Crimson Dawn LogoSWUMeta Stats
Meta Window
  • Home

    • Meta Analysis

  • Meta Overview
  • Weekly Report
  • KyberScore Tierlist
  • Card Database

    • Competitive

  • Archetypes
  • Tournaments
  • Decklists
  • Players
  • Community
  • About the Site
  • FAQ

API Documentation

Last updated: Sep 12, 2026, 04:59 AM UTC

Endpoints

Meta BoundariesArchetypesTournamentsDecklistsCardsMatchupsTier ListLeader TrendsPlayers

Overview

SWU Meta Stats provides a public read-only REST API for Star Wars: Unlimited competitive data. All endpoints return JSON and require no authentication. Abuse protection is enforced server-side, and sensitive write-style endpoints use stricter per-IP request limits that return a 429 Too Many Requests response when exceeded.

Base URL: https://swumetastats.com

Most statistical endpoints accept startDate and endDate query parameters to scope data to a meta window. Date parameters should use YYYY-MM-DD. Use /api/meta-boundaries to discover available windows.

If you build something with this API, feel free to reach out — we'd love to know about it.

OpenAPI 3.1/openapi.json·Open in Swagger EditorOpen in Redoc·/llms.txt

Meta Boundaries

GET/api/meta-boundaries

Returns all meta boundary windows (sets and balance patches). Each boundary defines a date range used to scope statistics throughout the site.

Returns

Array of meta boundary objects with label, start/end dates, and set code.

Example

https://swumetastats.com/api/meta-boundaries

Archetypes

GET/api/archetypes

Returns aggregated statistics for all archetypes within the specified meta window. An archetype is a unique leader + base combination.

Parameters

NameTypeRequiredDescription
startDatestring (ISO date)optionalStart of date range (e.g. 2025-01-01)
endDatestring (ISO date)optionalEnd of date range
leaderAspectstringoptionalComma-separated aspect filter for leaders (e.g. aggression,command)
baseAspectstringoptionalComma-separated aspect filter for bases
placementstringoptionalOne of: all, winners, top8, top16, top32 (default: all)
searchstringoptionalFilter by leader or base name

Returns

Object with archetypes array (win rate, meta share, record, top8 rate) and leaderStats map.

Example

https://swumetastats.com/api/archetypes?startDate=2026-03-13&placement=top8
GET/api/archetypes/[leader]/[base]

Returns detailed statistics for a single archetype. The leader and base values are URL-encoded card names. Spaces become %20; the pipe character (|) can be URL-encoded as %7C or omitted — the API uses fuzzy matching to resolve the correct card name.

Parameters

NameTypeRequiredDescription
leaderstring (path)requiredURL-encoded leader card name
basestring (path)requiredURL-encoded base card name or base group label (e.g. Vigilance%2030%20HP)
startDatestring (ISO date)optionalStart of date range
endDatestring (ISO date)optionalEnd of date range

Returns

Full archetype detail: win rate, card breakdowns (core/popular/flex), matchup data, and recent decklists.

Example

https://swumetastats.com/api/archetypes/Han%20Solo%20%7C%20Reluctant%20Hero/Vigilance%2030%20HP?startDate=2026-03-13
GET/api/archetype-trends

Returns weekly time-series data for one or more archetypes across various metrics.

Parameters

NameTypeRequiredDescription
leaderNamestringoptionalFilter to a single leader name
baseNamestringoptionalFilter to a specific base name
archetypesstring (JSON array)optionalComma-separated URL-encoded JSON objects [{leaderName, baseName}] for multiple archetypes
metricsstringoptionalComma-separated metrics: winrate, metashare, top8, conversion, decks
topCountnumberoptionalLimit to top N archetypes by meta share
startDatestring (ISO date)optionalStart of date range
endDatestring (ISO date)optionalEnd of date range

Returns

Weekly trend data per archetype per metric.

Example

https://swumetastats.com/api/archetype-trends?metrics=winrate,metashare&topCount=5&startDate=2026-03-13

Tournaments

GET/api/tournaments

Returns a paginated list of tournaments, or searches by name / Melee ID.

Parameters

NameTypeRequiredDescription
searchstringoptionalSearch by tournament name
meleeIdstringoptionalLook up a specific tournament by its Melee.gg ID
startDatestring (ISO date)optionalFilter tournaments on or after this date
endDatestring (ISO date)optionalFilter tournaments on or before this date
skipnumberoptionalOffset for pagination (default: 0)
takenumberoptionalPage size (default: 20)

Returns

Object with tournaments array and totalCount, or Tournament[] when using search/meleeId.

Example

https://swumetastats.com/api/tournaments?startDate=2026-03-13&take=10

Decklists

GET/api/decklists

Returns a paginated list of decklists with optional filters.

Parameters

NameTypeRequiredDescription
startDatestring (ISO date)optionalFilter decklists from tournaments on or after this date
endDatestring (ISO date)optionalFilter decklists from tournaments on or before this date
leaderNamestringoptionalFilter by leader card name
baseNamestringoptionalFilter by base card name
leaderAspectsstringoptionalComma-separated leader aspects
baseAspectsstringoptionalComma-separated base aspects
placementstringoptionalOne of: all, winners, top8 (default: all)
tournamentIdstringoptionalFilter to a specific tournament
searchstringoptionalSearch by player name
skipnumberoptionalOffset for pagination (default: 0)
takenumberoptionalPage size (default: 20)

Returns

Object with decklists array and totalCount.

Example

https://swumetastats.com/api/decklists?startDate=2026-03-13&placement=top8&take=10

Cards

GET/api/cards

Returns card data with optional usage statistics.

Parameters

NameTypeRequiredDescription
typestringrequiredOne of: leaders, bases, all
includeUsagebooleanoptionalInclude usage stats (pct1/pct2/pct3) when type=all
sortBystringoptionalSort field: usage, name, cost (default: name for leaders/bases, usage for all)
sortDirstringoptionalasc or desc
searchstringoptionalFilter by card name
pagenumberoptionalPage index (default: 0)
pageSizenumberoptionalResults per page (default: 20)
startDatestring (ISO date)optionalMeta window start (used with includeUsage)
endDatestring (ISO date)optionalMeta window end (used with includeUsage)

Returns

Leader/base arrays, or paginated { cards, totalCount } for type=all.

Example

https://swumetastats.com/api/cards?type=all&includeUsage=true&sortBy=usage&sortDir=desc&pageSize=20

Matchups

GET/api/matchups

Returns pairwise matchup win rates between archetypes for the specified meta window.

Parameters

NameTypeRequiredDescription
startDatestring (ISO date)optionalStart of date range
endDatestring (ISO date)optionalEnd of date range
placementstringoptionalOne of: all, winners, top8 (default: all)
minPlayersnumberoptionalMinimum games played to include a matchup (default: 5)
tournamentIdstringoptionalScope to a single tournament

Returns

Object with matchups array (archetypeA, archetypeB, wins, losses, winRate) and leaderSets map.

Example

https://swumetastats.com/api/matchups?startDate=2025-11-07&endDate=2026-03-12

Tier List

GET/api/tierlist

Returns tier list data. The mode parameter is required and controls the response shape.

Parameters

NameTypeRequiredDescription
modestringrequiredOne of: kyberscore (ranked by KyberScore), raw (win rate ranked), weeks (available week start dates), live (single week stats), snapshot (single week snapshot payload)
formatstringoptionalOne of: Premier (default), Eternal
startDatestring (YYYY-MM-DD)optionalMeta window start (raw/kyberscore), or start of explicit live window (must be paired with endDate)
endDatestring (YYYY-MM-DD)optionalMeta window end (raw/kyberscore), or end of explicit live window (must be paired with startDate)
datestring (YYYY-MM-DD)optionalShorthand meta boundary start date override (raw/kyberscore)
weekstring (YYYY-MM-DD)optionalWeek anchor date (mode=live or mode=snapshot); canonical window resolves to Tuesday→Monday

Returns

weeks → string[]; raw/kyberscore → { tierlist: ArchetypeStat[] }; live/snapshot → { weekStart, tournamentCount, playerCount, snapshots }.

Example

https://swumetastats.com/api/tierlist?mode=kyberscore&startDate=2026-03-13

Leader Trends

GET/api/leader-trends

Returns weekly time-series trend data per leader card.

Parameters

NameTypeRequiredDescription
metricstringrequiredOne of: winrate, conversion, metashare, wins, top8, decks, losses
leadersstringoptionalComma-separated leader names to include (defaults to top leaders)
topCountnumberoptionalReturn top N leaders by meta share (default: 10)
startDatestring (ISO date)optionalStart of date range
endDatestring (ISO date)optionalEnd of date range

Returns

Object with trends array, leaders list, leaderAspects map, and weeks list.

Example

https://swumetastats.com/api/leader-trends?metric=winrate&topCount=5&startDate=2026-03-13

Players

GET/api/players/search

Searches and paginates players who have recorded tournament standings.

Parameters

NameTypeRequiredDescription
searchstringoptionalFilter by player name or username
sortstringoptionalSort order: alphabetical (default), wins, tournaments, conversion
skipnumberoptionalOffset for pagination (default: 0)
takenumberoptionalPage size (default: 20)

Returns

Object with data array (id, name, username, meleeId, winCount, top8Count, tournamentCount) and totalCount.

Example

https://swumetastats.com/api/players/search?search=Luke&take=10

Data is sourced from Melee.gg tournament results. Card information is provided by the official Star Wars: Unlimited card database and swu-db.com.

Have a question or found an issue? [email protected]

Support the ongoing development and server costs of SWU Meta Stats

Patreon LogoSupport on PatreonBuy Me A CoffeeTCGPlayer Affiliate Link
API DocsOpenAPIllms.txt
© SWU Meta Stats. All rights reserved.This site is an unofficial fan-run resource and is not affiliated with, endorsed by, or sponsored by Lucasfilm Ltd., Fantasy Flight Games®, or Asmodee.