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.

/cards

One endpoint, two methods.

GEThttps://api.justtcg.com/v1/cards

cardId

uuid | string

Optional

Direct lookup by card ID.

variantId

uuid | string

Optional

Direct lookup by variant ID — fastest path.

tcgplayerId

string

Optional

TCGplayer product ID.

mtgjsonId

string

Optional

MTGJSON UUID.

scryfallId

string

Optional

Scryfall UUID.

tcgplayerSkuId

string

Optional

TCGplayer SKU ID (variant-level).

Response

request.ts

import { JustTCG } from 'justtcg-js';

const client = new JustTCG();
const { data } = await client.cards.get({
  cardId: 'pokemon-battle-academy-fire-energy-22-charizard-stamped-promo',
  condition: ['NM', 'LP'],
  priceHistoryDuration: '30d',
});

console.log(data[0].variants[0].price);

response · 200 OK

{
  "data": [
    {
      "id": "pokemon-battle-academy-fire-energy-22-charizard-stamped-promo",
      "uuid": "23edc8d4-b6b7-5d0c-a5fa-659040d24a7c",
      "name": "Fire Energy (#22 Charizard Stamped)",
      "game": "Pokemon",
      "set": "battle-academy-pokemon",
      "set_name": "Battle Academy",
      "rarity": "Promo",
      "tcgplayerId": "219042",
      "mtgjsonId": null,
      "scryfallId": null,
      "variants": [
        {
          "id": "pokemon-…_near-mint",
          "uuid": "c6bfa6f7-0b82-5011-b2ee-b572e2708a0e",
          "condition": "Near Mint",
          "printing": "Normal",
          "price": 0.14,
          "priceChange24hr": 0,
          "lastUpdated": 1780936262,
          "priceHistory": [{
            "p": 0.14,
            "t": 1780358400
          }]
        }
      ]
    }
  ],
  "meta": { "total": 1, "limit": 20, "offset": 0, "hasMore": false },
  "_metadata": {
    "apiPlan": "Pro",
    "apiRequestsRemaining": 49213
  }
}

POSThttps://api.justtcg.com/v1/cards

Identifier precedence:variantId > tcgplayerSkuId > tcgplayerId > mtgjsonId > scryfallId > cardId. Use one identifier per item.

cardId

string

Optional

Card-level lookup.

variantId

string

Optional

Variant-level lookup — fastest path.

tcgplayerId

string

Optional

TCGplayer product ID.

mtgjsonId

string

Optional

MTGJSON UUID.

scryfallId

string

Optional

Scryfall UUID.

tcgplayerSkuId

string

Optional

TCGplayer SKU ID.

Limits:200 items / request (Enterprise), 100 (Starter & Pro), 20 (Free). Batch larger workloads.

Response

request.ts

import { JustTCG } from 'justtcg-js';

const client = new JustTCG();
const { data } = await client.cards.batch([
  { tcgplayerId: '219042', condition: 'NM', printing: 'Normal' },
  { tcgplayerId: '25788',  condition: 'LP', printing: '1st Edition' },
]);

response · 200 OK

{
  "data": [
    {
      "id": "pokemon-battle-academy-fire-energy-22-charizard-stamped-promo",
      "uuid": "23edc8d4-b6b7-5d0c-a5fa-659040d24a7c",
      "name": "Fire Energy (#22 Charizard Stamped)",
      "game": "Pokemon",
      "set": "battle-academy-pokemon",
      "set_name": "Battle Academy",
      "rarity": "Promo",
      "tcgplayerId": "219042",
      "mtgjsonId": null,
      "scryfallId": null,
      "variants": [
        {
          "id": "pokemon-…_near-mint",
          "uuid": "c6bfa6f7-0b82-5011-b2ee-b572e2708a0e",
          "condition": "Near Mint",
          "printing": "Normal",
          "price": 0.14,
          "priceChange24hr": 0,
          "lastUpdated": 1780936262,
          "priceHistory": [{
            "p": 0.14,
            "t": 1780358400
          }]
        }
      ]
    }
  ],
  "meta": { "total": 1, "limit": 20, "offset": 0, "hasMore": false },
  "_metadata": {
    "apiPlan": "Pro",
    "apiRequestsRemaining": 49213
  }
}

*Per-request limits

The maximum number of cards you can request at once depends on your plan. For GET requests this is the highest accepted value for the limit parameter; for POSTrequests it's the maximum length of the lookup array. Batch larger workloads across multiple requests.

Plan	Max cards per request
Free	20 cards
Starter	100 cards
Pro	100 cards
Enterprise	200 cards