How are Leaders represented?

Leaders expose a faces array containing the leader side and the deployed unit side, each with its own cost, power, HP and ability text.

Are leaders and bases returned by a normal card search?

Yes, distinguished by cardType, so you can include or exclude them deliberately. Most builders want three separate queries — one for leaders, one for bases and one for the deck itself — because the three fill different slots and are chosen at different points in the process.

How do I model the aspect penalty?

Take the union of your leader's and base's aspects, and for each card compare its aspects against that set. Every aspect not covered adds two to the effective cost. All the data needed is on the card and leader objects, so it is a pure client-side calculation with no extra requests.

Do you cover the Japanese and other localised printings?

Yes, keyed to the same card so you can switch display language without changing your queries. The English release is the reference print run and localised versions are linked to it rather than being carried as separate cards.

How volatile are Star Wars: Unlimited prices?

More than most, particularly for hyperspace and showcase leaders in the weeks after a set release. We keep daily closes for every printing and hourly snapshots on the Growth plan and above, which is usually what people building alert tooling for this game are after.

Fantasy Flight Games · since 2024

Star Wars: Unlimited API

Cost, power, HP, aspect penalties, ground and space arenas, and double-sided leader and base cards.

Get an API key Query SW: Unlimited now

1,460
Cards: 4,920
Printings: 9
Sets: 6
Languages

Overview

What the SW: Unlimited dataset covers

Star Wars: Unlimited brought Fantasy Flight's design pedigree to the trading card space and has built a durable competitive scene. TCGGraph models the aspect system — Vigilance, Command, Aggression, Cunning, Heroism and Villainy — plus arena assignment, unit cost, power and HP, upgrade attachments, uniqueness rules and the two-sided Leader and Base cards that define every deck.

Sourced from SWU-DB, Fantasy Flight card lists and TCGplayer.

Formats

Premier
Twin Suns
Draft
Sealed

Price sources

TCGplayer
Cardmarket

REST

curl -G "https://api.tcggraph.com/v1/cards" \
  -d game=star-wars-unlimited \
  -d limit=5 \
  -H "Authorization: Bearer $TCGGRAPH_KEY"

GraphQL

{
  cards(
    game: STAR_WARS_UNLIMITED
    filter: { aspects: ["Villainy"], arena: SPACE }
  ) {
    nodes {
      name
      starWars { cost power hp traits unique }
    }
  }
}

Schema

SW: Unlimited-specific fields

Every card carries the shared core fields. These live under gameData in REST, and under the typed starWars field in GraphQL.

Field	Type	Description
aspects	[String]	Vigilance, Command, Aggression, Cunning, Heroism or Villainy.
arena	Enum	GROUND or SPACE.
cost	Int	Resource cost.
power	Int	Unit power.
hp	Int	Unit hit points.
cardType	Enum	LEADER, BASE, UNIT, EVENT or UPGRADE.
traits	[String]	Rebel, Imperial, Vehicle, Force, Trooper…
unique	Boolean	Whether the card is unique.
faces	[Object]	Front and deployed sides for Leaders.

Plus 21 core fields shared by every game — see the full reference.

Live data

SW: Unlimited cards in the public dataset

Real records returned by the API right now, sorted by market value, with both the American and the European quote.

Card	Set	Number	Rarity	TCGplayer	Cardmarket
Darth Vader — Dark Lord of the Sith	SOR	010	Special	$4.44	€3.35
Luke Skywalker — Faithful Friend	SOR	005	Special	$3.86	€3.84
Energy Conversion Lab — Eadu	SOR	022	Rare	$0.42	€0.36
Kylo Ren — Rash and Deadly	SHD	011	Rare	$0.13	€0.14
Padmé Amidala — Serving the Republic	TWI	008	Common	$0.07	€0.06
Director Krennic — Aspiring to Authority	SOR	001	Common	$0.04	€0.03

The European market for SW: Unlimited

Asmodee, the distributor, is French, and European supply has been comfortable since launch. Showcase and hyperspace variants still command a premium, but the base rarity curve is softer than in North America.

Traded on Cardmarket in German, French, Italian, Spanish beyond English. How European pricing works.

Sets

Notable SW: Unlimited sets

SOR
Spark of Rebellion
252 cards · 2024-03-08
SHD
Shadows of the Galaxy
262 cards · 2024-07-12
TWI
Twilight of the Republic
257 cards · 2024-11-08
LOF
Legends of the Force
262 cards · 2025-07-11

Modelling

Working with SW: Unlimited data

The decisions that catch people out when they first integrate SW: Unlimited. Each of these is a bug we have watched somebody ship.

Leaders and bases are not in your deck
A game starts with one leader and one base already in play, chosen outside the fifty-card deck. Deck validation has to treat them as separate slots with their own rules, and a builder that lists them alongside units will produce illegal decks.
Leaders are double-sided
A leader begins as its leader side and deploys to a unit side later in the game, with different stats and different abilities. Both sides live in faces[]. Reading only the top-level power will give you the wrong number for half the game.
Aspects have a cost, literally
Playing a card whose aspects your leader and base do not cover costs two extra resources per uncovered aspect. That penalty is a deckbuilding constraint rather than a printed value, so an aspect-aware curve calculation is not the same as a naive one.
Arena determines where a unit fights
Ground and Space are separate battlefields and a unit only ever exists in one of them. Any board evaluation or deck balance heuristic that ignores arena will happily recommend a deck that cannot defend half the table.

Recipes

Common SW: Unlimited queries

Three requests that cover most of what applications in this game actually ask for.

Leaders for a given aspect pair

Deckbuilding starts with the leader, which fixes two of your aspects.

include=faces returns both the leader side and the deployed unit side in one response.

GET /v1/cards
  ?game=star-wars-unlimited
  &cardType=Leader
  &aspects=Vigilance,Heroism
  &include=faces

Efficient ground units

Find units with a good power-to-cost ratio in a single arena.

Numeric min/max filters compose, so this is one query rather than a client-side scan.

GET /v1/cards
  ?game=star-wars-unlimited
  &cardType=Unit
  &arena=Ground
  &maxCost=4
  &minPower=4

Hyperspace and showcase variants

Collectors and singles sellers need the alternate treatments separated from the base print.

Variants are separate records sharing a card number, each with its own price series.

GET /v1/cards
  ?game=star-wars-unlimited
  &variant=hyperspace,showcase
  &include=prices
  &sort=prices.market:desc

Glossary

SW: Unlimited terms, and the fields that hold them

What players call a thing on the left, what you query on the right.

Term	Field	Notes
Aspects	starWars.aspects[]	Vigilance, Command, Aggression, Cunning, plus Heroism or Villainy. Drives the penalty rule.
Arena	starWars.arena	Ground or Space. Units exist in exactly one.
Cost	starWars.cost	Resources to play, before any aspect penalty is applied.
Power / HP	starWars.power	Combat stats for units and for deployed leaders.
Faces	starWars.faces[]	Leaders carry a leader side and a unit side. Bases are single-faced.
Traits	starWars.traits[]	Rebel, Imperial, Force, Vehicle and so on. Most synergies key on these.
Variant	variant	standard, hyperspace, showcase or prestige. Priced separately.

FAQ

SW: Unlimited API questions

Anything not covered here, email hello@tcggraph.com and a human who knows SW: Unlimited answers.

Also available

Add another game without another integration

Your SW: Unlimited key already works for every other game in the catalog. Change the STAR_WARS_UNLIMITED enum and the rest of your code stays as it is.

Get an API key See pricing