Features

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
The Full Surface

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 schema
  • Real 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 field
  • Batch 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 endpoint
  • Search 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 endpoint
  • Stable identifiers

    Cards and variants carry stable UUIDs that survive set reprints and name changes, alongside legacy slugs. Your foreign keys keep working.

    Identifier guide
  • A 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 quickstart
  • A 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.

Built for your Strategy

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.