Price history

Daily closing prices for a Pokémon card or sealed product, up to a year back, per condition and printing.

Price History

GET/v1/cards/:id/prices/history1 credit per item returned

Daily price aggregates for a card over a time window. currency picks the source: USD from TCGPlayer, EUR from Cardmarket, the only two price-history sources. For individual eBay sales, use /v1/cards/:id/listings/ebay instead.

Each source groups by condition and printing variant, so one date returns several rows. avg, low, and high are that day's aggregates; GET /v1/cards/:id has the single current market_price.

No field here reports how many copies sold. Every row is a price aggregate, not a sales count. For how often a card trades on eBay, use /v1/cards/:id/sales/volume.

Parameters

idstringrequired

The unique card ID.

currencystring

Price source/currency. "usd" returns TCGPlayer history, "eur" returns Cardmarket history. Omit it to receive every currency your plan allows.

periodstring

Time period in days, from "1d" through "365d". Defaults to 30d.

conditionstring

Filter to one condition, matched exactly. TCGPlayer uses "Near Mint", "Lightly Played", "Moderately Played", "Heavily Played", "Damaged"; Cardmarket uses "Mint", "Near Mint", "Excellent", "Good", "Light Played", "Played", "Poor".

variantstring

Filter to one printing variant, matched exactly, e.g. "Holofoil" or "Reverse Holofoil".

limitnumber

Rows per page, not days (max 365). A row is one date/source/currency/condition/variant combination, so a card with five conditions returns five rows per day and the default of 30 covers about six days. Page through with pagination.total_pages, raise this value, or narrow the result with condition and variant. Defaults to 30.

pagenumber

Page number for pagination. Defaults to 1.

Try it

curl -H "X-API-Key: YOUR_API_KEY" \
https://api.pkmnprices.com/v1/cards/{id}/prices/history
Response
{
  "data": [
    {
      "date": "2026-08-10",
      "source": "tcgplayer",
      "currency": "USD",
      "condition": "Near Mint",
      "variant": "Holofoil",
      "avg": 42.5,
      "low": 40,
      "high": 45
    },
    {
      "date": "2026-08-10",
      "source": "cardmarket",
      "currency": "EUR",
      "condition": "Near Mint",
      "variant": "Holofoil",
      "avg": 37.25,
      "low": 35,
      "high": 39.5
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 30,
    "total": 177,
    "total_pages": 6
  }
}

Sales Volume

GET/v1/cards/:id/sales/volume1 credit per item returned

How many eBay sold comps we recorded for a card each day, split by currency, printing and graded or raw, with a median price. It counts eBay comps only, not total market volume: TCGplayer and Cardmarket sales are not recorded, so a day with no row means no eBay comp that day, not that nothing sold.

sales counts every comp. priced_sales and median leave out accepted Best Offers, because eBay shows the listed price for those, not what the buyer paid. variant is null when the listing title did not narrow the sale to one printing; keep that bucket apart from named printings. Pro and above.

Parameters

idstringrequired

The unique card ID.

periodstring

Time period in days, from "1d" through "365d". Defaults to 30d.

gradedboolean

true for graded slabs only, false for raw cards only. Omit it for both.

currencystring

Filter to one currency: "usd" or "eur".

variantstring

Filter to one printing variant, matched exactly, e.g. "Holofoil".

limitnumber

Rows per page, not days (max 365). A row is one date/currency/variant/graded combination, newest day first. Defaults to 30.

pagenumber

Page number for pagination. Defaults to 1.

Try it

curl -H "X-API-Key: YOUR_API_KEY" \
https://api.pkmnprices.com/v1/cards/{id}/sales/volume
Response
{
  "data": [
    {
      "date": "2026-10-20",
      "currency": "USD",
      "variant": "Holofoil",
      "graded": false,
      "sales": 7,
      "priced_sales": 6,
      "median": 41.5
    },
    {
      "date": "2026-10-20",
      "currency": "USD",
      "variant": "Holofoil",
      "graded": true,
      "sales": 1,
      "priced_sales": 1,
      "median": 102.5
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 30,
    "total": 14,
    "total_pages": 1
  }
}