Skip to content
TTCGAPIs
Cardmarket API

Cardmarket API Documentation

European card-market catalog and price-guide data in EUR, including normal and foil trend prices. Use Cardmarket identifiers to look up the stored guide.

European card prices in EUR

Cardmarket price-guide amounts are in euros (EUR). This endpoint returns the stored Cardmarket guide without converting it to GBP or USD. TCGPlayer product prices are a separate source; do not compare their numeric values without accounting for currency and printing.

Normal and foil
Use low, avg and trend for non-foil; use low-foil, avg-foil and trend-foil for foil. These are guide statistics, not condition-specific seller quotes.
Identifiers
Request prices with Cardmarket idProduct. A single may also carry a TCGPlayer productId cross-reference; it can be missing and is not interchangeable with idProduct.
Freshness and missing data
processedAt records import processing time, not a guaranteed market-observation time. Refresh timing varies by source and record. Missing or null fields are unavailable, not zero-priced cards. An absent guide returns HTTP 404.
Access
Works with credits (free or bought): 1 credit per catalog request, 2 per price-guide request. On a monthly plan, price-guide and catalog requests each take 1 call; the games endpoint is public.

Illustrative response shape, checked against the endpoint implementation on 7 November 2026. IDs, amounts and timestamp below are examples, not a live market quote; additional fields may be returned. See the Cardmarket price-guide field documentation.

GET /api/v2/cardmarket/prices/{idProduct}
Header: x-api-key: YOUR_API_KEY

{
  "success": true,
  "data": {
    "idProduct": 123456,
    "trend": 12.34,
    "trend-foil": null,
    "processedAt": "2026-11-07T00:00:00.000Z"
  }
}

The example trend is EUR 12.34. No currency field is added by this endpoint. Read the full API reference or start from a card photo; a recognition productId needs a verified Cardmarket cross-reference before this lookup.

Chainable Workflow

How the Cardmarket API Works

Each endpoint returns the IDs needed for the next step.

1

List Games

/api/v2/cardmarket/games

Get Cardmarket-supported games and their idGame values.

2

Get Expansions

/api/v2/cardmarket/expansions/:idGame

Use the idGame to fetch expansions and their idExpansion values.

3

Get Singles

/api/v2/cardmarket/singles/:idExpansion

Use the idExpansion to fetch singles and their idProduct values.

4

Get Prices

/api/v2/cardmarket/prices/:idProduct

Use the idProduct to fetch the latest Cardmarket price guide.

5 Endpoints

Cardmarket API Endpoints

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

GET/api/v2/cardmarket/games
Public

List Cardmarket-supported games. Each row carries idGame for the next step.

GET/api/v2/cardmarket/expansions/:idGame
Calls: 1 on every plan

Paginated expansions for a Cardmarket game. Each row carries idExpansion.

GET/api/v2/cardmarket/singles/:idExpansion
Calls: 1 on every plan

Paginated singles in an expansion. Each row carries idProduct (Cardmarket) and productId (TCGPlayer cross-ref where available).

GET/api/v2/cardmarket/single/:idProduct
Calls: 1 on every plan

Single lookup by Cardmarket idProduct.

GET/api/v2/cardmarket/prices/:idProduct
Calls: 1 on every plan

Latest Cardmarket price guide: low, avg, trend, plus 1/7/30-day moving averages — both non-foil and foil variants.

Full Schemas

Every Field We Expose

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

Games

GET /api/v2/cardmarket/games
Public

Top of the Cardmarket catalog tree — one row per Cardmarket-supported game.

FieldTypeDescription
idGameintegerCardmarket game ID — use to fetch expansions.
namestringGame display name (e.g. "Pokemon", "Magic the Gathering").
abbreviationstringCardmarket short code.
apiExpansionsCountintegerNumber of expansions Cardmarket has indexed for this game.

Expansions

GET /api/v2/cardmarket/expansions/:idGame
Calls: 1 on every plan

All Cardmarket expansions for a game. Use the idExpansion to fetch singles.

FieldTypeDescription
idExpansionintegerCardmarket expansion ID.
idGameintegerParent game ID.
enNamestringEnglish expansion name.
abbreviationstringCardmarket short code for the set.
gameNamestringParent game name.
releaseDateISO dateRelease date of the expansion.
isReleasedbooleanWhether the expansion has been released yet.
apiSinglesCountintegerNumber of singles indexed in this expansion.

