Get a product's price history

​

Returns the product's daily price snapshots from Cardmarket (EUR) and TCGplayer (USD), one entry per day, marketplace, and finish, ordered by date ascending.

Each entry carries the day's low/mid/high/marketValue tiers. Days without a snapshot are absent from the result.

Narrow the result with marketplace and finish. from and to bound the range (both inclusive): to defaults to today, from to 30 days before to, and a single request can span at most 365 days.

For the current price including live CardNexus listings, see GET /v1/products/{productId}/prices.

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

Authentication is required (any valid API key); no scope.

Path Parameters
  • productId
    required

    The product to get price history for. Returned by GET /v1/products and POST /v1/products/search.

    • Type: number

      The product to get price history for. Returned by GET /v1/products and POST /v1/products/search.

Query Parameters
  • marketplace
    Type: string enum

    Return only this marketplace's prices: cardmarket (EUR) or tcgplayer (USD). Omit for both.

    values
    • cardmarket

      Cardmarket.

    • tcgplayer

      TCGplayer.

  • finish
    Type: string enum

    Return only this finish's prices, e.g. Standard or Foil. Omit for all finishes.

    values
    • Standard

      A standard, non-foil card.

    • Foil

      A foil card.

    • Rainbow
    • Gold
    • Rainbow Foil
  • from
    Type: string Format: date

    First day of the range, YYYY-MM-DD, inclusive. Defaults to 30 days before to.

  • to
    Type: string Format: date

    Last day of the range, YYYY-MM-DD, inclusive. Defaults to today.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/products/{productId}/prices/history
curl https://public-api.cardnexus.com/v1/products/50212/prices/history \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "productId": 50212,
  "from": "2026-06-07",
  "to": "2026-06-10",
  "data": [
    {
      "date": "2026-06-07",
      "marketplace": "cardmarket",
      "finish": "Standard",
      "low": 38.2,
      "mid": 43.8,
      "high": 58,
      "marketValue": 42.9
    },
    {
      "date": "2026-06-07",
      "marketplace": "tcgplayer",
      "finish": "Standard",
      "low": 41.9,
      "mid": 47.5,
      "high": 63,
      "marketValue": 46.8
    },
    {
      "date": "2026-06-08",
      "marketplace": "cardmarket",
      "finish": "Standard",
      "low": 38.5,
      "mid": 44,
      "high": 58.9,
      "marketValue": 43.2
    },
    {
      "date": "2026-06-10",
      "marketplace": "cardmarket",
      "finish": "Standard",
      "low": 38.9,
      "mid": 44.5,
      "high": 59.99,
      "marketValue": 43.75
    }
  ]
}

Price history returned.