Magic: The Gathering API
Try with 100 free credits across all customer data endpoints. No payment card required. Credits pay for requests: 1 credit for a catalog lookup, 2 for a price or certificate lookup, 5 for live listings or prices by condition (SKU prices). After your free credits are used, buy a credit pack (from £10, no subscription) or choose a monthly plan. Plan tiers on this page name the monthly plan that includes each endpoint.
Access current MTG pricing data, live marketplace listings, and historical sales. Magic: The Gathering catalog records, prices and sales history with documented plan access.
What Data Do You Get?
Everything you need to build Magic: The Gathering applications, from current prices to historical trends.
Market Prices
Low, mid, high and market prices by printing, with a last_updated timestamp on each price record.
Live Listings
Access current TCGPlayer marketplace listings with seller info, quantities, and prices.
Sales History
Historical sold listings with dates, prices, and conditions for trend analysis.
Condition Pricing
SKU-level prices for Near Mint, Lightly Played, Moderately Played, and other supported conditions where available.
Set Catalog
Catalog records for sets such as Alpha and Modern Horizons. Use the expansions endpoint for current availability.
Variant Data
Separate pricing for foils, extended art, showcase, borderless, and special treatments.
Explore MTG Sets
These are examples from the catalog, not a list of the latest releases. Query the expansions endpoint for current availability.
Simple API Integration
Search first, then use the returned product ID for separate catalog and price requests. The example checks each response before reading its data.
// Category IDs come from GET /api/v2/games.
// Run on your server. Credits (free or bought) cover all customer data endpoints.
// Monthly plans: catalog/search Hobby+, product prices Business+.
const headers = { 'x-api-key': process.env.TCGAPIS_KEY };
async function get(path) {
const response = await fetch('https://api.tcgapis.com/api/v2' + path, { headers });
const body = await response.json();
if (!response.ok || !body.success) throw new Error(body.error || 'API request failed');
return body;
}
const search = await get('/search?q=Lightning+Bolt&game=1&limit=1');
const productId = search.data[0]?.productId;
if (!productId) throw new Error('No matching product found');
const product = await get('/products/' + productId);
const prices = await get('/prices/' + productId);
console.log(product.data); // Catalog details and available SKU metadata
console.log(prices.data.prices); // Pricing records grouped by printing
console.log(prices.data.last_updated); // Record timestamp when provided
// SKU prices and live listings use separate endpoints: 5 credits per request, or Unlimited.What Can You Build?
Our MTG API powers apps and tools for players, collectors, stores, and traders.
Deck Building Tools
Build apps that help players price and optimize their MTG decks with current market data.
LGS Inventory Systems
Power your local game store inventory with MTG price records and product metadata.
Trading Platforms
Create MTG trading platforms with fair valuations based on current market prices.
Market Analysis
Analyze MTG market trends, Reserved List speculation, and format price movements.
Frequently Asked Questions
Common questions about our Magic: The Gathering API.
What Magic: The Gathering data does the API provide?
Our MTG API provides data including current market prices, live TCGPlayer listings, historical sales data, card conditions, foil variants, and detailed card information for available Magic: The Gathering sets.
What is a good MTG price API for marketplace data?
TCGAPIs provides MTG marketplace data through one REST API, including low, mid, high, market, and direct low prices, SKU-level foil and condition variants, current listings, and historical sold data.
How is TCGAPIs different from Scryfall?
Scryfall is excellent for Magic card oracle text, images, legality, and card metadata. TCGAPIs is built for commercial MTG marketplace data such as SKU prices, live TCGPlayer listings, and sales history.
Can TCGAPIs provide SKU-level MTG prices by condition and finish?
With credits or on Unlimited, TCGAPIs returns available SKU-level MTG pricing for condition and finish combinations including foil, non-foil, etched foil, Near Mint, Lightly Played, Moderately Played, and other marketplace variants.
Which MTG sets are supported?
The catalog includes Magic: The Gathering sets such as Alpha and Modern Horizons. Query the expansions endpoint for the current list; coverage depends on source catalog availability.
How often is MTG card pricing updated?
Price records include a last_updated timestamp; refresh timing varies by product and source. Live TCGPlayer listings are fetched on request and cached for up to an hour, with a stored snapshot returned if the source cannot be reached. Historic prices are daily snapshots.
Does the API support foil MTG cards?
Yes, TCGAPIs provides separate pricing data for foil and non-foil variants, including etched foils, extended art, showcase frames, and other special treatments.
Can I get Reserved List card prices?
Reserved List cards may have catalog, price and sales-history records where those records are available from the source. Check the response for the specific product and printing; neither a price nor a sales history is guaranteed for every card.
Explore Other TCG APIs
Catalog coverage spans 60+ trading card games; available data varies by game and source.
Ready to Access MTG Card Data?
Build Magic: The Gathering tools with catalog records, timestamped prices and documented plan access.