Singles

GET /api/v2/cardmarket/singles/:idExpansion
Calls: 1 on every plan

Every single (card) in a Cardmarket expansion. Each row carries a TCGPlayer cross-reference where available.

FieldTypeDescription
idProductintegerCardmarket product ID — primary key for prices and lookups.
idMetaproductintegerCardmarket metaproduct ID (groups variants of the same card).
idExpansionintegerParent expansion ID.
idGameintegerParent game ID.
enNamestringEnglish card name.
expansionNamestringParent expansion name.
expansionAbbreviationstringSet short code.
gameNamestringParent game name.
raritystringCardmarket rarity tier.
numberstringCollector number.
productIdintegerMatching TCGPlayer productId — null when no cross-reference is available.
imagestringHosted card image URL.

Single (lookup)

GET /api/v2/cardmarket/single/:idProduct
Calls: 1 on every plan

Lookup a single by Cardmarket idProduct. Returns the same fields as the singles list endpoint.

FieldTypeDescription
(see Singles)—Identical schema to the Singles list endpoint above, returning a single row instead of paginated array.

Price Guide (per product)

GET /api/v2/cardmarket/prices/:idProduct
Calls: 1 on every plan

Stored Cardmarket price guide in EUR. Both non-foil and foil pricing in the same row; no currency conversion is applied.

FieldTypeDescription
idProductintegerCardmarket product ID.
idCategoryintegerCardmarket category ID.
lowdecimalCardmarket low-price guide statistic for non-foil; not a live seller quote.
avgdecimalAverage price (non-foil).
trenddecimalTrend price — Cardmarket's smoothed market-value estimate (non-foil).
avg1decimal1-day moving average (non-foil).
avg7decimal7-day moving average (non-foil).
avg30decimal30-day moving average (non-foil).
low-foildecimalCardmarket low-price guide statistic for foil; not a live seller quote.
avg-foildecimalAverage price (foil).
trend-foildecimalTrend price (foil).
avg1-foildecimal1-day moving average (foil).
avg7-foildecimal7-day moving average (foil).
avg30-foildecimal30-day moving average (foil).
processedAtISO timestampWhen this guide was imported; not a market-observation timestamp.

Illustrative Example Response

Foil and non-foil prices in the same row.

GET /api/v2/cardmarket/prices/242847
{
  "success": true,
  "data": {
    "idProduct": 242847,
    "idCategory": 23,
    "low": 3,
    "avg": null,
    "trend": 2.91,
    "avg1": null,
    "avg7": null,
    "avg30": null,
    "low-foil": null,
    "avg-foil": null,
    "trend-foil": 5.44,
    "avg1-foil": null,
    "avg7-foil": null,
    "avg30-foil": null,
    "processedAt": "2026-05-06T04:00:01.677Z"
  }
}

Frequently Asked Questions

What currency are Cardmarket prices returned in?

Cardmarket price-guide amounts are in EUR. The endpoint returns stored guide fields without GBP or USD conversion. Use the foil-specific fields for foil prices. processedAt records import processing time, not a guaranteed market-observation timestamp. Missing or null prices are unavailable, and a missing guide returns HTTP 404.

What is the Cardmarket API?

The Cardmarket API gives programmatic access to Cardmarket-sourced catalog data (games, expansions, singles) and price guide data (low/avg/trend plus 1/7/30-day moving averages, including foil variants). It mirrors the chain pattern of our TCGPlayer API: idGame → idExpansion → idProduct.

How does the Cardmarket API differ from the TCGPlayer API?

Cardmarket is the dominant European marketplace; TCGPlayer is the dominant US marketplace. The Cardmarket API uses Cardmarket's own keyspace (idGame, idExpansion, idProduct) and price guide format. Cardmarket singles also expose the matching TCGPlayer productId where available, so you can bridge between the two marketplaces.

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 price-guide 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: catalog and price-guide requests each take 1 call.

How are foil prices represented?

Each priceguide record contains both regular and foil pricing in the same row: low, avg, trend, avg1/7/30 for non-foil, plus low-foil, avg-foil, trend-foil, avg1-foil, avg7-foil, avg30-foil for foils.

Can I use V1 endpoints too?

Yes — the same endpoint shape is also available under /api/v1/cardmarket/* for callers already on V1.