{"openapi":"3.1.0","info":{"title":"MTG API","version":"1.0.0","description":"The complete Magic: The Gathering card database as an API — every card ever printed, backed by Scryfall. Look up a card by name (exact, with automatic fuzzy fallback, e.g. \"Black Lotus\" → mana cost {0}, type, oracle text, rarity, set, format legalities and current market prices), search the entire pool with Scryfall's powerful query syntax (e.g. q=goblin, q=c:red type:creature cmc<=3, ordered by name/cmc/usd/rarity), pull a random card with an optional filter, browse all 1,000+ sets, and list every mana/cost symbol with its glyph. Each card carries colors, color identity, keywords, power/toughness/loyalty, collector number, artist, release date, high-resolution image and prices in USD/EUR/TIX. Ideal for deckbuilders, collection trackers, price-checkers, Discord bots, judges and MTG content tools.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/mtg-api","description":"oanor gateway"}],"tags":[{"name":"Cards"},{"name":"Sets"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/card":{"get":{"operationId":"get_v1_card","tags":["Cards"],"summary":"A card by name (exact, then fuzzy)","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Card name, e.g. Black Lotus (exact match preferred, fuzzy fallback)","schema":{"type":"string"},"example":"Black Lotus"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Cards"],"summary":"A random card (optional Scryfall filter)","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Optional Scryfall filter, e.g. t:land","schema":{"type":"string"},"example":"t:land"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Cards"],"summary":"Search the card pool with Scryfall query syntax","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Scryfall query, e.g. goblin or c:red type:creature cmc<=3","schema":{"type":"string"},"example":"goblin"},{"name":"order","in":"query","required":false,"description":"name|released|set|rarity|color|usd|cmc|power|toughness|edhrec (default name)","schema":{"type":"string"},"example":"cmc"},{"name":"page","in":"query","required":false,"description":"Result page (1-100, default 1)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/sets":{"get":{"operationId":"get_v1_sets","tags":["Sets"],"summary":"Every MTG set with paging","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-1000, default 50)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/symbology":{"get":{"operationId":"get_v1_symbology","tags":["Reference"],"summary":"Mana & cost symbols","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK"},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":690,"monthly_call_quota":50000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1990,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4990,"monthly_call_quota":1300000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/mtg-api"}