Skip to content

Cards API — Card Data, Sealed Products & Prices

Card endpoints return card metadata, pricing data per printing type, and sealed product information.

GET /v1/cards/:id

Authentication: API key required

Example:

Terminal window
curl "https://api.tcgapi.dev/v1/cards/12345" \
-H "X-API-Key: YOUR_KEY"

Response:

{
"data": {
"id": 12345,
"name": "Charizard ex",
"clean_name": "charizard ex",
"number": "006",
"rarity": "Double Rare",
"image_url": "https://tcgplayer-cdn.tcgplayer.com/product/...",
"tcgplayer_id": 534280,
"tcgplayer_url": "https://www.tcgplayer.com/product/534280",
"product_type": "Cards",
"foil_only": 0,
"total_listings": 847,
"shipping_category_id": 1,
"product_status_id": 1,
"hp": "330",
"custom_attributes": {
"stage": "Stage 2",
"energyType": ["Fire"],
"weakness": "Wx2",
"retreatCost": "3",
"attack1": "[1RR] Brave Wing (100)",
"attack2": "[1RRR] Burning Dark (180)"
},
"set_id": 1234,
"set_name": "Obsidian Flames",
"game_id": 55,
"game_name": "Pokemon"
}
}

If you have a TCGPlayer product ID, look up the card directly:

GET /v1/cards/tcgplayer/:tcgplayerId

Authentication: API key required

Example:

Terminal window
curl "https://api.tcgapi.dev/v1/cards/tcgplayer/534280" \
-H "X-API-Key: YOUR_KEY"

Returns the card with all price data per printing type:

{
"data": {
"id": 12345,
"name": "Charizard ex",
"foil_only": 0,
"prices": [
{
"printing": "Normal",
"market_price": 24.99,
"market_price_as_of": "2026-02-19",
"low_price": 19.50,
"median_price": 26.50,
"lowest_with_shipping": 20.99,
"buylist_price": 18.00,
"price_change_24h": 2.15,
"last_updated_at": "2026-02-19T07:00:00.000Z"
},
{
"printing": "Foil",
"market_price": 42.50,
"market_price_as_of": "2026-02-19",
"low_price": 35.00,
"median_price": 45.00,
"lowest_with_shipping": 37.99,
"buylist_price": null,
"price_change_24h": 5.30,
"last_updated_at": "2026-02-19T07:00:00.000Z"
}
]
}
}
GET /v1/cards/:id/prices

Authentication: API key required

Query Parameters:

ParameterTypeDescription
printingstringFilter by Normal or Foil (optional)
includestringebay adds eBay sold prices to each printing; ebay_sales also returns the sold listings behind them. Pro and Business (and x402); costs 2 requests.

Returns price data for all available printing types:

{
"data": [
{
"card_id": 12345,
"printing": "Normal",
"market_price": 24.99,
"market_price_as_of": "2026-02-19",
"low_price": 19.50,
"median_price": 26.50,
"lowest_with_shipping": 20.99,
"buylist_price": 18.00,
"price_change_24h": 2.15,
"price_change_7d": -5.30,
"price_change_30d": 12.00,
"last_updated_at": "2026-02-19T07:00:00.000Z"
}
]
}

market_price_as_of is the UTC date TCGPlayer last reported market_price. It is older than last_updated_at when the printing has had no market price recently (for example a rare printing that has not sold in months): the last reported price is kept and dated rather than dropped. See Price Data Fields.

If a card has only one printing type, a single object is returned instead of an array.

eBay sold prices (include=ebay, Pro and Business): each printing gets an ebay object built from completed eBay sales. The top-level figures are ungraded copies of every condition, the number to compare with market_price; graded has the same figures for every grade that has sold, keyed by label. median_30d is the median of the 30 days before as_of (days says how many of those 30 days the stored sales cover: below 30 when a card’s eBay sales only recently started being tracked, graded_days the same for grades) (the date the sales were last read: daily for busy and valuable cards, up to monthly for quiet ones), sales_30d says how many sales it rests on, and last_price/last_sold give the latest sale when the window is empty. Lots, proxies, other languages and other printings are left out. "ebay": null means there is no eBay data for that printing. The request costs 2 requests whether or not the card has eBay data; below Pro it returns 403 TIER_REQUIRED and is not charged.

{
"printing": "Foil",
"market_price": 401.25,
"ebay": {
"median_30d": 355.00,
"sales_30d": 5,
"last_price": 413.64,
"last_sold": "2026-10-14",
"graded": {
"PSA 10": { "median_30d": 770.00, "sales_30d": 9, "last_price": 670.00, "last_sold": "2026-10-16" },
"BGS 10": { "median_30d": null, "sales_30d": 0, "last_price": 1300.00, "last_sold": "2026-09-16" }
},
"as_of": "2026-10-19"
}
}

