Skip to content

Changelog

What is new in TCG API. Subscribe via RSS or watch the GitHub repo.

feature

Listing supply: how much is for sale, from how many sellers, near what price

New GET /v1/cards/{id}/supply returns, for any card or sealed product: active TCGPlayer listings, copies for sale, distinct sellers, the largest listing's share of the stock, a ladder of listings, copies and sellers priced at or under 90%, 100%, 110%, 125% and 150% of the market price, and days of supply at the last 30 days' sales rate. A market price with nobody selling near it shows as near_market.listings 0. GET /v1/cards/{id}/supply/history tracks the same figures over time (from today), and GET /v1/bulk/supply covers up to 500 products per request. English listings, refreshed about every 3 days per product; counts only, no seller identities. Pro and Business (also x402: $0.020, bulk $0.050). See /api/cards/.

feature

eBay sold prices in bulk and in Identify

GET /v1/bulk/prices?include=ebay adds each row's eBay summary (30-day median, sales count, last sale, per grade) for up to 500 cards, at 1 credit plus 1 per card that has eBay data. POST /v1/identify?include=ebay returns the top match's prices with eBay sold prices on every plan, included in the scan; on a graded slab, ebay.slab_grade gives the eBay figures for the grade read off the label (for example PSA 10).

feature

eBay sold prices next to TCGPlayer prices

Add include=ebay to GET /v1/cards/{id}/prices to get what each printing actually sold for on eBay: the ungraded 30-day median, sales count and last sale, plus the same figures for every grade that has sold (PSA, BGS, CGC, SGC and more). include=ebay_sales also returns the sold listings behind the median, and GET /v1/cards/{id}/history?include=ebay gives each day's 30-day median. Lots, proxies, other languages and other printings are left out. Covers about 218,000 cards across Pokemon, Magic, Yu-Gi-Oh!, One Piece, Lorcana, Digimon, Dragon Ball, Star Wars: Unlimited and more, refreshed daily for busy and valuable cards. Pro and Business; costs 2 requests ($0.010 with x402). See /api/cards/.

feature

Identify cards from a photo

New POST /v1/identify reads one photo of a card, graded slab or sealed product (name, collector number or code, set, edition stamp, foil) and returns ranked catalog matches with TCGPlayer IDs, for every game in the catalog. Add include=prices for the top match's current prices. Billed in prepaid scans, separate from the daily request limit: 25 free scans per account, then packs from 1.5¢ to 0.8¢ per scan, or $0.02 per photo with x402. GET /v1/identify/usage and the dashboard show the balance and 30 days of scans. See /api/identify/.

fix

Correct prices for cards with several printings

On cards sold in more than one foil-type printing (1st Edition and Unlimited, Holofoil and Reverse Holofoil, Rainbow and Cold Foil), one printing could show another printing's market price and a matching price change. Current prices, 7d/30d changes and price history for those cards have been corrected against TCGPlayer's per-printing data. Where a per-printing lowest listing isn't available, low_price and lowest_with_shipping are now null rather than a value blended across printings.

infra

New sets appear within a day of release

The catalog sync now runs a daily pass over recently released sets instead of waiting for the weekly full sweep, so launch-day products show up within about a day rather than up to a week later.

fix

Search returns JSON on error, and tolerates bad pagination

GET /v1/search now returns a JSON error body rather than a bare failure, and non-numeric page or per_page values fall back to defaults instead of erroring. Clients that pass through user input no longer need to sanitise pagination first.

feature

Search matches card numbers as well as names

GET /v1/search now matches on collector number — a query like OP01-060 finds the card directly, without needing the card name. Useful for One Piece, Digimon and any game where players refer to cards by number.

feature

Per-condition pricing (NM, LP, MP, HP, Damaged)

GET /v1/cards/:id/prices/conditions and GET /v1/bulk/conditions now return condition-level price floors per printing — lowest listing, shipping-inclusive floor, and a junk-resistant median — from live TCGPlayer listings, continuously refreshed across all 50+ games. Pro and Business plans (also available via x402 pay-per-request).

coverage

Riftbound (League of Legends TCG) moved to daily refresh

Added Riftbound to the Tier 1 daily refresh group alongside Pokemon, Magic, Yu-Gi-Oh, Lorcana, Flesh and Blood, and One Piece.

feature

Bulk resolve endpoints

POST /v1/bulk/resolve/tcgplayer and /v1/bulk/resolve/name now available on Starter+ plans. Batch up to 1,000 IDs or names at a time; confidence-scored matching on name lookup.

fix

Sealed products return correct printing

Fixed an issue where sealed products returned 'Normal' printing instead of 'Sealed'. Affects /v1/cards/{id} for sealed items across all games.

featurecoverage

Price history now covers all $1+ cards

Expanded price history from the top-movers set to every card with a market price of $1 or more. History starts from March 2025 and grows weekly.

content

Compare pages launched

Published side-by-side comparisons with Scryfall, PokemonTCG.io, JustTCG, and the legacy TCGPlayer API.