Prices API — Daily TCG Card Market Data
Price endpoints for market movers, trends, and analytics. All prices are tracked per printing type (Normal and Foil/Holofoil).
Top Price Movers
Section titled “Top Price Movers”GET /v1/prices/top-moversAuthentication: API key required
Returns cards with the biggest price changes.
Query Parameters:
| Parameter | Type | Description |
|---|---|---|
game | string | Filter by game slug |
direction | string | up or down (default: up) |
period | string | 24h, 7d, or 30d (default: 24h) |
printing | string | Filter by Normal or Foil (optional) |
type | string | Filter by Cards or Sealed Products (optional) |
limit | integer | Number of results (default: 20, max: 50) |
Example:
# Top gainers in Pokemon todaycurl "https://api.tcgapi.dev/v1/prices/top-movers?game=pokemon&direction=up" \ -H "X-API-Key: YOUR_KEY"
# Biggest drops in Foil cards this weekcurl "https://api.tcgapi.dev/v1/prices/top-movers?direction=down&period=7d&printing=Foil" \ -H "X-API-Key: YOUR_KEY"Response:
{ "data": [ { "card_id": 12345, "name": "Charizard ex", "set_name": "Obsidian Flames", "game_name": "Pokemon", "product_type": "Cards", "foil_only": 0, "printing": "Normal", "market_price": 24.99, "market_price_as_of": "2026-02-19", "price_change": 15.5, "image_url": "https://..." } ]}Printing / Variant Types
Section titled “Printing / Variant Types”Each card can have multiple printing variants with separate pricing. The variant names vary by game:
Pokemon:
| Variant | Description |
|---|---|
Normal | Standard non-foil |
Holofoil | Holographic foil |
Reverse Holofoil | Reverse holographic pattern |
1st Edition | First edition printing |
Unlimited | Unlimited run printing |
Yu-Gi-Oh!:
| Variant | Description |
|---|---|
1st Edition | First edition printing |
Unlimited | Unlimited run printing |
Limited | Limited edition printing |
Magic: The Gathering:
| Variant | Description |
|---|---|
Normal | Standard non-foil |
Foil | Foil printing |
Flesh and Blood:
| Variant | Description |
|---|---|
Normal | Standard non-foil |
Rainbow Foil | Rainbow foil finish |
Cold Foil | Cold foil finish |
1st Edition Normal | First edition, non-foil |
1st Edition Rainbow Foil | First edition, rainbow foil |
1st Edition Cold Foil | First edition, cold foil |
Unlimited Edition Normal | Unlimited, non-foil |
Unlimited Edition Rainbow Foil | Unlimited, rainbow foil |
Lorcana:
| Variant | Description |
|---|---|
Normal | Standard non-foil |
Holofoil | Holographic foil |
Reverse Holofoil | Reverse holographic |
Use ?printing= on any price endpoint to filter by variant name (exact match).
Price Data Fields
Section titled “Price Data Fields”Every price object includes:
| Field | Type | Description |
|---|---|---|
printing | string | Variant name — Normal or Foil, or a named printing such as Holofoil, Reverse Holofoil, 1st Edition or Unlimited |
market_price | number | TCGPlayer market price (median of recent sales) |
market_price_as_of | string | null | UTC date (YYYY-MM-DD) TCGPlayer last reported this market price. Older than the other fields when the printing has had no market price recently — the last price is kept and dated here rather than dropped |
low_price | number | null | Lowest verified listing price for this printing |
median_price | number | Median listing price across all sellers |
lowest_with_shipping | number | null | Lowest price including shipping for this printing |
buylist_price | number | Buylist market price (what stores pay) |
price_change_24h | number | Percentage change vs. yesterday |
price_change_7d | number | Percentage change vs. 7 days ago |
price_change_30d | number | Percentage change vs. 30 days ago |
last_updated_at | string | ISO timestamp of last price update |
no_market_price_since | string | null | ISO timestamp (UTC) since which TCGPlayer has priced nothing for this product. null while the printing is priced |
ebay | object | null | Only with include=ebay or include=ebay_sales on GET /v1/cards/:id/prices (Pro and Business, 2 requests): eBay sold prices for the printing — see below. null when there is no eBay data for it |
Price change values are percentages (e.g., 15.5 means +15.5%).
A null value means insufficient data to compute the change.
last_updated_at says when we last checked the printing against TCGPlayer; market_price_as_of says when TCGPlayer last reported the market price itself. They differ when a printing has stopped selling: TCGPlayer then reports no market price, and we keep the last one it did report, dated by market_price_as_of. Compare it with today to decide whether a price is too old for your use. It is null when market_price is null or 0, or when TCGPlayer has reported no market price for the printing in the past year.
no_market_price_since is set when TCGPlayer stopped reporting any price for the product, typically an out-of-print item with no listings. The row then keeps the last prices TCGPlayer reported and is no longer refreshed daily, so last_updated_at stays at the last real update. For the daily-refresh games the product is rechecked weekly, and the field returns to null as soon as TCGPlayer prices it again.
For a walkthrough with a real response, see eBay sold prices API.
Which cards have eBay data: GET /v1/ebay/coverage lists every game with eBay sold prices: cards in the catalog (sealed products excluded), cards_with_ebay, coverage_pct, newest_as_of, and refresh, how many of its cards are re-read daily, every 3 days, weekly or monthly. Add ?game=pokemon (any slug from /v1/games) for that game’s sets with the same counts. It is public and free, needs no key, and is recomputed daily; check it before paying for include=ebay on cards it doesn’t cover.
curl "https://api.tcgapi.dev/v1/ebay/coverage?game=lorcana-tcg"{ "data": { "game": "Disney Lorcana", "slug": "lorcana-tcg", "cards": 3788, "cards_with_ebay": 3551, "coverage_pct": 93.7, "printings_with_ebay": 6199, "newest_as_of": "2026-10-21", "refresh": { "daily": 184, "3d": 350, "weekly": 1744, "monthly": 1273 }, "sets": [ { "set_id": 4500014, "set": "Wilds Unknown", "cards": 268, "cards_with_ebay": 257, "coverage_pct": 95.9 }, { "set_id": 4500018, "set": "Attack of the Vine!", "cards": 262, "cards_with_ebay": 251, "coverage_pct": 95.8 } ], "computed_at": "2026-10-21T16:18:51.737Z" }}Every value is per printing. On cards with several foil-type printings, low_price and lowest_with_shipping come from that printing’s own listings and are null when none are available, rather than a value blended across printings.
eBay sold prices (ebay, with include=ebay): what the printing actually sold for on eBay, next to the TCGPlayer figures above. The top level is ungraded copies of every condition — median_30d (median of the 30 days before as_of), sales_30d (how many sales that median rests on), and last_price / last_sold (the latest sale, in or out of the window). graded has the same four fields for every grade that has sold, keyed by label ("PSA 10", "CGC 10 Pristine", "BGS 9.5"). days / graded_days say how many of the 30 window days the stored sales cover (30 = complete; lower for a while when a busy card’s eBay sales start being tracked). as_of is the date the sales were last read: daily for busy or valuable cards (20+ sales a month or $100+), every 3 days, weekly or monthly for quieter ones, and daily for new sets in their first two weeks. Lots, proxies, other languages, other printings and sales whose title names another card number are left out; on a Best Offer sale the price is the accepted offer. include=ebay_sales also returns the listings behind the median, and /history?include=ebay gives each day’s 30-day figures. Covers about 218,000 cards across Pokemon, Pokemon Japan, Magic: The Gathering, Yu-Gi-Oh!, One Piece, Lorcana, Digimon, Dragon Ball, Star Wars: Unlimited, Gundam, Riftbound, Sorcery and more.
Cardmarket (EU) Prices
Section titled “Cardmarket (EU) Prices”European prices in EUR from Cardmarket’s daily price guide, next to the TCGPlayer figures:
GET /v1/cards/{id}/prices/cardmarket— one row per printing (?printing=filters). An emptydataarray when Cardmarket has no matching product for the card.GET /v1/sets/{id}/prices/cardmarket— every card in a set, highest trend first (Pro tier and up;limitup to 500,offset).GET /v1/cardmarket/coverage— cards, printings and priced printings per game, and the price-guide dates in use.
Each row has Cardmarket’s price_trend, avg_sell_price, low_price (lowest listing) and avg_1d / avg_7d / avg_30d for that printing, currency: "EUR", and last_updated_at, the date of the price guide. Cardmarket keeps two series per product, regular and foil (for Pokemon the foil series is reverse holo); cm_series says which one the printing reads, and cm_product_id, cm_name and cm_url name the Cardmarket product. Where Cardmarket sells a card’s editions as one product — Yu-Gi-Oh! 1st Edition and Unlimited — the card has a single row with printing: "All editions" and editions_blended: true: the price covers every edition, never one. Printings whose Cardmarket price would mix two of our printings in any other way are left out rather than shown with a blended price. Prices update once a day, shortly after Cardmarket publishes its guide (around 01:45 UTC). Covers about 318,000 cards across Magic: The Gathering, Pokemon, Yu-Gi-Oh!, One Piece, Lorcana, Flesh and Blood, Weiss Schwarz, Cardfight!! Vanguard, Digimon, Dragon Ball Super and more.
Sealed Products
Section titled “Sealed Products”Sealed products (booster boxes, tins, ETBs, cases) have their own pricing tracked separately. Filter with ?type=Sealed Products on search and set endpoints.
Sealed products are identified by:
product_type: "Sealed Products"shipping_category_id:3(box) or4(case)- Listings show
condition: "Unopened"instead of Near Mint, etc.
Update Frequency
Section titled “Update Frequency”| Games | Prices | Sales data (avg_sales_price, sales_volume) |
|---|---|---|
Major games, priority: 3 (Pokemon, Pokemon Japan, Magic, Yu-Gi-Oh, Lorcana, Flesh and Blood, One Piece, Riftbound, Weiss Schwarz) | Daily | Daily |
All other games, priority: 2 | Daily | Every 3 days |
Each game’s tier is the priority field on GET /v1/games.