BETA

API

MTG Drain espone una piccola API pubblica in sola lettura, in beta: nessuna garanzia di stabilità, gli endpoint possono cambiare senza preavviso. I dati delle carte restano sempre gratuiti, in linea con i ToS di Scryfall.

Base URL

https://mtgdrain.com/api/v1

Limite di richieste

60 richieste al minuto per IP. Le risposte sono JSON.

Endpoint pubblici (sola lettura)

GET /cards Ricerca e lista carte (paginata)
GET /cards/{id} Dettaglio di una carta
GET /cards/{id}/price-history Storico prezzi di una carta
GET /cards/{id}/condition-prices Prezzi per condizione e lingua (CardTrader)
GET /cards/{id}/condition-price-history Storico prezzi per condizione
GET /sets Elenco dei set
GET /sets/{code} Dettaglio di un set
GET /sets/{code}/cards Carte di un set
GET /formats Elenco dei formati di gioco
GET /formats/{slug} Dettaglio di un formato
GET /rules/chapters Capitoli delle Comprehensive Rules
GET /rules/search?q={query} Ricerca nelle regole
GET /rules/{section} Singola sezione delle regole
GET /decks/featured Mazzi precostruiti ufficiali in evidenza
GET /decks/featured/{id} Dettaglio di un mazzo in evidenza
GET /decks/featured/{id}/export Export testuale di un mazzo in evidenza
GET /decks/shared/{token} Mazzo condiviso tramite token pubblico
GET /tournaments/discover Tornei pubblici aperti alle iscrizioni

Attribuzione obbligatoria

Se usi questi dati devi citare le fonti: i dati e le immagini delle carte provengono da Scryfall e MTGJSON. MTG Drain è Unofficial Fan Content — Magic: The Gathering è proprietà di Wizards of the Coast.

Endpoint autenticati

Tutti gli altri endpoint (collezione, mazzi, partite, chat…) richiedono un token e sono riservati alle app ufficiali di MTG Drain: non sono documentati né supportati per uso di terzi.