PokeTrace 2.0 ya está aquíMira qué ha cambiado
PokeTrace 2.0 ya está aquíMira qué ha cambiado

EU market data

CardMarket Pokemon Card API

Use market=EU for cards with CardMarket prices in EUR. Since API 2.0, GET /cards and GET /cards/:id return a linked card's EU prices next to its US prices.
CurrencySourcesPlan
EUR
EU prices stay in EUR, also next to US prices on the same card.
2 CardMarket feeds
Price Trend and active listings are separate fields.
Pro+
EU market access requires Pro or higher.

Endpoint

GET /v2/cards?market=EU

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.poketrace.com/v2/cards?search=charizard&market=EU&limit=2"

Returns cards with EU prices. A linked card comes back once, under its US id, with CardMarket data in markets.EU and prices.<tier>.EU. EU-only cards are EU records in EUR.

  • Cardmarket data is available on Pro, Growth, Scale and Business, with the same listing coverage on each plan.
  • Coverage focuses on cards printed in English and Japanese.
  • Some products may show fewer listings than on Cardmarket. Available prices vary by product, seller country and language.
  • For ungraded singles, current Cardmarket prices cover Mint and Near Mint.
  • Language-specific prices are not available for every sealed product.
  • When saleCountBasis is observed_offers, saleCount counts listings represented in the price data—not completed sales or total stock. A listing disappearing does not necessarily mean it sold.
  • The /listings endpoint returns eBay sold listings. It does not provide individual Cardmarket listings or seller details.
  • First Edition and reverse-holo prices are shown separately where available.
  • cardmarket_unsold values are asking prices from active listings, not completed-sale comps.

Parameters

Search Parameters

market
enum
Set to EU to return cards with CardMarket prices. A card linked to a US card matches both US and EU and comes back under its US id.
EU
search
string
Search by card name before reading EU CardMarket fields.
charizard
limit
number
Cards per page. API schema accepts up to 100; docs examples use small pages.
20
cursor
string
Pagination cursor for /cards.
YnNfMg==
cardmarket_ids
csv
Comma-separated CardMarket IDs, max 20. cardmarketIds alias is also accepted. Linked cards come back under their US id; the EU id is in markets.EU.cardId.
273927,273550
game
enum
Use pokemon or pokemon-japanese when distinguishing EU card languages by product identity.
pokemon-japanese

Detail Parameters

GET /cards/:id
route
Fetch one card with an EU or a US ID. Linked cards return both markets: markets.EU and prices.<tier>.EU hold the CardMarket data.
/cards/eu_273927
GET /cards/:id/prices/:tier/history
route
Fetch EU history for AGGREGATED, raw condition, or graded tier. With a US ID, add market=EU to read the linked EU card's history.
/cards/019bff77-befa-771d-bab0-f5909f0a78c9/prices/NEAR_MINT/history?market=EU&period=30d

Response fields

CardMarket Price Trend

The cardmarket source is the stable EU baseline. Read it under prices.AGGREGATED.EU.cardmarket.

prices.AGGREGATED.EU.cardmarket.avg
number | null
CardMarket Price Trend style value for the card.
385
avg1d / avg7d / avg30d
number | null
Short-window trend averages where available.
380 / 375 / 370
low / high / saleCount
null or omitted
AGGREGATED Price Trend is not a per-listing spread.
low: null
refs.cardmarketId
string | number | null
CardMarket product reference for matching external systems.
273927

Active Listings

The cardmarket_unsold source is active asking-price inventory.

prices.NEAR_MINT.EU.cardmarket_unsold
object
Raw active listings for a condition tier.
avg, low, high, saleCount
prices.PSA_10.EU.cardmarket_unsold
object
Graded active listings where slab data is available.
PSA_10.EU.cardmarket_unsold.country.DE
country
object
Breakdown by seller country, such as DE, FR, IT, ES, PL, or BE.
country.DE.avg
country.*.language
object
Nested language slices under country. Common keys include ALL, EN, and JP.
country.DE.language.EN.avg
median3d / median7d / median30d
number | null
Rolling medians from active listings, with anomalies excluded.
410

Both Markets on One Card (2.0)

GET /cards/:id and every GET /cards item carry these fields. They hold both markets when the US and EU records are linked.

markets.EU
object
EU card ID, currency EUR, variant, finish and link type. Plans without EU access get { available: false, reason: "plan" } and no EU prices.
markets.EU.cardId
prices.<tier>.EU
object
CardMarket prices for that grade or condition, keyed by source: cardmarket and cardmarket_unsold.
prices.NEAR_MINT.EU.cardmarket_unsold
markets.US.cardId
string
The linked US card ID when you request the EU ID; markets.EU.cardId holds the EU ID.
019bff77-befa-771d-bab0-f5909f0a78c9

Examples

Read EU Near Mint by country and language
const response = await fetch(
  "https://api.poketrace.com/v2/cards?search=charizard&market=EU&limit=1",
  { headers: { "X-API-Key": process.env.POKETRACE_API_KEY } },
)

const card = (await response.json()).data[0]
// prices is grouped by grade, then market, then source
const nearMint = card.prices?.NEAR_MINT?.EU?.cardmarket_unsold
const germanEnglishAvg = nearMint?.country?.DE?.language?.EN?.avg
EU prices on a card
{
  "id": "eu_273927",
  "market": "EU",
  "currency": "EUR",
  "refs": { "tcgplayerId": null, "cardmarketId": "273927" },
  "prices": {
    "AGGREGATED": {
      "EU": { "cardmarket": { "avg": 385, "low": null, "high": null, "avg7d": 375 } }
    },
    "NEAR_MINT": {
      "EU": {
        "cardmarket_unsold": {
          "avg": 420,
          "low": 350,
          "high": 890,
          "saleCount": 125,
          "country": {
            "DE": { "avg": 410, "language": { "ALL": { "avg": 401 }, "EN": { "avg": 432 } } }
          }
        }
      }
    }
  }
}

Two Sources, Different Meaning

cardmarket.AGGREGATED provides Cardmarket Price Trend. cardmarket_unsold provides asking prices, with country, language and graded-price breakdowns where available.

Country and Language

Country refers to the seller’s location. Language refers to the language printed on the card or product.

For example, country.DE.language.EN.low gives the lowest price in our data for an English copy from a German seller. Use EN for English prices; ALL is not a substitute for EN.

Missing country or language data does not mean the item is unavailable on Cardmarket.

Do Not Mix Markets Blindly

Since API 2.0 a linked US and EU record is the same card, and one response carries both markets. Each market keeps its own currency (USD or EUR) and sources; nothing is converted.

Compare them only when your product explicitly explains currency, source, liquidity, and supply differences.

Frequently asked questions

Does PokeTrace expose CardMarket Pokemon prices?

Yes. Use market=EU on /cards, or fetch a card by its EU or US ID. Responses include cardmarket Price Trend values and cardmarket_unsold active listing summaries under prices.<tier>.EU. On /cards a linked card comes back once, under its US id.

Can I filter CardMarket prices by country or language?

The endpoint does not take a country query filter, but EU response data can include country and nested language objects that your app can read directly.