--- name: api.tcgapi.dev description: api.tcgapi.dev provides structured metadata and pricing data for trading cards across 85+ trading card games including Pokémon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, and others. It exposes endpoints for card details, set listings, historical price data, daily price movers, and Cardmarket EU coverage statistics. All data is sourced from TCGPlayer market pricing and related scraping pipelines. host: api.tcgapi.dev --- # api.tcgapi.dev api.tcgapi.dev is a multi-TCG data API serving agents that need card metadata, set information, and market pricing from TCGPlayer and Cardmarket EU. It covers 85+ games and supports use cases ranging from single-card lookups to full set exports and historical price trend analysis. It does not offer real-time streaming prices, deck-building logic, or cross-marketplace trading execution. ## When to use this host Use api.tcgapi.dev when an agent needs TCGPlayer market pricing, card metadata, set listings, historical price series, or daily price movers for trading cards across 85+ TCGs. It is the right choice for set cataloging, card valuation, price trend analysis, and Cardmarket EU coverage assessment. Do not use it for: searching cards by name (all card and price endpoints require a known numeric card ID or TCGPlayer product ID); bulk lookups across many cards in a single call; real-time streaming or live tick-level price feeds (data is periodically updated, not live); deck-building, collection management, or trade execution logic. If an agent needs to resolve a card name to an ID, a separate search or name-resolution endpoint not present on this host would be required first. ## Capabilities ### Set Discovery and Metadata Enables agents to enumerate, browse, and retrieve structured metadata for TCG sets across 89+ games, including release dates, card counts, game affiliation, and image URLs. - **`fetch-tcg-sets-list`** — Returns a paginated list of trading card game sets across 89+ games including Magic: The Gathering, Pokemon, Yu-Gi-Oh, Digimon, and others, with set identifiers, names, slugs, release dates, card counts, game metadata, and image URLs. - **`fetch-tcg-set-details`** — Returns metadata for a trading card game set by numeric set ID, including name, slug, release date, card count, game name, and image URLs for Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, and other supported games. ### Card Metadata Lookup Retrieves detailed metadata for individual trading cards by numeric ID or TCGPlayer product ID, including name, rarity, HP, attacks, abilities, set affiliation, and image URLs. - **`fetch-tcgplayer-card-by-id`** — Returns structured metadata and current market pricing for a trading card by its TCGPlayer product ID, covering Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, and 85+ other TCGs. - **`fetch-tcg-card-details`** — Returns detailed trading card metadata and market data for a single card by numeric ID, covering 85+ TCGs including Pokemon, Magic: The Gathering, Yu-Gi-Oh, and Lorcana. ### Set Card Inventory Returns the full list of cards and sealed products within a specific set, including per-card pricing, rarity, and image data, suitable for cataloging or inventory sync. - **`fetch-tcg-set-cards`** — Returns all cards and sealed products in a trading card game set by set ID, including name, number, rarity, pricing, and image URL for each item. - **`fetch-tcgapi-set-export`** — Returns the full card and sealed-product export for a specified TCG set, including IDs, names, set numbers, rarity, product type, listing counts, and pricing fields across 85+ trading card games. ### Current Card Pricing Provides current TCGPlayer market prices, price change deltas (24h/7d/30d), and printing metadata for individual cards by numeric card ID. - **`fetch-tcg-card-prices`** — Returns TCGPlayer market price, price changes (24h/7d/30d), and printing metadata for a specific trading card by its numeric card ID. ### Price Movement and Trends Surfaces daily top price movers across TCGs and provides daily or weekly historical price series for individual cards, enabling trend analysis, charting, and arbitrage detection. - **`fetch-tcg-price-top-movers`** — Returns the biggest daily price gainers and losers across trading card games including Pokemon, Magic: The Gathering, Yu-Gi-Oh, UniVersus, and Battle Spirits Saga, with market price and percent change. - **`fetch-tcg-card-price-history`** — Returns weekly historical TCGPlayer pricing data for a specific trading card by card ID, including market price, average sales price, and sales volume per printing. ### Data Coverage Assessment Returns Cardmarket EU scraping coverage statistics per game and set, allowing agents to assess data completeness and confidence before relying on EU pricing. - **`fetch-cardmarket-coverage`** — Returns Cardmarket EU pricing coverage statistics for TCG card sets, including total sets, scraped counts, and average confidence metrics per game. ## Workflows ### Set Exploration to Card Pricing *Use when an agent needs to browse available sets, select one, and retrieve current pricing for all cards within it.* 1. **`fetch-tcg-sets-list`** — Enumerate available TCG sets to identify the target set and obtain its numeric set ID. 2. **`fetch-tcg-set-details`** — Retrieve structured metadata for the selected set to confirm identity, release date, and card count. 3. **`fetch-tcg-set-cards`** — Fetch all cards and their current pricing for the confirmed set ID. ### Card ID Resolution to Price History *Use when an agent needs to analyze the historical price trend for a card but only has a TCGPlayer product ID rather than a numeric card ID.* 1. **`fetch-tcgplayer-card-by-id`** — Resolve the TCGPlayer product ID to structured card metadata, obtaining the numeric card ID. 2. **`fetch-tcg-card-price-history`** — Use the resolved numeric card ID to retrieve daily or weekly historical price data for trend analysis. ### Top Mover Deep Dive *Use when an agent needs to investigate a trending card surfaced by the daily movers feed, retrieving full metadata and price history for context.* 1. **`fetch-tcg-price-top-movers`** — Identify cards with the largest daily price movements and obtain their numeric card IDs. 2. **`fetch-tcg-card-details`** — Retrieve enriched metadata for a specific mover card using its numeric card ID. 3. **`fetch-tcg-card-price-history`** — Pull historical price data for the card to contextualize whether the daily move is an anomaly or part of a longer trend. ### Full Set Bulk Export with Coverage Check *Use when an agent needs to ingest a complete set's card and pricing data from both TCGPlayer and Cardmarket EU, and must first verify EU data completeness.* 1. **`fetch-cardmarket-coverage`** — Check Cardmarket EU scraping coverage and confidence for the target game before relying on EU pricing fields. 2. **`fetch-tcgapi-set-export`** — Export the full card and product list for the target set, including all pricing fields, with coverage context already established. ## Skill reference ### `fetch-tcgplayer-card-by-id` **TCGPlayer Card Lookup** — Returns structured metadata and current market pricing for a trading card by its TCGPlayer product ID, covering Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, and 85+ other TCGs. *Use when:* Use when an agent needs card details (name, rarity, HP, attacks, abilities, set, image) and current market or listing prices for a specific card identified by its TCGPlayer product ID. *Not for:* Do not use for searching cards by name or set — this endpoint requires a known TCGPlayer product ID. Not suitable for bulk card lookups or deck-level price aggregation. **Inputs:** - `tcgplayer_id` (integer, required) — The TCGPlayer product ID for the card, embedded as the final path segment in the URL (e.g. /v1/cards/tcgplayer/{tcgplayer_id}). **Returns:** Returns a data object with card metadata (name, rarity, set, image, attacks), listing counts, lowest/median prices, and a prices array with market price and 24h/7d/30d price changes for each printing. **Example:** `GET https://api.tcgapi.dev/v1/cards/tcgplayer/475980` --- ### `fetch-tcg-card-prices` **TCG Card Price API** — Returns TCGPlayer market price, price changes (24h/7d/30d), and printing metadata for a specific trading card by its numeric card ID. *Use when:* Use when an agent needs current TCGPlayer pricing data for a specific trading card printing identified by a numeric card ID, across supported TCGs such as Pokémon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, One Piece, or Flesh and Blood. *Not for:* Do not use for bulk price lookups across multiple cards in a single call, or for searching cards by name — a card search endpoint would be needed first to obtain the numeric card ID. **Inputs:** - `card_id` (integer, required) — Numeric ID of the specific card printing to retrieve prices for, embedded in the URL path (e.g. /v1/cards/{card_id}/prices). **Returns:** Returns a data array with one object per printing containing market_price (29.28 USD), 24h/7d/30d price changes, card_name, tcgplayer_id, and a last_updated_at timestamp; low/median/buylist prices may be null. **Example:** `GET https://api.tcgapi.dev/v1/cards/5846/prices` --- ### `fetch-cardmarket-coverage` **TCG API Cardmarket Coverage** — Returns Cardmarket EU pricing coverage statistics for TCG card sets, including total sets, scraped counts, and average confidence metrics per game. *Use when:* Use when an agent needs to assess how completely Cardmarket pricing data has been scraped and mapped for TCG games such as Pokémon, Magic: The Gathering, Yu-Gi-Oh, or Lorcana before relying on that data for pricing decisions. *Not for:* Do not use to retrieve actual card prices or individual card data; this endpoint returns coverage statistics only, not pricing records. **Returns:** Returns a data object with a sets array (per-game stats: total_sets, total_mapped, total_scraped, avg_confidence), plus aggregate total_mappings, total_prices, match_methods, and confidence_distribution fields. **Example:** `GET https://api.tcgapi.dev/v1/cardmarket/coverage` --- ### `fetch-tcg-set-details` **TCG Set Details** — Returns metadata for a trading card game set by numeric set ID, including name, slug, release date, card count, game name, and image URLs for Pokemon, Magic: The Gathering, Yu-Gi-Oh, Lorcana, and other supported games. *Use when:* Use when an agent needs structured metadata about a specific TCG set — such as its release date, card count, game affiliation, or TCGPlayer ID — given a known numeric set ID. *Not for:* Do not use for searching or listing sets by name or game; this endpoint requires a known set ID. Not suitable for retrieving individual card data within a set. **Inputs:** - `set_id` (integer, required) — Numeric set ID embedded in the URL path (e.g. 100001). Must be a known TCG set ID. **Returns:** Returns a data object with the set's numeric ID, name, slug, release date, card count, TCGPlayer ID, game name, game slug, and optional image/icon URLs. **Example:** `GET https://api.tcgapi.dev/v1/sets/100001` --- ### `fetch-tcg-sets-list` **TCG Sets List** — Returns a paginated list of trading card game sets across 89+ games including Magic: The Gathering, Pokemon, Yu-Gi-Oh, Digimon, and others, with set identifiers, names, slugs, release dates, card counts, game metadata, and image URLs. *Use when:* Use when an agent needs to enumerate or browse TCG sets across multiple games, look up set release dates, card counts, or retrieve set image and icon URLs for display or downstream card lookups. *Not for:* Do not use to fetch individual card data within a set; use a card-level endpoint instead. Not suitable for real-time price data or deck-building queries. **Returns:** Returns a data array of TCG set objects each containing id, name, slug, tcgplayer_id, release_date, card_count, game_name, game_slug, and optional image_url and set_icon_url fields spanning multiple games. **Example:** `GET https://api.tcgapi.dev/v1/sets` --- ### `fetch-tcg-set-cards` **TCG Set Cards** — Returns all cards and sealed products in a trading card game set by set ID, including name, number, rarity, pricing, and image URL for each item. *Use when:* Use when an agent needs the full card list for a specific TCG set (Pokémon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, or similar) identified by a numeric set ID, including per-card pricing and image data. *Not for:* Do not use to search cards by name or filter across multiple sets; this endpoint returns all cards for one specific set ID only. **Inputs:** - `set_id` (integer, required) — Numeric set identifier embedded in the URL path (e.g. 100001). Determines which TCG set's cards are returned. **Returns:** Returns a data array of card and sealed product objects, each with id, name, collector number, rarity, TCGPlayer ID, product type, printing, market/low/median pricing (nullable), price timestamp, and image URL. **Example:** `GET https://api.tcgapi.dev/v1/sets/100001/cards` --- ### `fetch-tcg-price-top-movers` **TCG Price Top Movers** — Returns the biggest daily price gainers and losers across trading card games including Pokemon, Magic: The Gathering, Yu-Gi-Oh, UniVersus, and Battle Spirits Saga, with market price and percent change. *Use when:* Use when an agent needs to identify which trading cards have experienced the largest price movements in the past day, for market monitoring, arbitrage detection, or surfacing trending cards to a user. *Not for:* Do not use for looking up the current price of a specific card by name or ID; use a card-specific price lookup endpoint instead. Not suitable for historical price trend analysis over multiple days. **Returns:** Returns a data array of top-moving trading cards with card ID, name, TCGPlayer ID, image URL, set name, game name, printing type, market price in USD, percent price change, and last updated timestamp. **Example:** `GET https://api.tcgapi.dev/v1/prices/top-movers` --- ### `fetch-tcg-card-price-history` **TCG Card Price History** — Returns daily historical price data (up to 10 years) for a specific trading card by numeric ID, including market price, low price, average sales price, sales volume, and printing type. *Use when:* Use when an agent needs to retrieve the historical price trend for a specific trading card (Pokemon, Magic: The Gathering, Yu-Gi-Oh, or Lorcana) identified by its numeric card ID, such as for price analysis, charting, or valuation over time. *Not for:* Do not use for searching cards by name or set — this endpoint requires a known numeric card ID. Not suitable for real-time live price feeds; data is updated periodically in a daily series. **Inputs:** - `card_id` (integer, required) — Numeric identifier of the trading card whose price history is being requested. Embedded in the URL path (e.g. /v1/cards/{card_id}/history). **Returns:** Returns a data array of daily price records each with date, printing, market_price, low_price, avg_sales_price, and sales_volume fields, plus a meta object with the total record count. **Example:** `GET https://api.tcgapi.dev/v1/cards/5846/history` --- ### `fetch-tcg-card-price-history` **TCG Card Price History Details** — Returns weekly historical TCGPlayer pricing data for a specific trading card by card ID, including market price, average sales price, and sales volume per printing. *Use when:* Use when an agent needs to analyze price trends, sales velocity, or market movement for a specific TCG card (Pokemon, Magic, Yu-Gi-Oh) over time using its numeric card ID. *Not for:* Do not use for real-time or live spot prices; this endpoint returns weekly aggregated historical data. Do not use to search for cards by name — a card lookup endpoint is needed first to obtain the numeric card ID. **Inputs:** - `card_id` (integer, required) — Numeric TCG card identifier embedded in the URL path (e.g. 5846). Obtain this from a card search or lookup endpoint. **Returns:** Returns a data array of weekly records each containing date, printing, market_price, low_price (nullable), avg_sales_price, and sales_volume for the specified card. **Example:** `GET https://api.tcgapi.dev/v1/cards/5846/history/detailed` --- ### `fetch-tcgapi-set-export` **TCGAPI Set Export** — Returns the full card and sealed-product export for a specified TCG set, including IDs, names, set numbers, rarity, product type, listing counts, and pricing fields across 85+ trading card games. *Use when:* Use when an agent needs a complete snapshot of all cards and products in a specific TCG set — including market price, low price, median price, buylist price, and listing counts — for inventory sync, cataloging, or market data ingestion. *Not for:* Do not use for real-time streaming price feeds or cross-set searches; this returns a single-set bulk export only. **Inputs:** - `setId` (integer, required) — Numeric set ID embedded in the URL path. Identifies the TCG set to export (e.g., 100001). **Returns:** Returns a data array of card and sealed-product objects for the set, each with id, name, set number, rarity, tcgplayer_id, product_type, listing count, printing, and pricing fields (market, low, median, lowest_with_shipping, buylist). **Example:** `GET https://api.tcgapi.dev/v1/export/set/100001` --- ### `fetch-tcg-card-details` **TCG Card Details** — Returns detailed trading card metadata and market data for a single card by numeric ID, covering 85+ TCGs including Pokemon, Magic: The Gathering, Yu-Gi-Oh, and Lorcana. *Use when:* Use when an agent needs enriched card data for a known TCG card ID, including name, set, rarity, HP, attacks, abilities, image URL, TCGPlayer listing URL, lowest price with shipping, and median price. *Not for:* Do not use for searching cards by name or set — this endpoint requires a known numeric card ID. Not suitable for bulk card lookups or price feed streaming. **Inputs:** - `id` (integer, required) — Numeric card ID used to identify the specific card in the TCG API. Appears as the final path segment in the URL. **Returns:** Returns a data object with full card metadata for card ID 5846 (Charizard), including set name, rarity, image URL, TCGPlayer URL, HP, attacks, lowest price with shipping ($31.49), median price ($32.50), and enriched custom attributes. **Example:** `GET https://api.tcgapi.dev/v1/cards/5846` ---