Skip to content
TTCGAPIs
Cardtrader API

Cardtrader API Documentation

Try with 100 free credits across all customer data endpoints. No payment card required. Credits pay for requests: 1 credit for a catalog lookup, 2 for a price or certificate lookup, 5 for live listings or prices by condition (SKU prices). After your free credits are used, buy a credit pack (from £10, no subscription) or choose a monthly plan. Every monthly plan can call every endpoint: a request takes 1 call from the monthly allowance, except live listings and SKU prices, which take 5 calls on Hobby and Business.

Listing prices from the European marketplace Cardtrader: min, max and average with quantity and listing count, broken down by language, condition and print type. Cross-references TCGPlayer, Cardmarket and Scryfall.

Chainable Workflow

How the Cardtrader API Works

Each endpoint returns the IDs needed for the next step.

1

List Games

/api/v2/cardtrader/games

Get Cardtrader-supported games and their id values.

2

Get Expansions

/api/v2/cardtrader/expansions/:game_id

Use the game_id to fetch expansions and their id values.

3

Get Blueprints

/api/v2/cardtrader/blueprints/:expansion_id

Use the expansion_id to fetch blueprints (singles) and their id values.

4

Get Prices

/api/v2/cardtrader/prices/:blueprint_id

Use the blueprint id to fetch the latest per-variant marketprices.

5 Endpoints

Cardtrader API Endpoints

Authenticated via x-api-key. Same shape under /api/v1/cardtrader/*.

GET/api/v2/cardtrader/games
Public

List Cardtrader-supported games. Each row carries id for the next step.

GET/api/v2/cardtrader/expansions/:game_id
Calls: 1 on every plan

Paginated expansions for a Cardtrader game. Each row carries id (expansion).

GET/api/v2/cardtrader/blueprints/:expansion_id
Calls: 1 on every plan

Paginated blueprints (singles) in an expansion. Each blueprint includes cross-refs: tcg_player_id, card_market_ids[], scryfall_id.

GET/api/v2/cardtrader/blueprint/:id
Calls: 1 on every plan

Single blueprint lookup by Cardtrader id.

GET/api/v2/cardtrader/prices/:blueprint_id
Calls: 1 on every plan

Latest Cardtrader price record for a blueprint: min, max, avg, quantity and listings_count for each language, condition and print type, in the currency named on the record.

Full Schemas

Every Field We Expose

Field-by-field reference for every Cardtrader-source endpoint.

Games

GET /api/v2/cardtrader/games
Public

Top of the Cardtrader catalog tree. One row per supported game.

FieldTypeDescription
idintegerCardtrader game ID — use to fetch expansions.
namestringInternal game slug.
display_namestringHuman-readable game name.

Expansions

GET /api/v2/cardtrader/expansions/:game_id
Calls: 1 on every plan

All Cardtrader expansions for a game.

FieldTypeDescription
idintegerCardtrader expansion ID.
game_idintegerParent game ID.
codestringSet code.
namestringExpansion name.
last_blueprint_countintegerNumber of blueprints currently indexed for this expansion.
last_synced_atISO timestampLast time we refreshed this expansion from Cardtrader.

Blueprints (singles)

GET /api/v2/cardtrader/blueprints/:expansion_id
Calls: 1 on every plan

Every Cardtrader blueprint (single) in an expansion. Each row carries cross-references to TCGPlayer, Cardmarket, and Scryfall.

FieldTypeDescription
idintegerCardtrader blueprint ID.
namestringCard name.
expansion_idintegerParent expansion ID.
expansion_namestringParent expansion name.
expansion_codestringParent expansion code.
game_idintegerParent game ID.
category_idintegerCardtrader category ID.
raritystringRarity, sourced from fixed_properties (game-specific keys collapsed).
collector_numberstringCollector number from fixed_properties.
tcg_player_idintegerMatching TCGPlayer productId — cross-reference for bridging marketplaces.
card_market_idsinteger[]Matching Cardmarket idProduct values (a Cardtrader blueprint may map to multiple Cardmarket products).
scryfall_idstringMatching Scryfall card ID where available.
image_urlstringHosted card image URL.

Blueprint (lookup)

GET /api/v2/cardtrader/blueprint/:id
Calls: 1 on every plan

Single blueprint lookup by Cardtrader id. Same schema as the Blueprints list endpoint, returning one record.

FieldTypeDescription
(see Blueprints)—Identical schema to the Blueprints list endpoint above.

Marketprices (per blueprint)

GET /api/v2/cardtrader/prices/:blueprint_id
Calls: 1 on every plan

Cardtrader listing prices for one blueprint. The variants object has one entry per language, condition and print type, with keys such as `en_near_mint_normal` (older records use keys such as `normal_NM`).

FieldTypeDescription
blueprint_idintegerParent blueprint ID.
blueprint_namestringCard name.
expansion_idintegerParent expansion ID.
game_idintegerParent game ID.
currencystringISO currency code of every price in the record. Usually USD.
fetched_atstringWhen the record was read from Cardtrader (ISO 8601).
variants.<key>.languagestringLanguage code such as en. Absent on older records.
variants.<key>.conditionstringCondition, such as Near Mint (NM on older records).
variants.<key>.print_typestringPrint type, such as normal or foil.
variants.<key>.mindecimalLowest listed price for this variant, in the record currency.
variants.<key>.maxdecimalHighest listed price for this variant. Outlier listings can make it very large.
variants.<key>.avgdecimalMean of the listing prices, one vote per listing. Outliers pull it up; null when the listings are not on the record.
variants.<key>.quantityintegerTotal copies available across all listings for this variant.
variants.<key>.listings_countintegerNumber of listings for this variant.
variants.<key>.min_price_centsintegerLowest listed price in cents. Present on most records, together with max_price_cents, total_quantity and listing_count.
variants.<key>.listingsarrayThe individual listings behind the totals, each with price_cents, price_currency, quantity and its condition and language. Present on most records.

Example Responses

Per-variant pricing in a flexible map; cross-marketplace IDs on every blueprint.

GET /api/v2/cardtrader/blueprint/6
{
  "success": true,
  "data": {
    "id": 6,
    "name": "Ghalta, Primal Hunger",
    "game_id": 1,
    "category_id": 1,
    "expansion_id": 1,
    "expansion_name": "Game Night",
    "expansion_code": "gnt",
    "fixed_properties": {
      "mtg_rarity": "Rare",
      "collector_number": "044"
    },
    "tcg_player_id": 180397,
    "card_market_ids": [366585],
    "scryfall_id": "b2a93747-720a-...",
    "image_url": "https://cardtrader.com/..."
  }
}
GET /api/v2/cardtrader/prices/261377
{
  "success": true,
  "data": {
    "blueprint_id": 261377,
    "blueprint_name": "Charizard ex",
    "currency": "USD",
    "expansion_id": 3403,
    "game_id": 5,
    "fetched_at": "2026-11-13T03:02:01.149Z",
    "listings_count": 90,
    "total_quantity": 106,
    "variant_count": 5,
    "variants": {
      "en_near_mint_normal": {
        "language": "en",
        "condition": "Near Mint",
        "print_type": "normal",
        "min": 348.64,
        "max": 12575.57,
        "avg": 1009.09,
        "quantity": 62,
        "listings_count": 52,
        "min_price_cents": 34864,
        "max_price_cents": 1257557,
        "total_quantity": 62,
        "listing_count": 52,
        "listings": [ /* 52 listings: price_cents, quantity, ... */ ]
      },
      "en_slightly_played_normal": { /* ... */ }
    }
  }
}

