JustTCG is a dedicated REST API for Trading Card Game pricing data. We provide accurate, market-driven pricing for Magic: The Gathering, Pokémon, Yu-Gi-Oh!, Disney Lorcana, One Piece TCG, Flesh and Blood, Digimon, and more — built specifically for developers.

How often is the pricing data updated?

Our pricing data is updated continuously from real sales data across all major online TCG marketplaces, with full refreshes throughout the day. Price trend data covers 7-day, 30-day, 90-day, and 180-day windows.

Do you offer a free tier?

Yes. The Free plan includes 1,000 API requests per month and 100 per day. No credit card is required to sign up.

Which Trading Card Games do you support?

JustTCG supports Magic: The Gathering, Pokémon (English and Japanese), Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Digimon Card Game, Flesh and Blood TCG, Grand Archive TCG, Gundam Card Game, Star Wars: Unlimited, Riftbound: League of Legends TCG, and Union Arena. We continuously add new games.

How do I authenticate with the JustTCG API?

All API requests require an API key passed in the X-API-Key HTTP header. You can get your API key from your dashboard at justtcg.com/dashboard after signing up for a free account.

Is there an MCP server for AI agents?

Yes. JustTCG provides a hosted Model Context Protocol (MCP) server at mcp.justtcg.com. This allows MCP-compatible AI agents like Claude, Cursor, and Windsurf to query real-time TCG pricing data directly, using the same API key as the REST API.

Where do you get your pricing data?

Our pricing is market-driven. JustTCG analyzes real sales data from all major online TCG marketplaces and applies a volume-weighted average so that platforms with higher sales volume have greater influence on the final price. This produces the most stable and accurate snapshot of a card's market value.

Rate limits

Rate limits are tied to your subscription plan. Monitor usage in the dashboard.

Plans

Plan	Monthly	Daily	Per minute
Free	1,000 requests	100 requests	10 / min
Starter	10,000 requests	1,000 requests	50 / min
Professional	50,000 requests	5,000 requests	100 / min
Enterprise	500,000 requests	50,000 requests	500 / min

If you exceed your minute rate limit, the API returns 429 Too Many Requests. If you exceed your monthly limit, you'll need to upgrade your plan to continue.

Reset times

Plan type	Daily reset	Monthly reset
Free	Midnight (00:00) UTC	On the day-of-month the account was created, at 00:00 UTC.
Paid	Midnight (00:00) UTC	On successful payment at the start of each billing cycle.

Retry strategy:Use exponential backoff with jitter when handling 429 responses. Start at ~1s and double up to a sensible cap (~30s); always honor any Retry-After header when present.

Free tier on shared infrastructure

Running on shared infrastructure?If your backend runs on Cloudflare Workers, AWS Lambda, Vercel, or another serverless or shared‑hosting platform with a Free API key, you may occasionally see an EXCESSIVE_FREE_TIER_USAGE block. Paid plans are not subject to these shared‑environment protections. Upgrading to any paid plan resolves it.

Why am I seeing EXCESSIVE_FREE_TIER_USAGE on a Free key?Applies only to Free tier traffic from shared cloud environments

Free API keys carry additional abuse protections beyond the per‑plan limits in the table above. In a shared cloud environment, requests from many unrelated Free tier users can be grouped together by the underlying platform, so the combined activity may trigger a temporary block; even when your own key's usage is well within the Free tier. When this happens the API returns: EXCESSIVE_FREE_TIER_USAGE.

Resolution: Move to any paid plan. Paid traffic is exempt from these shared‑environment protections, so your requests are no longer affected by other tenants on the same platform.