Skip to content

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).

GET /v1/prices/top-movers

Authentication: API key required

Returns cards with the biggest price changes.

Query Parameters:

ParameterTypeDescription
gamestringFilter by game slug
directionstringup or down (default: up)
periodstring24h, 7d, or 30d (default: 24h)
printingstringFilter by Normal or Foil (optional)
typestringFilter by Cards or Sealed Products (optional)
limitintegerNumber of results (default: 20, max: 50)

Example:

Terminal window
# Top gainers in Pokemon today
curl "https://api.tcgapi.dev/v1/prices/top-movers?game=pokemon&direction=up" \
-H "X-API-Key: YOUR_KEY"
# Biggest drops in Foil cards this week
curl "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://..."
}
]
}

Each card can have multiple printing variants with separate pricing. The variant names vary by game:

Pokemon:

VariantDescription
NormalStandard non-foil
HolofoilHolographic foil
Reverse HolofoilReverse holographic pattern
1st EditionFirst edition printing
UnlimitedUnlimited run printing

Yu-Gi-Oh!:

VariantDescription
1st EditionFirst edition printing
UnlimitedUnlimited run printing
LimitedLimited edition printing

Magic: The Gathering:

VariantDescription
NormalStandard non-foil
FoilFoil printing

Flesh and Blood:

VariantDescription
NormalStandard non-foil
Rainbow FoilRainbow foil finish
Cold FoilCold foil finish
1st Edition NormalFirst edition, non-foil
1st Edition Rainbow FoilFirst edition, rainbow foil
1st Edition Cold FoilFirst edition, cold foil
Unlimited Edition NormalUnlimited, non-foil
Unlimited Edition Rainbow FoilUnlimited, rainbow foil

Lorcana:

VariantDescription
NormalStandard non-foil
HolofoilHolographic foil
Reverse HolofoilReverse holographic

Use ?printing= on any price endpoint to filter by variant name (exact match).

Every price object includes:

FieldTypeDescription
printingstringVariant name — Normal or Foil, or a named printing such as Holofoil, Reverse Holofoil, 1st Edition or Unlimited
market_pricenumberTCGPlayer market price (median of recent sales)
market_price_as_ofstring | nullUTC 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_pricenumber | nullLowest verified listing price for this printing
median_pricenumberMedian listing price across all sellers
lowest_with_shippingnumber | nullLowest price including shipping for this printing
buylist_pricenumberBuylist market price (what stores pay)
price_change_24hnumberPercentage change vs. yesterday
price_change_7dnumberPercentage change vs. 7 days ago
price_change_30dnumberPercentage change vs. 30 days ago
last_updated_atstringISO timestamp of last price update
no_market_price_sincestring | nullISO timestamp (UTC) since which TCGPlayer has priced nothing for this product. null while the printing is priced
ebayobject | nullOnly 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.

Terminal window
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.

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 empty data array 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; limit up 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 (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) or 4 (case)
  • Listings show condition: "Unopened" instead of Near Mint, etc.
GamesPricesSales 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)DailyDaily
All other games, priority: 2DailyEvery 3 days

Each game’s tier is the priority field on GET /v1/games.