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.
How the Cardtrader API Works
Each endpoint returns the IDs needed for the next step.
List Games
/api/v2/cardtrader/gamesGet Cardtrader-supported games and their id values.
Get Expansions
/api/v2/cardtrader/expansions/:game_idUse the game_id to fetch expansions and their id values.
Get Blueprints
/api/v2/cardtrader/blueprints/:expansion_idUse the expansion_id to fetch blueprints (singles) and their id values.
Get Prices
/api/v2/cardtrader/prices/:blueprint_idUse the blueprint id to fetch the latest per-variant marketprices.
Cardtrader API Endpoints
Authenticated via x-api-key. Same shape under /api/v1/cardtrader/*.
/api/v2/cardtrader/gamesList Cardtrader-supported games. Each row carries id for the next step.
/api/v2/cardtrader/expansions/:game_idPaginated expansions for a Cardtrader game. Each row carries id (expansion).
/api/v2/cardtrader/blueprints/:expansion_idPaginated blueprints (singles) in an expansion. Each blueprint includes cross-refs: tcg_player_id, card_market_ids[], scryfall_id.
/api/v2/cardtrader/blueprint/:idSingle blueprint lookup by Cardtrader id.
/api/v2/cardtrader/prices/:blueprint_idLatest 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.
Every Field We Expose
Field-by-field reference for every Cardtrader-source endpoint.
Games
GET /api/v2/cardtrader/gamesTop of the Cardtrader catalog tree. One row per supported game.
| Field | Type | Description |
|---|---|---|
| id | integer | Cardtrader game ID — use to fetch expansions. |
| name | string | Internal game slug. |
| display_name | string | Human-readable game name. |
Expansions
GET /api/v2/cardtrader/expansions/:game_idAll Cardtrader expansions for a game.
| Field | Type | Description |
|---|---|---|
| id | integer | Cardtrader expansion ID. |
| game_id | integer | Parent game ID. |
| code | string | Set code. |
| name | string | Expansion name. |
| last_blueprint_count | integer | Number of blueprints currently indexed for this expansion. |
| last_synced_at | ISO timestamp | Last time we refreshed this expansion from Cardtrader. |
Blueprints (singles)
GET /api/v2/cardtrader/blueprints/:expansion_idEvery Cardtrader blueprint (single) in an expansion. Each row carries cross-references to TCGPlayer, Cardmarket, and Scryfall.
| Field | Type | Description |
|---|---|---|
| id | integer | Cardtrader blueprint ID. |
| name | string | Card name. |
| expansion_id | integer | Parent expansion ID. |
| expansion_name | string | Parent expansion name. |
| expansion_code | string | Parent expansion code. |
| game_id | integer | Parent game ID. |
| category_id | integer | Cardtrader category ID. |
| rarity | string | Rarity, sourced from fixed_properties (game-specific keys collapsed). |
| collector_number | string | Collector number from fixed_properties. |
| tcg_player_id | integer | Matching TCGPlayer productId — cross-reference for bridging marketplaces. |
| card_market_ids | integer[] | Matching Cardmarket idProduct values (a Cardtrader blueprint may map to multiple Cardmarket products). |
| scryfall_id | string | Matching Scryfall card ID where available. |
| image_url | string | Hosted card image URL. |
Blueprint (lookup)
GET /api/v2/cardtrader/blueprint/:idSingle blueprint lookup by Cardtrader id. Same schema as the Blueprints list endpoint, returning one record.
| Field | Type | Description |
|---|---|---|
| (see Blueprints) | — | Identical schema to the Blueprints list endpoint above. |
Marketprices (per blueprint)
GET /api/v2/cardtrader/prices/:blueprint_idCardtrader 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`).
| Field | Type | Description |
|---|---|---|
| blueprint_id | integer | Parent blueprint ID. |
| blueprint_name | string | Card name. |
| expansion_id | integer | Parent expansion ID. |
| game_id | integer | Parent game ID. |
| currency | string | ISO currency code of every price in the record. Usually USD. |
| fetched_at | string | When the record was read from Cardtrader (ISO 8601). |
| variants.<key>.language | string | Language code such as en. Absent on older records. |
| variants.<key>.condition | string | Condition, such as Near Mint (NM on older records). |
| variants.<key>.print_type | string | Print type, such as normal or foil. |
| variants.<key>.min | decimal | Lowest listed price for this variant, in the record currency. |
| variants.<key>.max | decimal | Highest listed price for this variant. Outlier listings can make it very large. |
| variants.<key>.avg | decimal | Mean of the listing prices, one vote per listing. Outliers pull it up; null when the listings are not on the record. |
| variants.<key>.quantity | integer | Total copies available across all listings for this variant. |
| variants.<key>.listings_count | integer | Number of listings for this variant. |
| variants.<key>.min_price_cents | integer | Lowest listed price in cents. Present on most records, together with max_price_cents, total_quantity and listing_count. |
| variants.<key>.listings | array | The 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.
{
"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/..."
}
}{
"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.