Magic: The Gathering prices, history and metagame in one API
The MTGGoldfish API returns Magic: The Gathering market and tournament data as clean JSON, with tabletop prices in USD and Magic Online prices in tix kept apart in named fields.
This page covers what the MTGGoldfish API returns, who uses it, a real response and pricing. Every parameter and response field is in MTGGoldfish API parameters and responses →
- endpoints
- 16
- credits per call
- 1–3
1 credit per call≈ $1/1,000 calls1,000 free credits, no card
- Dragon Appeasement0.25
- set
- Alara Reborn
- collector_number
- 115
- Dragon Arch2.16
- set
- Apocalypse
- collector_number
- 135
- Dragon Bell Monk0.2
- set
- Fate Reforged
- collector_number
- 10
16 active endpoints, on 1, 2 and 3 credit tiers.
- POST/mtggoldfish/v1/search1 credit
- POST/mtggoldfish/v1/autocomplete1 credit
- POST/mtggoldfish/v1/card3 credits
- POST/mtggoldfish/v1/price_history2 credits
- POST/mtggoldfish/v1/sets1 credit
- POST/mtggoldfish/v1/set3 credits
- POST/mtggoldfish/v1/set_history2 credits
- POST/mtggoldfish/v1/movers1 credit
Run the call yourself, on the real endpoint
Change a parameter and press Try it. The response on the right is what your code will receive.
MTGGoldfish API
3 of 16 endpoints, ready to run
One printing in full: tabletop price in USD, MTGO price in tix, change, highs and lows, buylist, every other printing.
// Press "Try it" and this pane shows exactly what the // live site returned this second — including an empty // result, if that is the truth. No key, no account.
What MTGGoldfish endpoints does ReefAPI ship?
16 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Every parameter, every allowed value →
Missing a MTGGoldfish endpoint, or need a source we don't have yet?Contact us real people · same-day reply.How the MTGGoldfish API works
MTGGoldfish is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 632 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
From metagame to what a list costs: three calls
See what is winning in a format and what its top decklist costs in USD and tix.
{"format": "modern"}Shares, deck counts, prices and a slug for each archetype.
{"format": "modern", "name": "Challenge"}The latest events with their tournament_id.
{"tournament": "67879"}Standings, deck_id and deck price for every place; pass a deck_id to deck for the full list.
A live view of the format and the card-by-card cost of a winning deck.
curl -X POST https://api.reefapi.com/mtggoldfish/v1/card \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"name":"Ragavan, Nimble Pilferer","set":"MH2"}'{
"ok": true,
"data": { … },
"meta": {
"api": "mtggoldfish",
"endpoint": "card",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Tabletop dollars and MTGO tix are two different markets
MTGGoldfish tracks each printing twice: the tabletop price in USD and the Magic Online price in tix, and they move independently. The API never merges them or converts one into the other: every field names its currency. These are the numbers we read live on 2026-11-08.
| Printing | paper_price_usd | online_price_tix | Note |
|---|---|---|---|
| Black Lotus (Limited Edition Alpha) | 74,981.00 | 491.06 | All-time tabletop high 81,421.00; highest buylist 68,000.00 |
| Ragavan, Nimble Pilferer (Modern Horizons 2) | 43.49 | 7.75 | Tabletop spread 24%; Card Kingdom buylist 33.00 |
| Ragavan, Nimble Pilferer (Modern Horizons 2) Foil | 71.36 | 6.80 | On MTGO the foil was worth less than the non-foil that day |
| Sol Ring (Masters Edition IV) | null | 4.42 | An MTGO-only printing has no tabletop price: null, never 0 |
These are the site's listing-based prices, not completed sales: the tabletop figure matched the page's TCGplayer Mid row on 5 of 5 cards we audited and the MTGO figure matched its Cardhoarder row on 6 of 6. A null means the site shows no price in that market. Card pages show listing-based prices and vendor quotes rather than completed sales, and the API does not use an account.
What MTGGoldfish publishes, and what it does not
Tabletop USD and MTGO tix for every tracked printing, daily series since release, metagame and tournament data. Not available to a logged-out visitor, so not in the API: portfolio and price alerts, the premium CSV download. Card pages show listing-based prices and vendor quotes, not a list of completed sales.
Tabletop in USD and MTGO in tix, as separate daily series since release. The headline paper price equalled the TCGplayer Mid row on 5 of 5, and MTGO equalled Cardhoarder on 6 of 6.
27 of 27 values matched independently fetched pages, including metagame shares and a deck's line sum.
A card looked up by name alone follows the site's default printing, which can be MTGO-only, so the paper price can be null. The response says so.
Completed sales. Prices are listing-based with vendor quotes.
What people build with MTGGoldfish
The jobs this data is most often used for.
endpoints
credits per call
Track a card's price since release in USD or tix, or chart a whole set's total value
Alert on the day's biggest risers and fallers for Modern, Standard or Pioneer
Follow the metagame: which archetypes are gaining share, tabletop or MTGO, over 7 to 365 days
Pull a tournament's decks with every card's price to see what a top list costs
What MTGGoldfish data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
- 1,000 free credits on signup, no card
- One key, all 632 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/mtggoldfish/v1/card \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"name":"Ragavan, Nimble Pilferer","set":"MH2"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/mtggoldfish/v1/card",
headers={"x-api-key": REEF_KEY},
json={
"name": "Ragavan, Nimble Pilferer",
"set": "MH2"
},
timeout=90,
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up MTGGoldfish.
How far back does the price history go?▾
Every daily price since the printing was released, as two separate series, tabletop in USD and MTGO in tix. Sheoldred, the Apocalypse returned 1,533 daily points from 2022-08-18 in our live test; Ragavan, Nimble Pilferer has 1,957 paper points from 2021-05-27. Pass days to keep only the most recent points.
Are paper and MTGO prices ever mixed?▾
No. Every price field names its currency: price_usd, price_tix, paper_price_usd, online_price_tix, or a series labelled currency USD or TIX. If a printing has no price in one market the field is null.
Can I get the metagame for tabletop as well as MTGO?▾
Yes. metagame takes market (paper or online) and period (7, 14, 30, 90 or 365 days). Each archetype comes with its share of the field, the number of decks counted, tabletop and MTGO deck price, colors and key cards, ready to pass as a slug to archetype.
Can I get a tournament's full decklists?▾
Yes. tournaments finds events by name, format and date, tournament returns the standings with place, deck name, pilot and each deck's price, and deck returns the full 75 with quantities, section, category and each card's price in USD and tix. On the deck we audited, the card prices added up exactly to the site's $629.52 total.
How do I find every printing of a card?▾
search returns one row per card name, in the site's default printing, which can be an MTGO-only one. card (with name, or name and set, or a card_id from search) returns printings: every other printing with its finish, variant and both prices (176 for Sol Ring). Pass any of those card_ids to card or price_history.
Which prices are shown on a card?▾
The site's tabletop and MTGO headline price, plus the vendor quotes it lists: Card Kingdom and TCGplayer Mid for tabletop, Cardhoarder for MTGO, and what buylists pay. Vendor links in the response point to the vendor's page without tracking parameters.
What is the MTGGoldfish API?▾
MTGGoldfish API is a ReefAPI endpoint group for magic: the gathering prices in usd and mtgo tix, daily price history, movers, metagame and decks. It returns live JSON through POST requests under /mtggoldfish/v1.
Is the MTGGoldfish API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. MTGGoldfish calls use the same shared credit balance as every other ReefAPI engine.
Do I need a MTGGoldfish login or account?▾
No login to MTGGoldfish is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the MTGGoldfish data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the MTGGoldfish API use?▾
MTGGoldfish actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call MTGGoldfish from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call mtggoldfish actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the MTGGoldfish API a MTGGoldfish scraper?▾
It is the managed alternative to a DIY MTGGoldfish scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same magic: the gathering prices in usd and mtgo tix, daily price history, movers, metagame and decks back as clean JSON.
Why does my MTGGoldfish scraper keep getting blocked?▾
Most MTGGoldfish scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.
350 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling MTGGoldfish, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 631 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-08.