Which games and sets have eBay data: GET /v1/ebay/coverage (public, free). Overview, coverage and FAQ: eBay sold prices API. On /history?include=ebay, a day after the card’s latest eBay read carries that read’s figures, with its date in ebay.as_of.

With include=ebay_sales, ebay.sales lists the sales in the same 30-day window, newest first: sold_date, price (the accepted offer on a Best Offer sale), best_offer, list_price, grade (null = ungraded), condition (ungraded sales whose title states one), title and url.

GET /v1/cards/:id/prices/conditions

Authentication: API key required (Pro tier or higher)

Card condition pricing broken out by grade — Near Mint, Lightly Played, Moderately Played, Heavily Played, and Damaged — per printing, computed from live TCGPlayer listings. Available for every card across all 50+ supported games.

Query Parameters:

ParameterTypeDescription
printingstringFilter to one printing, e.g. Normal or Holofoil (optional)

Example:

Terminal window
curl "https://api.tcgapi.dev/v1/cards/12345/prices/conditions" \
-H "X-API-Key: YOUR_KEY"

Response:

{
"data": [
{
"card_id": 12345,
"printing": "Holofoil",
"condition": "Near Mint",
"language": "English",
"low_price": 1.38,
"lowest_with_shipping": 2.87,
"median_with_shipping": 3.10,
"sample_count": 41,
"last_updated_at": "2026-07-24T13:32:17.078Z"
},
{
"card_id": 12345,
"printing": "Holofoil",
"condition": "Lightly Played",
"language": "English",
"low_price": 0.99,
"lowest_with_shipping": 2.48,
"median_with_shipping": 3.13,
"sample_count": 9,
"last_updated_at": "2026-07-24T13:32:17.078Z"
}
],
"meta": {
"cached": true,
"as_of": "2026-07-24T13:32:17.078Z"
}
}

Field notes:

  • low_price — lowest listed item price for that printing + condition.
  • lowest_with_shipping — lowest listed price including shipping.
  • median_with_shipping — median of the sampled shipping-inclusive prices; null when fewer than 3 listings were sampled. Prefer this over low_price when pricing inventory — it is robust against $0.01 junk listings.
  • sample_count — listings sampled for that row, not total market depth.

Freshness: the catalog is refreshed continuously on a rolling, oldest-first basis — every card is re-crawled every few days, popular games first. On top of that, if a card’s rows are older than 24 hours, your request triggers a live refresh from TCGPlayer, so cards your users actually view stay at most ~24 hours old. Live refreshes are bounded by a daily per-account quota (Pro: 200, Business: 1,000 live refreshes/day — cached reads are unlimited). Over quota, the newest cached rows are served with meta.stale: true; a card with no cached rows returns 429 LIVE_FETCH_LIMIT. Live-refreshed responses also include meta.condition_counts — total live listings per condition across all printings.

GET /v1/cards/:id/history

Authentication: API key required (every tier; the window depends on your plan: Free 7 days, Hobby 30 days, Starter 90 days, Pro and Business full history)

Data coverage: History is available for all cards with a market price of $1 or more across all supported games. Data starts from March 2025 with weekly data points, and coverage grows over time as new data is added daily.

Sales fields lag prices: rows are sorted oldest first. market_price and low_price are recorded every day. avg_sales_price and sales_volume come from a separate per-card sales pull — daily for the top 9 games, every 3 days for the rest — so the newest 1–3 days can have null sales until that pull fills them in. null means not recorded yet; 0 means the card had no sales that day.

Query Parameters:

ParameterTypeDescription
rangestringmonth, quarter, year, or all (default: month). all returns the complete history available for your tier.
printingstringFilter by Normal or Foil (optional)
includestringebay adds each day’s 30-day eBay sold median: { "median_30d", "sales_30d", "graded": { "PSA 10": { "median_30d", "sales_30d" } } }, with only the grades that sold in that window. each point also has days (how many of its 30 window days are covered; below 30 in the first month after coverage starts, so chart those days as partial) and graded_days. ebay is null before the printing’s ungraded eBay sales are complete, and graded is null on days before its graded sales are (ungraded history usually reaches further back: a median of about 650 days before we first read a card). Pro and Business; costs 2 requests.

Example:

Terminal window
curl "https://api.tcgapi.dev/v1/cards/12345/history?range=month&printing=Normal" \
-H "X-API-Key: YOUR_PRO_KEY"

Response:

