Cards API — Card Data, Sealed Products & Prices
Card endpoints return card metadata, pricing data per printing type, and sealed product information.
Get Card by ID
Section titled “Get Card by ID”GET /v1/cards/:idAuthentication: API key required
Example:
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" }}Get Card by TCGPlayer ID
Section titled “Get Card by TCGPlayer ID”If you have a TCGPlayer product ID, look up the card directly:
GET /v1/cards/tcgplayer/:tcgplayerIdAuthentication: API key required
Example:
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 Card Prices
Section titled “Get Card Prices”GET /v1/cards/:id/pricesAuthentication: API key required
Query Parameters:
| Parameter | Type | Description |
|---|---|---|
printing | string | Filter by Normal or Foil (optional) |
include | string | ebay 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 Per-Condition Prices
Section titled “Get Per-Condition Prices”GET /v1/cards/:id/prices/conditionsAuthentication: 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:
| Parameter | Type | Description |
|---|---|---|
printing | string | Filter to one printing, e.g. Normal or Holofoil (optional) |
Example:
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;nullwhen fewer than 3 listings were sampled. Prefer this overlow_pricewhen 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 Card Price History
Section titled “Get Card Price History”GET /v1/cards/:id/historyAuthentication: 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:
| Parameter | Type | Description |
|---|---|---|
range | string | month, quarter, year, or all (default: month). all returns the complete history available for your tier. |
printing | string | Filter by Normal or Foil (optional) |
include | string | ebay 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:
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 Detailed Price History
Section titled “Get Detailed Price History”GET /v1/cards/:id/history/detailedAuthentication: 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:
| Parameter | Type | Description |
|---|---|---|
printing | string | Filter by Normal or Foil (optional) |
Card Data Fields
Section titled “Card Data Fields”| Field | Type | Description |
|---|---|---|
product_type | string | Cards or Sealed Products |
foil_only | integer | 1 if card only exists as foil/holo |
total_listings | integer | Number of active seller listings |
shipping_category_id | integer | 1=card, 3=box, 4=case |
product_status_id | integer | 1=active, 20=presale |
custom_attributes | object | Game-specific data (see below) |
Custom Attributes by Game
Section titled “Custom Attributes by Game”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 Listing Supply
Section titled “Get Listing Supply”GET /v1/cards/:id/supplyAuthentication: 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 itsshareof 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: falsemeans 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: 0means 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:
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 Listing Supply History
Section titled “Get Listing Supply History”GET /v1/cards/:id/supply/history?days=90Authentication: 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.
| Parameter | Type | Description |
|---|---|---|
days | integer | How far back, 1 to 3650 (default 90) |