{"openapi":"3.1.0","info":{"title":"Yu-Gi-Oh! API","version":"1.0.0","description":"The Yu-Gi-Oh! Trading Card Game as an API, powered by YGOPRODeck. Look up any card by name or passcode id and get its full detail — type and frame, ATK/DEF, level or rank or link rating, attribute and race/monster type, pendulum scale, complete effect/lore text, every set printing with its set code and rarity, current market prices (Cardmarket, TCGplayer, eBay, Amazon), high-resolution artwork, and TCG/OCG/GOAT banlist status. Fuzzy-search the entire database with filters (type, attribute, race, level, ATK, archetype) and pagination, browse every TCG set and every archetype, or pull a random card. Perfect for deck builders, collection trackers, card-price tools, Discord bots and fan sites. No accounts, no upstream key.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/yugioh-api","description":"oanor gateway"}],"tags":[{"name":"Cards"},{"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 single card by name or id","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Card name","schema":{"type":"string"},"example":"Dark Magician"},{"name":"id","in":"query","required":false,"description":"Passcode id","schema":{"type":"string"},"example":"46986414"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"card":{"id":46986414,"atk":2500,"def":2100,"name":"Dark Magician","race":"Spellcaster","sets":[{"code":"CT13-EN003","name":"2016 Mega-Tins","price":"6.97","rarity":"Ultra Rare"},{"code":"CT14-EN001","name":"2017 Mega-Tins","price":"9.66","rarity":"Secret Rare"},{"code":"25TH-EN001","name":"Battle of Chaos","price":"0.00","rarity":"Ultra Rare"},{"code":"BPT-001","name":"Booster Pack Collectors Tins 2002","price":"63.01","rarity":"Secret Rare"},{"code":"BPT-007","name":"Collectible Tins 2003","price":"19.08","rarity":"Secret Rare"},{"code":"DB1-EN102","name":"Dark Beginning 1","price":"25.2","rarity":"Ultra Rare"},{"code":"DLG1-EN004","name":"Dark Legends","price":"11.64","rarity":"Rare"},{"code":"DUPO-EN101","name":"Duel Power","price":"3.52","rarity":"Ultra Rare"},{"code":"DTP1-EN002","name":"Duel Terminal - Preview Wave 1","price":"0.00","rarity":"Duel Terminal Normal Parallel Rare"},{"code":"DTP1-EN002","name":"Duel Terminal - Preview Wave 2","price":"0.00","rarity":"Duel Terminal Rare Parallel Rare"},{"code":"DT01-EN002","name":"Duel Terminal 1","price":"14.78","rarity":"Duel Terminal Rare Parallel Rare"},{"code":"DL11-EN001","name":"Duelist League 2 participation cards","price":"70.6","rarity":"Rare"},{"code":"DPBC-EN008","name":"Duelist Pack: Battle City","price":"3.7","rarity":"Super Rare"},{"code":"DPYG-EN001","name":"Duelist Pack: Yugi","price":"2.24","rarity":"Rare"},{"code":"DUSA-EN100","name":"Duelist Saga","price":"11.34","rarity":"Ultra Rare"},{"code":"FL1-EN002","name":"Forbidden Legacy","price":"16.26","rarity":"Secret Rare"},{"code":"GFTP-EN128","name":"Ghosts From the Past","price":"742","rarity":"Ghost Rare"},{"code":"2021-EN001","name":"KC Grand Tournament 2021 prize card","price":"0.00","rarity":"Extra Secret Rare"},{"code":"LOB-005","name":"Legend of Blue Eyes White Dragon","price":"46.71","rarity":"Ultra Rare"},{"code":"LOB-E003","name":"Legend of Blue Eyes White Dragon","price":"53.66","rarity":"Ultra Rare"},{"code":"LOB-EN005","name":"Legend of Blue Eyes White Dragon","price":"49.41","rarity":"Ultra Rare"},{"code":"LC01-EN005","name":"Legendary Collection","price":"4.43","rarity":"Ultra Rare"},{"code":"LCYW-EN001","name":"Legendary Collection 3: Yugi's World Mega Pack","price":"10.84","rarity":"Secret Rare"},{"code":"LDK2-ENY10","name":"Legendary Decks II","price":"2.35","rarity":"Common"},{"code":"LEDD-ENA01","name":"Legendary Dragon Decks","price":"1.72","rarity":"Common"},{"code":"MAGO-EN002","name":"Maximum Gold","price":"11.91","rarity":"Premium Gold Rare"},{"code":"RA03-EN080","name":"Quarter Century Bonanza","price":"0","rarity":"Platinum Secret Rare"},{"code":"RA03-EN080","name":"Quarter Century Bonanza","price":"0","rarity":"Quarter Century Secret Rare"},{"code":"RA04-EN001","name":"Quarter Century Stampede","price":"0","rarity":"Quarter Century Secret Rare"},{"code":"RA04-EN106","name":"Quarter Century Stampede","price":"0","rarity":"Platinum Secret Rare"},{"code":"RA04-EN106","name":"Quarter Century Stampede","price":"0","rarity":"Quarter Century Secret Rare"},{"code":"RA05-EN083","name":"Rarity Collection 5","price":"0","rarity":"Starlight Rare"},{"code":"RA05-EN083","name":"Rarity Collection 5","price":"0","rarity":"Ultra Rare"},{"code":"RP01-EN003","name":"Retro Pack","price":"503.21","rarity":"Ultra Rare"},{"code":"JUMP-EN049","name":"Shonen Jump Vol. 9, Issue 4 promotional card","price":"129.27","rarity":"Ultra Rare"},{"code":"SS01-ENA01","name":"Speed Duel Starter Decks: Destiny Masters","price":"1.61","rarity":"Common"},{"code":"SS04-ENA01","name":"Speed Duel Starter Decks: Match of the Millennium","price":"2","rarity":"Common"},{"code":"STP1-EN001","name":"Speed Duel Tournament Pack 1","price":"22.78","rarity":"Ultra Rare"},{"code":"SBCB-EN001","name":"Speed Duel: Battle City Box","price":"1.55","rarity":"Common"},{"code":"SBCB-EN001","name":"Speed Duel: Battle City Box","price":"6.53","rarity":"Secret Rare"},{"code":"SDY-006","name":"Starter Deck: Yugi","price":"9.96","rarity":"Ultra Rare"},{"code":"SDY-E005","name":"Starter Deck: Yugi","price":"24.46","rarity":"Ultra Rare"},{"code":"SYE-001","name":"Starter Deck: Yugi Evolution","price":"6.37","rarity":"Super Rare"},{"code":"YSYR-EN001","name":"Starter Deck: Yugi Reloaded","price":"2.34","rarity":"Common"},{"code":"YSYR-EN001","name":"Starter Deck: Yugi Reloaded","price":"12.75","rarity":"Ultimate Rare"},{"code":"SD6-EN003","name":"Structure Deck: Spellcaster's Judgment","price":"2.26","rarity":"Common"},{"code":"SDMY-EN010","name":"Structure Deck: Yugi Muto","price":"1.8","rarity":"Common"},{"code":"JMPS-EN003","name":"WSJ Jump Pack Fall 2016 promotional card","price":"171.83","rarity":"Ultra Rare"},{"code":"DDS-002","name":"Yu-Gi-Oh! Dark Duel Stories promotional cards","price":"797.61","rarity":"Prismatic Secret Rare"},{"code":"PCY-004","name":"Yu-Gi-Oh! Power of Chaos: Yugi the Destiny promotional cards","price":"82.23","rarity":"Prismatic Secret Rare"},{"code":"PCY-E004","name":"Yu-Gi-Oh! Power of Chaos: Yugi the Destiny promotional cards","price":"74.4","rarity":"Prismatic Secret Rare"},{"code":"MVP1-EN054","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack","price":"3.3","rarity":"Ultra Rare"},{"code":"MVP1-ENS54","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack Secret Edition","price":"19.53","rarity":"Secret Rare"},{"code":"MVP1-ENSV3","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack Secret Edition","price":"4.19","rarity":"Ultra Rare"},{"code":"MVP1-ENSE3","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack Special Edition","price":"4.11","rarity":"Ultra Rare"},{"code":"MVP1-ENG54","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack: Gold Edition","price":"5.83","rarity":"Gold Rare"},{"code":"MVP1-ENGV3","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack: Gold Edition","price":"8.39","rarity":"Gold Secret Rare"},{"code":"YGLD-ENA03","name":"Yugi's Legendary Decks","price":"1.7","rarity":"Common"},{"code":"YGLD-ENC09","name":"Yugi's Legendary Decks","price":"4.04","rarity":"Ultra Rare"}],"type":"Normal Monster","level":7,"images":[{"id":46986414,"url":"https://images.ygoprodeck.com/images/cards/46986414.jpg","small":"https://images.ygoprodeck.com/images/cards_small/46986414.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/46986414.jpg"}],"prices":{"ebay":"0.99","amazon":"14.45","tcgplayer":"0.24","cardmarket":"0.02"},"archetype":"Dark Magician","attribute":"DARK","frame_type":"normal","description":"''The ultimate wizard in terms of attack and defense.''"}},"meta":{"timestamp":"2026-06-01T00:04:05.940Z","request_id":"d3d19935-c8f8-490c-bc3f-61d448799463"},"status":"ok","message":"Card retrieved","success":true}}}},"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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"card":{"id":93078761,"name":"Diced Dice","race":"Quick-Play","sets":[{"code":"MP21-EN146","name":"2021 Tin of Ancient Battles","price":"0.83","rarity":"Common"},{"code":"ROTD-EN067","name":"Rise of the Duelist","price":"1.42","rarity":"Common"}],"type":"Spell Card","images":[{"id":93078761,"url":"https://images.ygoprodeck.com/images/cards/93078761.jpg","small":"https://images.ygoprodeck.com/images/cards_small/93078761.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/93078761.jpg"}],"prices":{"ebay":"0.99","amazon":"0.25","tcgplayer":"0.10","cardmarket":"0.04"},"frame_type":"spell","description":"Roll a six-sided die, and if you roll a 1 or 6, add 1 card from your Deck to your hand that requires a die roll. If you roll a number other than 1 or 6, roll it again, and apply the appropriate effect.\r\n● 1 or 6: Return this card to the hand.\r\n● 2, 3, 4, or 5: Place this card on top of the Deck.\r\nYou can only activate 1 \"Diced Dice\" per turn."}},"meta":{"timestamp":"2026-06-01T00:04:06.540Z","request_id":"e3dccdf1-bc95-48e1-b83a-498aacba6db0"},"status":"ok","message":"Random card retrieved","success":true}}}},"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":"Fuzzy search + filters","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name contains","schema":{"type":"string"},"example":"Blue-Eyes"},{"name":"type","in":"query","required":false,"description":"Card type","schema":{"type":"string"},"example":"Effect Monster"},{"name":"attribute","in":"query","required":false,"description":"DARK|LIGHT|EARTH|WATER|FIRE|WIND|DIVINE","schema":{"type":"string"},"example":"LIGHT"},{"name":"race","in":"query","required":false,"description":"Race / monster type","schema":{"type":"string"},"example":"Dragon"},{"name":"level","in":"query","required":false,"description":"Level/Rank 0-13","schema":{"type":"string"},"example":"8"},{"name":"archetype","in":"query","required":false,"description":"Archetype","schema":{"type":"string"},"example":"Blue-Eyes"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"cards":[{"id":64202399,"atk":2500,"def":2500,"name":"Blue-Eyes Abyss Dragon","race":"Dragon","sets":[{"code":"RA01-EN016","name":"25th Anniversary Rarity Collection","price":"0","rarity":"Super Rare"},{"code":"RA01-EN016","name":"25th Anniversary Rarity Collection","price":"0","rarity":"Ultra Rare"},{"code":"LDS2-EN015","name":"Legendary Duelists: Season 2","price":"27.36","rarity":"Secret Rare"},{"code":"MAMA-EN056","name":"Magnificent Mavens","price":"0","rarity":"Ultra Rare"},{"code":"SDWD-EN007","name":"Structure Deck: Blue-Eyes White Destiny","price":"0","rarity":"Common"}],"type":"Effect Monster","level":8,"images":[{"id":64202399,"url":"https://images.ygoprodeck.com/images/cards/64202399.jpg","small":"https://images.ygoprodeck.com/images/cards_small/64202399.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/64202399.jpg"}],"prices":{"ebay":"1.25","amazon":"0.50","tcgplayer":"0.09","cardmarket":"0.09"},"archetype":"Blue-Eyes","attribute":"LIGHT","frame_type":"effect","description":"If this card is Special Summoned: You can add 1 Ritual Spell or 1 \"Polymerization\" from your Deck to your hand. During your End Phase: You can add 1 Level 8 or higher Dragon monster from your Deck to your hand. You can banish this card from your GY; all Level 8 or higher Dragon monsters you control gain 1000 ATK. You can only use each effect of \"Blue-Eyes Abyss Dragon\" once per turn, and can only activate them while \"Blue-Eyes White Dragon\" is on your field or in your GY."},{"id":38517737,"atk":3000,"def":2500,"name":"Blue-Eyes Alternative White Dragon","race":"Dragon","sets":[{"code":"RA02-EN010","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Collector's Rare"},{"code":"RA02-EN010","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Platinum Secret Rare"},{"code":"RA02-EN010","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Quarter Century Secret Rare"},{"code":"RA02-EN010","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Secret Rare"},{"code":"RA02-EN010","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Super Rare"},{"code":"RA02-EN010","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Ultimate Rare"},{"code":"RA02-EN010","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Ultra Rare"},{"code":"SBPR-EN003","name":"Blue-Eyes Alternative White Dragon Sweepstakes","price":"0","rarity":"Secret Rare"},{"code":"GFTP-EN129","name":"Ghosts From the Past","price":"0","rarity":"Ghost Rare"},{"code":"LDS2-EN008","name":"Legendary Duelists: Season 2","price":"0","rarity":"Ultra Rare"},{"code":"SDWD-EN005","name":"Structure Deck: Blue-Eyes White Destiny","price":"0","rarity":"Common"},{"code":"MVP1-EN046","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack","price":"8.04","rarity":"Ultra Rare"},{"code":"MVP1-ENS46","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack Secret Edition","price":"14.23","rarity":"Secret Rare"},{"code":"MVP1-ENG46","name":"Yu-Gi-Oh! The Dark Side of Dimensions Movie Pack: Gold Edition","price":"8.77","rarity":"Gold Rare"}],"type":"Effect Monster","level":8,"images":[{"id":38517737,"url":"https://images.ygoprodeck.com/images/cards/38517737.jpg","small":"https://images.ygoprodeck.com/images/cards_small/38517737.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/38517737.jpg"}],"prices":{"ebay":"14.99","amazon":"7.33","tcgplayer":"0.16","cardmarket":"0.02"},"archetype":"Blue-Eyes","attribute":"LIGHT","frame_type":"effect","description":"Cannot be Normal Summoned/Set. Must first be Special Summoned (from your hand) by revealing \"Blue-Eyes White Dragon\" in your hand. You can only Special Summon \"Blue-Eyes Alternative White Dragon\" once per turn this way. This card's name becomes \"Blue-Eyes White Dragon\" while it is on the field or in the Graveyard. Once per turn: You can target 1 monster your opponent controls; destroy it. This card cannot attack the turn this effect is activated."},{"id":30576089,"atk":3000,"def":0,"name":"Blue-Eyes Jet Dragon","race":"Dragon","sets":[{"code":"RA02-EN017","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Collector's Rare"},{"code":"RA02-EN017","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Platinum Secret Rare"},{"code":"RA02-EN017","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Quarter Century Secret Rare"},{"code":"RA02-EN017","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Secret Rare"},{"code":"RA02-EN017","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Super Rare"},{"code":"RA02-EN017","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Ultimate Rare"},{"code":"RA02-EN017","name":"25th Anniversary Rarity Collection II","price":"0","rarity":"Ultra Rare"},{"code":"MP23-EN004","name":"25th Anniversary Tin: Dueling Heroes Mega Pack","price":"0","rarity":"Prismatic Secret Rare"},{"code":"BACH-EN004","name":"Battle of Chaos","price":"0","rarity":"Secret Rare"},{"code":"BACH-EN004","name":"Battle of Chaos","price":"0","rarity":"Starlight Rare"},{"code":"SDWD-EN006","name":"Structure Deck: Blue-Eyes White Destiny","price":"0","rarity":"Common"}],"type":"Effect Monster","level":8,"images":[{"id":30576089,"url":"https://images.ygoprodeck.com/images/cards/30576089.jpg","small":"https://images.ygoprodeck.com/images/cards_small/30576089.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/30576089.jpg"}],"prices":{"ebay":"6.40","amazon":"109.99","tcgplayer":"0.16","cardmarket":"0.02"},"archetype":"Blue-Eyes","attribute":"LIGHT","frame_type":"effect","description":"Other cards you control cannot be destroyed by your opponent's card effects. You can only use each of the following effects of \"Blue-Eyes Jet Dragon\" once per turn, and can only activate them while \"Blue-Eyes White Dragon\" is on your field or in your GY. If a card(s) on the field is destroyed by battle or card effect: You can Special Summon this card from the GY (if it was there when the card was destroyed) or hand (even if not). At the start of the Damage Step, if this card battles: You can target 1 card your opponent controls; return it to the hand."},{"id":57043986,"atk":2500,"def":2000,"name":"Blue-Eyes Solid Dragon","race":"Dragon","sets":[{"code":"LDS2-EN014","name":"Legendary Duelists: Season 2","price":"0","rarity":"Ultra Rare"},{"code":"LED3-EN002","name":"Legendary Duelists: White Dragon Abyss","price":"7.46","rarity":"Ultra Rare"}],"type":"Effect Monster","level":8,"images":[{"id":57043986,"url":"https://images.ygoprodeck.com/images/cards/57043986.jpg","small":"https://images.ygoprodeck.com/images/cards_small/57043986.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/57043986.jpg"}],"prices":{"ebay":"3.57","amazon":"21.98","tcgplayer":"1.30","cardmarket":"1.54"},"archetype":"Blue-Eyes","attribute":"LIGHT","frame_type":"effect","description":"If this card is Normal or Special Summoned: You can target 1 face-up monster your opponent controls; negate its effects. When your opponent activates a card or effect (Quick Effect): You can shuffle this card from the field into the Deck, and if you do, Special Summon 1 \"Blue-Eyes White Dragon\" from your Deck. You can only use each effect of \"Blue-Eyes Solid Dragon\" once per turn."},{"id":30397786,"atk":3000,"def":2500,"name":"Blue-Eyes White Dragon, the White Phantom Beast","race":"Dragon","sets":[],"type":"Effect Monster","level":8,"images":[{"id":30397786,"url":"https://images.ygoprodeck.com/images/cards/30397786.jpg","small":"https://images.ygoprodeck.com/images/cards_small/30397786.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/30397786.jpg"}],"prices":{"ebay":"0.00","amazon":"0.00","tcgplayer":"0.00","cardmarket":"0.00"},"archetype":"Blue-Eyes","attribute":"LIGHT","frame_type":"effect","description":"When a card or effect is activated that targets this card on the field (Quick Effect): You can discard 1 card; negate that effect. You can only use each of the following effects of \"Blue-Eyes White Dragon, the White Phantom Beast\" once per turn. When this card is added from the Deck to your hand, or your monster is destroyed by battle: You can reveal this card in your hand; Special Summon it. If this card is Special Summoned from the hand or Deck: You can destroy all monsters your opponent controls, also you cannot attack directly for the rest of this turn, except with \"Blue-Eyes\" monsters."},{"id":54475145,"atk":3000,"def":2500,"name":"Heart of the Blue-Eyes","race":"Dragon","sets":[{"code":"MP25-EN013","name":"2025 Mega-Pack Tin","price":"0","rarity":"Starlight Rare"},{"code":"ROTA-EN004","name":"Rage of the Abyss","price":"0","rarity":"Quarter Century Secret Rare"},{"code":"ROTA-EN004","name":"Rage of the Abyss","price":"0","rarity":"Secret Rare"}],"type":"Effect Monster","level":8,"images":[{"id":54475145,"url":"https://images.ygoprodeck.com/images/cards/54475145.jpg","small":"https://images.ygoprodeck.com/images/cards_small/54475145.jpg","cropped":"https://images.ygoprodeck.com/images/cards_cropped/54475145.jpg"}],"prices":{"ebay":"0.00","amazon":"0.00","tcgplayer":"2.78","cardmarket":"2.15"},"archetype":"Blue-Eyes","attribute":"LIGHT","frame_type":"effect","description":"(This card is always treated as a \"Millennium\" card.)\r\nControl of this card cannot switch. You can discard this card; add 1 \"Millennium Ankh\" from your Deck to your hand. You can only use this effect of \"Heart of the Blue-Eyes\" once per turn. If this card is in your GY, and you have successfully activated \"Millennium Ankh\" this Duel, and your opponent Normal or Special Summons a monster(s) that is Level 8 or higher, or has 3000 or more ATK: You can send that monster to the GY, and if you do, Special Summon this card. You can only use this effect of \"Heart of the Blue-Eyes\" once per Duel."}],"count":6,"total":6,"offset":0},"meta":{"timestamp":"2026-06-01T00:04:06.829Z","request_id":"3548cc96-f63a-4a86-83ed-9e710baf5abb"},"status":"ok","message":"Search completed","success":true}}}},"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/archetypes":{"get":{"operationId":"get_v1_archetypes","tags":["Reference"],"summary":"All archetypes","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name contains","schema":{"type":"string"},"example":"Dragon"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":19,"archetypes":["-Eyes Dragon","Albaz Dragon","Ancient Fairy Dragon","Armed Dragon","Curse of Dragon","Cyber Dragon","Divine Dragon","Dragon Mech","Dragon Ruler","Dragonmaid","Gem Dragon","Guardragon","Horus the Black Flame Dragon","Light and Darkness Dragon","Paladins of Dragons","Pendulum Dragon","Rose Dragon","Tenpai Dragon","Thunder Dragon"]},"meta":{"timestamp":"2026-06-01T00:04:06.920Z","request_id":"2b5ff08e-2e1c-4345-adbe-9a483e22c9be"},"status":"ok","message":"Archetypes retrieved","success":true}}}},"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":["Reference"],"summary":"All TCG sets","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Set name contains","schema":{"type":"string"},"example":"Metal Raiders"},{"name":"limit","in":"query","required":false,"description":"Max results","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sets":[{"code":"MRD","date":"2002-06-26","name":"Metal Raiders","cards":432}],"count":1,"total":1},"meta":{"timestamp":"2026-06-01T00:04:07.107Z","request_id":"6541f7f6-319e-452f-8bde-6d7e16d01c36"},"status":"ok","message":"Sets retrieved","success":true}}}},"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":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Yu-Gi-Oh! Trading Card Game database. /v1/card?name=Dark Magician or id=46986414 = a single card (stats, effect, set printings, rarities, prices, artwork, banlist status); /v1/search?q=Blue-Eyes&type=&race=&attribute=DARK&level=&archetype=&limit=&offset= = fuzzy search with filters; /v1/sets = every TCG set; /v1/archetypes = every archetype; /v1/random = a random card. Data from YGOPRODeck. For the Magic: The Gathering card game use the MTG API instead.","source":"YGOPRODeck (db.ygoprodeck.com)","endpoints":["/v1/card","/v1/search","/v1/sets","/v1/archetypes","/v1/random","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:07.180Z","request_id":"0ac61ac4-0bbc-4f93-a091-ebfd7f358041"},"status":"ok","message":"Meta retrieved","success":true}}}},"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":3200,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":450,"monthly_call_quota":38000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1390,"monthly_call_quota":195000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3890,"monthly_call_quota":980000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/yugioh-api"}