{
"data": [
{
"date": "2026-02-18",
"printing": "Normal",
"market_price": 24.47,
"low_price": 19.25,
"avg_sales_price": 22.80,
"sales_volume": 8
},
{
"date": "2026-02-19",
"printing": "Normal",
"market_price": 24.99,
"low_price": 19.50,
"avg_sales_price": 23.50,
"sales_volume": 12
}
]
}
GET /v1/cards/:id/history/detailed

Authentication: API key required (Pro tier or higher)

Returns full history without date range limit. Includes all printing types, average sales prices, and daily sales volume.

Query Parameters:

ParameterTypeDescription
printingstringFilter by Normal or Foil (optional)
FieldTypeDescription
product_typestringCards or Sealed Products
foil_onlyinteger1 if card only exists as foil/holo
total_listingsintegerNumber of active seller listings
shipping_category_idinteger1=card, 3=box, 4=case
product_status_idinteger1=active, 20=presale
custom_attributesobjectGame-specific data (see below)

Pokemon: stage, energyType, hp, weakness, resistance, retreatCost, attack1-attack4, cardType, flavorText

Magic: The Gathering: color, manaCost, power, toughness, cardType, subType, flavorText, oracleText

Yu-Gi-Oh!: cardType, attribute, level, attack, defense, description

GET /v1/cards/:id/supply

Authentication: API key required (Pro tier or higher)

How much of a card or sealed product is for sale on TCGPlayer, from how many sellers, and how much of it is priced near the market price. Use it to judge liquidity: a box with 200 sellers is a different market from one where a single seller holds most of the stock, and a market price means little when nobody is selling near it.

  • listings, units, sellers: active listings, copies for sale and distinct sellers, across all conditions and printings.
  • largest_listing: the listing with the most copies and its share of all units.
  • printings[].ladder: listings, copies and sellers priced at or under 90%, 100%, 110%, 125% and 150% of that printing’s market price. Photo listings are left out, because sellers list opened boxes and lots under sealed products. exact: false means only the cheapest 50 listings could be counted, so the step’s figures are lower bounds. This is common on singles with several printings and hundreds of listings, and rare on sealed products.
  • near_market: the 110% step across printings. listings: 0 means nobody is selling near the market price.
  • sales_30d, sales_per_day, days_of_supply, near_market_days_of_supply: copies sold over the last 30 days, and how long the listed stock (or the stock near market) lasts at that rate.

Counts are for English listings (Japanese listings for Pokemon Japan) priced for US shipping, read about every 3 days per product. Seller names and individual listings are not returned.

Example:

Terminal window
curl "https://api.tcgapi.dev/v1/cards/13118/supply" \
-H "X-API-Key: YOUR_PRO_KEY"

Response:

{
"data": {
"card_id": 13118,
"name": "Prismatic Evolutions Booster Bundle",
"tcgplayer_id": 600518,
"listings": 205,
"units": 5740,
"sellers": 203,
"largest_listing": { "quantity": 4868, "share": 0.848 },
"single_unit_listings": 114,
"complete": false,
"near_market": { "listings": 72, "units": 202, "sellers": 72, "exact": true },
"sales_30d": 792,
"sales_per_day": 26.4,
"days_of_supply": 217.4,
"near_market_days_of_supply": 7.7,
"by_condition": { "Unopened": 205 },
"by_printing": { "Normal": 205 },
"printings": [
{
"printing": "Normal",
"market_price": 82.39,
"ladder": [
{ "max_pct": 0.9, "max_price": 74.15, "listings": 4, "units": 6, "sellers": 4, "exact": true },
{ "max_pct": 1.0, "max_price": 82.39, "listings": 18, "units": 25, "sellers": 18, "exact": true },
{ "max_pct": 1.1, "max_price": 90.63, "listings": 72, "units": 202, "sellers": 72, "exact": true },
{ "max_pct": 1.25, "max_price": 102.99, "listings": 127, "units": 453, "sellers": 127, "exact": true },
{ "max_pct": 1.5, "max_price": 123.59, "listings": 155, "units": 5557, "sellers": 155, "exact": true }
]
}
],
"last_updated_at": "2026-10-27T15:02:11.000Z"
},
"meta": { "as_of": "2026-10-27T15:02:11.000Z" }
}

Here the 5,740 copies look like deep supply, but one listing holds 4,868 of them at well above market. Only 202 copies are priced within 10% of the market price: about a week of sales.

GET /v1/cards/:id/supply/history?days=90

Authentication: API key required (Pro tier or higher)

One point per day the product’s listings were read (about every 3 days): listings, units, sellers and the near-market step (near_market_listings, near_market_units, near_market_sellers, near_market_exact). Falling units at a steady sales rate is tightening supply. History starts on 2026-10-27.

ParameterTypeDescription
daysintegerHow far back, 1 to 3650 (default 90)