Price history

GET /v1/products/{productId}/prices/history returns a product's daily price snapshots from Cardmarket (EUR) and TCGplayer (USD) — one entry per day, marketplace, and finish, ordered by date ascending.

curl "https://public-api.cardnexus.com/v1/products/50212/prices/history?marketplace=cardmarket&finish=Standard&from=2026-06-07&to=2026-06-10" \
  -H "Authorization: Bearer cnk_live_4f2d8c91e5b34a7f9e6c2d1a8b5f7e3c"
{
  "productId": 50212,
  "from": "2026-06-07",
  "to": "2026-06-10",
  "data": [
    {
      "date": "2026-06-07",
      "marketplace": "cardmarket",
      "finish": "Standard",
      "low": 38.20,
      "mid": 43.80,
      "high": 58.00,
      "marketValue": 42.90
    },
    {
      "date": "2026-06-08",
      "marketplace": "cardmarket",
      "finish": "Standard",
      "low": 38.50,
      "mid": 44.00,
      "high": 58.90,
      "marketValue": 43.20
    },
    {
      "date": "2026-06-10",
      "marketplace": "cardmarket",
      "finish": "Standard",
      "low": 38.90,
      "mid": 44.50,
      "high": 59.99,
      "marketValue": 43.75
    }
  ]
}

Each entry carries the day's low/mid/high/marketValue tiers in the marketplace's currency — EUR for cardmarket, USD for tcgplayer. There are no trend percentages in history entries; compute trends from the series itself. Days without a snapshot are absent from the result.

Parameters

Parameter Description
marketplace cardmarket or tcgplayer. Omit for both.
finish A single finish, e.g. Standard or Foil. Omit for all finishes.
from First day of the range, YYYY-MM-DD, inclusive. Defaults to 30 days before to.
to Last day of the range, YYYY-MM-DD, inclusive. Defaults to today.

from must be on or before to, and a single request can span at most 365 days — a longer range returns 400 Bad Request. For more than a year of data, send one request per year-sized slice.

Rate limit

Requests count against the pricing-history limit: 120 requests per hour.

  • Current prices — today's prices including live CardNexus listings
  • Recent sales — individual CardNexus sales from the last 30 days