Magic: The Gathering API

The original TCG — 30 years of cards, real-time pricing

What the API Provides for MTG

High-Demand MTG Cards

Key cards across Commander, Modern, Legacy, and collector markets:

Notable MTG Sets

Code Examples

Search MTG Cards

import { TcgLookupClient } from '@tcgpricelookup/sdk';
const tcg = new TcgLookupClient({ apiKey: 'YOUR_KEY' });

// Search for any MTG card
const results = await tcg.cards.search({
  name: 'Mana Crypt',
  game: 'mtg',
});

// Search by set for specific printing
const mh2Cards = await tcg.cards.search({
  name: 'Ragavan',
  game: 'mtg',
  set: 'Modern Horizons 2',
});

console.log(results.data[0].name);
console.log(results.data[0].prices.nearMint.market);  // NM non-foil market
console.log(results.data[0].prices.nearMint.foil);    // NM foil market

Get Card with Foil Pricing

// Get Sheoldred with full condition + foil breakdown
const card = await tcg.cards.get('dmu-107', { game: 'mtg' });

console.log(card.name);                           // "Sheoldred, the Apocalypse"
console.log(card.set.name);                       // "Dominaria United"
console.log(card.prices.nearMint.market);         // NM non-foil market
console.log(card.prices.nearMint.foil);           // NM foil market
console.log(card.prices.lightlyPlayed.market);    // LP non-foil
console.log(card.prices.lightlyPlayed.foil);      // LP foil

Commander Deck Price Tool

// Price a Commander decklist (batch up to 20 cards per request)
const batch = await tcg.cards.batch([
  { name: 'Mana Crypt',              game: 'mtg' },
  { name: 'Sol Ring',                game: 'mtg' },
  { name: 'Dockside Extortionist',   game: 'mtg' },
  { name: 'Smothering Tithe',        game: 'mtg' },
  { name: 'Cyclonic Rift',           game: 'mtg' },
]);

const total = batch.data.reduce((sum, card) => {
  return sum + (card.prices.nearMint.market ?? 0);
}, 0);

console.log(`Staple package NM value: $${total.toFixed(2)}`);

Track Commander Spike / Ban Price Movement

// 90-day history to catch Commander spike or ban announcement (Trader plan)
const history = await tcg.cards.history('card-id-here', {
  game: 'mtg',
  days: 90,
});

history.data.forEach(entry => {
  console.log(entry.date, entry.prices.nearMint.market);
});

What People Build with MTG Price Data

Frequently Asked Questions