Card PricesDocs
API Endpoints

Prices

Fetch price history (Growth plan or higher) and market trends (Professional plan or higher).

Price History

GET /public/v1/prices/history/:game/:cardId

Requires: Growth plan or higher

Returns a card's TCGplayer market price history, one value per print variant (e.g. 1st Edition, Unlimited, Holofoil). History is recorded once a day; period picks the window and resolution.

periodWindowOne point per
dailyLast 30 daysDay
weekly (default)Last 90 daysWeek (its latest day)
monthlyLast 12 monthsMonth (its latest day)

Path Parameters

ParameterDescription
gameAny of the 24 supported game keys — see Supported Games.
cardIdCard _id or numeric productId

Query Parameters

ParameterTypeDescription
periodstringdaily, weekly, or monthly (default: weekly)

Example

curl "https://api.cardprices.io/public/v1/prices/history/yugioh/21715?period=daily" \
  -H "X-API-Key: pub_live_YOUR_KEY"

Response

prices is oldest-first. Each point's inner prices object maps a print variant to its market price in USD on that date. A variant with no market price that day is omitted.

{
  "game": "yugioh",
  "cardId": "21715",
  "productId": 21715,
  "period": "daily",
  "currency": "USD",
  "prices": [
    { "date": "2026-10-22", "prices": { "1st Edition": 0.31, "Unlimited": 0.23 } },
    { "date": "2026-10-23", "prices": { "1st Edition": 0.31, "Unlimited": 0.25 } }
  ]
}

An unknown card returns 404 with { "error": "NOT_FOUND", "message": "Card not found." }. A card with no recorded history in the window returns 200 with an empty prices array.


GET /public/v1/prices/trends

Requires: Professional plan or higher

Returns the cards with the largest price movement for a given game, period, and direction.

Query Parameters

ParameterTypeDescription
gamestringRequired. Filter by game
periodstringdaily, weekly, or monthly (default: weekly)
directionstringrising or falling (default: rising)
pagenumberPage number (default: 1)
limitnumberNumber of results (default: 25, max: 100)

Example

curl "https://api.cardprices.io/public/v1/prices/trends?game=pokemon&period=weekly&direction=rising" \
  -H "X-API-Key: pub_live_YOUR_KEY"

Response

Each item is a trend record with its cardId populated to a lightweight card summary. percentageChange is the percent move over the period and latestPriceDouble is the most recent market price.

{
  "game": "pokemon",
  "period": "weekly",
  "direction": "rising",
  "total": 214,
  "page": 1,
  "limit": 25,
  "totalPages": 9,
  "trends": [
    {
      "_id": "60f1a0b2c3d4e5f6a7b8c9d0",
      "game": "pokemon",
      "cardId": {
        "name": "Charizard",
        "rarity": "Holo Rare",
        "number": "4/102",
        "productId": 100001,
        "image": "https://assets.pokemon.cardprices.io/100001.jpg"
      },
      "period": "weekly",
      "percentageChange": 20.0,
      "latestPriceDouble": 450.00,
      "trend": "rising",
      "updatedAt": "2026-06-08T00:00:00.000Z"
    }
  ]
}

Price Trends requires the Professional plan. See Plans at a Glance for current pricing.