Magic: The Gathering API
オリジナルTCG — 30年分のカード、リアルタイム価格
Magic: The Gatheringは1993年に初セットをリリースした世界最古のトレーディングカードゲームです。30年以上のプリント歴史と10万枚以上のユニークなカードを持つMTGの市場ダイナミクスは他のTCGとは異なります。予約リスト(Wizards of the Coastが特定のカードを再録しないという約束)は500枚以上のカードに絶対的な価格の底を作り出しています。最も価値のあるMTGカードであるBlack Lotusは、高グレードで$100,000以上で定期的に取引されます。Alphaセット全体は美術品に匹敵する価格を誇ります。
ローテーション制のゲームとは異なり、MTGのエターナルフォーマット(Legacy、Vintage、Commander)は古いカードを無期限にアクティブな需要に保ちます。Commanderは現在世界で最もプレイされているMTGフォーマットであり、政治的・相互作用・ランプの価値を持つカードに独自の価格圧力をもたらします。Commanderでのカードのスパイクは週末で$5から$50に跳ね上がることがあります。Modern Horizonsセットは強力な再録と新しいデザインで競技フォーマットを特に標的にしており、毎年二次市場価格に最も大きな影響を与えるリリースとなっています。
MTGカードの価格はTCGの中で独自の方法でコンディションに敏感です。1993年のAlphaカードのエッジウェアは2023年のカードのエッジウェアとは異なります。フォイルのプレミアムはカードとプリントによって大きく異なり、フォイルが通常版の5倍になる場合もあれば、ほぼ変わらない場合もあります。APIはフォイルと非フォイルの価格を別々に返し、正確なコレクション評価のためのコンディション別の細かさを提供します。
MTG向けAPIデータ
フォイル・非フォイル価格
通常版とフォイル版の別々の市場価格。MTGではフォイルのプレミアムが微小なものから同じカードの10倍になる場合もあるため、必須です。
コンディション別価格
すべてのカードのNear MintからDamagedまでの価格。予約リストのスタプルはコンディションが価値に劇的に影響します — LP版のPower 9はNM版の半分程度になることがあります。
PSA / BGS / CGC グレーデッド価格
対象のMTGカードのグレーデッド価格。高グレードのAlphaとBetaのコピーはますますグレーデッドカードとして取引されており、Raw版に対するプレミアムを追跡しています。Traderプランが必要です。
90日間価格履歴
Commanderのスパイク、フォーマット禁止、再録発表を時系列で追跡します。MTGは全TCGの中で最も劇的な短期価格変動があります。Traderプランが必要です。
セット・エディションフィルタリング
セットでフィルタリングして特定のプリントを絞り込みます。LegendsのCounterspellはMastersの再録版よりもはるかに価値があり、セットフィルタリングで正確に価格設定できます。
一括リクエスト対応
1リクエストで最大20枚のカードを検索できます。Commanderデッキの価格設定、バインダーの評価、ストアのバイリスト値を100回ではなく1回のAPI呼び出しで生成できます。
需要の高いMTGカード
Commander、Modern、Legacy、コレクター市場の主要カード:
注目のMTGセット
オリジナルプリント。Alphaの黒ボーダー、丸い角、限定プリントランは永続的なプレミアムステータスを与えています。BetaとUnlimitedはより流動的ですが依然として高く評価されています。Power 9がここにあります。
現代MTG史上二次市場価格への最もインパクトのあるセットと言われています。Ragavan、Solitude、Grief、および多数のフェッチランド/デュアルランドの再録がピーク時にボックス価格を$300以上に押し上げました。
シリアライズドのOne Ringが大きな主流メディアの注目を集めました。フルセットには競技スタプルと、大きなプレミアムを誇るShowcaseとSceneトリートメントの高価値カードが含まれています。
Commanderスタプルを対象とした高価値再録セット。Dockside、Mana Crypt、その他の再録を追跡することで、90日間の典型的な再録後の価格軌跡を確認できます。
Modern Horizonsの伝統をフォーマットを揺るがすデザインで継続しました。EltraziとNadu関連のカードが競技価格の議論を支配しました。禁止リスト監視による価格追跡はここでよくあるユースケースです。
コード例
MTGカードを検索
import { TcgLookupClient } from '@tcgpricelookup/sdk';
const tcg = new TcgLookupClient({ apiKey: 'YOUR_KEY' });
// 任意のMTGカードを検索
const results = await tcg.cards.search({
name: 'Mana Crypt',
game: 'mtg',
});
// 特定のプリントをセットで検索
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 非フォイル市場価格
console.log(results.data[0].prices.nearMint.foil); // NM フォイル市場価格 フォイル価格付きカード取得
// Sheoldredをコンディション別 + フォイル内訳付きで取得
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 非フォイル市場価格
console.log(card.prices.nearMint.foil); // NM フォイル市場価格
console.log(card.prices.lightlyPlayed.market); // LP 非フォイル
console.log(card.prices.lightlyPlayed.foil); // LP フォイル Commanderデッキ価格ツール
// Commanderデッキリストの価格計算(1リクエストで最大20枚)
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(`スタプルパッケージのNM価値: $${total.toFixed(2)}`); Commanderスパイク / 禁止発表の価格変動追跡
// Commanderスパイクや禁止発表を追跡するための90日間履歴(Traderプラン)
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);
}); MTG価格データで構築できるもの
Commanderデッキビルダー
ユーザーがCommanderデッキを構築する際に各カードのライブ価格を表示します。スタプルが高い場合は予算代替案を提示します。デッキの合計コストをリアルタイムで計算します。
ストアバイリスト自動化
MTGショップは大規模なバイリストを運営しています。実際の市場データからコンディション別調整付きでバイリスト価格を自動化することで、手動価格設定の時間を節約し、競争力を維持できます。
MTGファイナンストラッカー
予約リストカードのウォッチリスト、再録監視、禁止/解除の価格影響分析。90日間の履歴エンドポイントはこのユースケースに不可欠です。
大規模コレクション管理
MTGコレクターは通常10,000〜100,000枚のカードを持っています。バッチ価格設定、セットベースの整理、プリント別価格分離により、そのスケールでのコレクション評価が可能になります。
フォーマット合法性 + 価格ツール
カードの合法性データとリアルタイム価格を組み合わせて「最安のStandard合法版」や「このカードのModern向け最安プリント」を表示します。
プリント比較ツール
MTGカードは30年にわたって何十種類ものプリントがあります。任意のカードの最安の機能的プリントとプレミアムコレクタープリントを表示します。
よくある質問
APIは予約リストのカードに対応していますか?
フォーマットの合法性でMTGカードをフィルタリングできますか?
APIでのMTGフォイル価格はどのように機能しますか?
prices.nearMint.marketはNM非フォイル価格で、prices.nearMint.foilはNMフォイル価格です。データが利用可能な場合、TCGPlayerとeBayの両ソースがこの方法で分離されています。
1枚のカードに対して何種類のプリントにアクセスできますか?
MTG APIを始める
- 1
無料APIキーを取得
tcgpricelookup.com/dashboardでサインアップ。無料プランは1日200リクエストで、Commanderデッキツールやコレクショントラッカーのプロトタイプとして十分です。
- 2
game: 'mtg'で検索すべてのMTGクエリは
mtgゲームスラッグを使用します。名前で検索するとすべてのプリントが返されます。特定のエディションにはセットフィルターを追加してください。レスポンスにはコンディション別のフォイルと非フォイルの価格が含まれます。 - 3
デッキリストにバッチリクエストを使用
1リクエストで最大20枚のカードを送信できます。フルCommanderデッキ(99枚+統率者)は5回のバッチリクエストで完成します。完全なデッキリストを一瞬で価格設定できます。
- 4
価格履歴とグレーデッドデータへのアップグレード
Traderプラン(月額$14.99)で90日間の価格履歴が追加されます — MTGファイナンスとCommanderスパイク追跡に不可欠です。Businessプラン(月額$89.99)は高トラフィックのストアツール向けです。
Magic: The Gathering価格データで開発を始めよう
無料APIキーを取得して、30年分のMTGカード価格の取得を開始。クレジットカード不要。