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.
period | Window | One point per |
|---|---|---|
daily | Last 30 days | Day |
weekly (default) | Last 90 days | Week (its latest day) |
monthly | Last 12 months | Month (its latest day) |
Path Parameters
| Parameter | Description |
|---|---|
game | Any of the 24 supported game keys — see Supported Games. |
cardId | Card _id or numeric productId |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
period | string | daily, 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.
Price Trends
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
| Parameter | Type | Description |
|---|---|---|
game | string | Required. Filter by game |
period | string | daily, weekly, or monthly (default: weekly) |
direction | string | rising or falling (default: rising) |
page | number | Page number (default: 1) |
limit | number | Number 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.