Frequently Asked Questions

What is the Cardtrader API?

The Cardtrader API gives programmatic access to Cardtrader-sourced catalog data (games, expansions, blueprints) and listing-price data: the lowest, highest and average listed price, quantity and listing count for each language, condition and print type. Chains by game_id → expansion_id → blueprint_id.

How are Cardtrader prices structured?

Each price record carries a variants map with one entry per language, condition and print type, with keys such as `en_near_mint_normal` (older records use keys such as `normal_NM`). Every entry contains min, max, avg, quantity and listings_count in the currency named on the record, usually USD. Most entries also carry the prices in cents and the individual listings. Different blueprints have different variants depending on what is listed.

Can I bridge Cardtrader to TCGPlayer or Cardmarket?

Yes. Each Cardtrader blueprint exposes the matching tcg_player_id, card_market_ids[] (Cardmarket can have multiple), and scryfall_id where available, so you can pivot freely between the three marketplaces and Scryfall metadata.

How many calls does each endpoint take?

The /games endpoint is public. Everything else works with credits (free or bought): 1 credit per catalog request and 2 per marketprices request. After your free credits are used, buy a credit pack (from £10, no subscription) or choose a monthly plan. Every monthly plan can call every endpoint: expansions, blueprints, single-blueprint lookups and marketprices requests each take 1 call.

Why are URL params snake_case?

They mirror the underlying field names exactly (game_id, expansion_id, blueprint_id) so you can copy IDs straight from one response into the next URL without renaming.