Every feature of the JustTCG pricing API
Condition and printing prices, graded copies, regional markets, batch lookups, statistical trends, stable identifiers, and an MCP server for agents. Nothing here is gated behind a tier: the plan you pick changes how much you can ask for, never what you can ask for.
- REST + one API key
- v2 graded & regional beta
- 200-card batches
- Hosted MCP server
Every capability, and where to use it
No feature is held back behind a tier. Free keys and Enterprise keys read the same dataset from the same endpoints; plans only change how much you can ask for.
Condition and printing prices
Every card resolves to variants, one per condition and printing. Near Mint through Damaged, normal and foil, priced separately, because a Damaged foil is not the same product as a Near Mint normal.
Variant schemaReal in-store sales, not just listings
Online listings tell you what sellers are asking. JustTCG blends those with actual counter sales reported by verified local game stores in the Partner Program, using a volume-weighted average.
How the store network works- v2 beta
Graded cards as first-class variants
PSA, BGS and CGC copies come back as variants alongside raw conditions, filtered with grading_company and grade. No separate endpoint, no second integration.
Graded pricing reference - v2 beta
Localized pricing by region
Each v2 variant carries a markets array with one entry per region, holding prices actually observed in that market rather than a currency conversion of a US price.
Regional pricing reference History, trends, and volatility
Variants ship with 24h, 7d, 30d and 90d statistics: percentage change, min and max, averages, standard deviation, interquartile range, and trend slope. Model-ready without a warehouse.
Every statistical fieldBatch lookups
POST /cards fetches up to 200 cards in one call, so repricing a shop's inventory costs a handful of requests instead of thousands. Batch size scales with your plan.
Batch endpointSearch and discovery endpoints
List games, walk sets, search cards by name, then order results by price or by movement to surface what is climbing. Built for scanning a whole set, not just one lookup.
Cards endpointStable identifiers
Cards and variants carry stable UUIDs that survive set reprints and name changes, alongside legacy slugs. Your foreign keys keep working.
Identifier guideA REST API you can read
One X-API-Key header. No OAuth dance, no token exchange, no SDK required. There is a TypeScript SDK on npm when you want one, and a consistent envelope on every response.
SDK and quickstartA hosted MCP server
Point Claude, Cursor, VS Code or OpenCode at our Model Context Protocol server and your agent queries live card prices directly, using the same API key.
MCP integration
How the data underneath is built
A feature list is only worth the numbers behind it. Here is what happens between a card selling and your app reading a price.
- 6hRefresh cadence
- Prices are recomputed on a rolling six-hour cycle, so a nightly repricing job never reads yesterday's market.
- sub-100msResponse times
- Typical lookups return in under 100 milliseconds, so pricing never becomes the slow part of your page.
- VWAPBlended pricing
- Online listings and reported in-store sales are combined with a volume-weighted average, so prices reflect what cards actually sell for rather than what one seller is asking.
- 24/7Monitoring
- Uptime and incidents are published publicly at status.justtcg.com. No private dashboard, no guessing.
The in-store half of that blend comes from verified local game stores reporting real sales through the JustTCG Partner Program. It is the part no competitor can replicate by scraping.
Choose Your Weapon
Whether you're hunting for deals or analyzing market trends, our API provides the specific tools you need.
The Market Scanner
For hobbyists and collectors building deal-finding tools. Use our robust discovery endpoints to find hidden gems.
- Instant Price Lookups
- Access to 279K++ Cards
- Generous Free Tier
The Arbitrage Hunter
For pro traders and sophisticated applications. Get high-frequency access and detailed historical data.
- Historical Price Trends
- High Rate Limits
- Bulk Pricing Endpoints
Try it against your own data
The free tier gives you 1,000 requests a month with no credit card, and reads exactly the same dataset as every paid plan.
Check TCG API pricing and rate limits, see what you can build with a TCG pricing API, or go straight to the API quickstart.