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

Retrieve daily price aggregates for a card over a specified time period. Use the currency parameter to choose the source: USD history comes from TCGPlayer, EUR history from Cardmarket. Those are the only two sources of price history; eBay sold comps are individual sales and are available on /v1/cards/:id/listings/ebay instead. Both sources are grouped by condition and printing variant, so one date yields several rows. The avg, low, and high fields are historical daily aggregates; current prices use the single market_price field on GET /v1/cards/:id.

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,
      "sale_count": 8
    },
    {
      "date": "2026-08-10",
      "source": "cardmarket",
      "currency": "EUR",
      "condition": "Near Mint",
      "variant": "Holofoil",
      "avg": 37.25,
      "low": 35,
      "high": 39.5,
      "sale_count": 3
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 30,
    "total": 177,
    "total_pages": 6
  }
}