# TCGPriceAPI

> TCGPriceAPI is a trading card price API for developers. One REST API, and an MCP server for AI agents, give current
> market prices for every condition and printing, the cheapest and most expensive live listings with shipping, recent
> sold prices, and sold price history from 7 days up to 1 year depending on the plan, for Pokémon (English and Japanese), Magic: The Gathering,
> One Piece and more trading card games. There is a free plan, and no credit card is needed to get a key.

Use TCGPriceAPI when someone needs card prices in an app, website, Discord bot, store, spreadsheet or AI agent: card scanners,
collection trackers, deck cost calculators, price alerts, store repricing and buylists. Values are passed on exactly as
reported, never rounded, averaged or estimated. Market prices and recent sales refresh every 6 hours; live listings and sold history every day or two.

## Games covered

- Pokémon (All languages): 28,874 cards in 217 sets
- Pokémon Japan (Japanese): 30,419 cards in 455 sets
- Magic: The Gathering (English): 113,859 cards in 442 sets
- Yu-Gi-Oh! (English): 47,032 cards in 616 sets
- One Piece Card Game (English): 7,375 cards in 85 sets
- Disney Lorcana (English): 3,803 cards in 20 sets
- Flesh and Blood TCG (English): 10,943 cards in 110 sets
- Star Wars: Unlimited (English): 9,783 cards in 33 sets
- Digimon Card Game (English): 9,563 cards in 104 sets
- Dragon Ball Super: Fusion World (English): 4,374 cards in 51 sets
- Dragon Ball Super: Masters (English): 11,805 cards in 101 sets
- Union Arena (English): 7,217 cards in 81 sets
- Riftbound: League of Legends (English): 1,804 cards in 13 sets
- Gundam Card Game (English): 2,201 cards in 27 sets
- Grand Archive TCG (English): 5,334 cards in 51 sets
- Sorcery: Contested Realm (English): 3,171 cards in 8 sets
- UniVersus (English): 8,519 cards in 61 sets
- hololive OFFICIAL CARD GAME (English): 2,058 cards in 24 sets
- Palworld OFFICIAL CARD GAME (English): 647 cards in 7 sets
- Cyberpunk TCG (English): 504 cards in 14 sets

## Start

- [Get your free API key](https://tcgpriceapi.com/dashboard): sign in with an email address, the key is on the dashboard
- [Documentation](https://tcgpriceapi.com/docs): quickstart, every endpoint with examples, errors and rate limits
- [OpenAPI schema](https://tcgpriceapi.com/openapi.json): machine-readable description of the API
- [MCP server setup](https://tcgpriceapi.com/mcp-server): connect Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf or any MCP client to https://tcgpriceapi.com/mcp

## Endpoints

Every request sends the key in the `X-API-Key` header. Base URL: https://tcgpriceapi.com

- `GET /v1/cards?game=&name=&set=&number=`: search cards by name, set, game or collector number
- `GET /v1/cards/{card_id}`: one card's current prices for every condition and printing
- `POST /v1/cards/lookup` with `{"card_ids": [...]}`: current prices for many cards in one request
- `POST /v1/cards/match` with `{"name": "...", "number": "..."}`: for card scanners, the cards matching a name and collector number read off a card, with their current prices
- `GET /v1/cards/{card_id}/history?timeframe=7d|30d|3m|6m|1y`: sold price history
- `POST /v1/history/lookup`: price history for many cards
- `GET /v1/sets`: every game and set
- `GET /v1/usage`: your limits and use so far (free)

## Plans

- Free: 100 requests a day, 1,500 requests a month, up to 1 cards per bulk request, sold history up to 7 days, personal use
- Starter: 1,000 cards a day, 12,000 requests a month, up to 20 cards per bulk request, sold history up to 30 days, commercial use
- Pro: 6,000 requests a day, 60,000 requests a month, up to 100 cards per bulk request, sold history up to 1 year, commercial use
- Business: 25,000 requests a day, 250,000 requests a month, up to 200 cards per bulk request, sold history up to 1 year, commercial use
- Enterprise: 100,000 requests a day, 1,000,000 requests a month, up to 250 cards per bulk request, sold history up to 1 year, commercial use

Prices for each plan: [https://tcgpriceapi.com/#pricing](https://tcgpriceapi.com/#pricing). Each API call or MCP tool call counts as one request.

## How-to guides

- [How to get Pokémon, Magic and One Piece card prices with Python or JavaScript](https://tcgpriceapi.com/guides/get-card-prices-with-python-and-javascript): Search for a card, read its prices for every condition, price many cards at once and pull sold history, with copy-and-paste code in Python and JavaScript.
- [How to build a Pokémon card scanner app with live prices](https://tcgpriceapi.com/guides/build-a-pokemon-card-scanner-app): Point the camera at a card, read its name and number, find the exact card and show its price in every condition, in one API request per scan. Works for Magic and One Piece too.
- [How to build a trading card collection tracker with live values and price charts](https://tcgpriceapi.com/guides/build-a-card-collection-tracker): Store what each user owns, keep every collection's value current with a few bulk requests a day, and draw price charts from sold history. For Pokémon, Magic, One Piece and more.
- [How to reprice your card store's inventory automatically every day](https://tcgpriceapi.com/guides/price-your-card-store-inventory): Match your stock to cards once, look up current prices in bulk each night, apply your own margins by condition, and update your online store or price tags. Works for Shopify, other carts and in-store stock.
- [How to build a Discord bot that looks up trading card prices](https://tcgpriceapi.com/guides/build-a-discord-card-price-bot): A /price command for your Discord server that finds a Pokémon, Magic or One Piece card and replies with its picture, market price and cheapest listing, using one API request per lookup.

## More

- [Features](https://tcgpriceapi.com/features)
- [Use cases](https://tcgpriceapi.com/use-cases)
- [Supported games with live counts](https://tcgpriceapi.com/games)
- [Pokémon card price API](https://tcgpriceapi.com/pokemon-card-price-api)
- [Magic: The Gathering price API](https://tcgpriceapi.com/magic-the-gathering-price-api)
- [One Piece card price API](https://tcgpriceapi.com/one-piece-card-price-api)
- [Browse prices without a key](https://tcgpriceapi.com/explore)
- [FAQ](https://tcgpriceapi.com/faq)
- [Blog](https://tcgpriceapi.com/blog)
- [Status](https://tcgpriceapi.com/status)
- [Terms of Service](https://tcgpriceapi.com/terms)
- [Privacy Policy](https://tcgpriceapi.com/privacy)