MTGstand provides a REST-like API. All requests are served over HTTPS and our API use UTF-8 character encoding for all responses.

Contact us with your MTGstand username and details about your API usage. We will provide your individual authentication token to access our API.


Every request is executed with the following url:

https://www.mtgstand.com/api/YourAccessToken/category/value/currency



You have access to the following values:

name
Card set
setcode
Specific scryfall set code
color_identity
The color identity of a card is specified by all mana symbols that appear in its casting cost, color indicator, and rules text.
PriceCURRENCY
Card value / price in the selected / exchangeable currency
PriceFoilCURRENCY
Foil card value / price in the selected / exchangeable currency
monthlyTrend
Monthly price trend / changes in %
monthlyFoilTrend
Monthly foil price trend / changes in %
scryfallID
Specific scryfall ID
url
MTGstand card url


If you are interested in using our API, you need your personal access token. As a registered MTGstand user you just contact us with your username and details about your API usage (website url, app name, project description, ...) and we will respond with your personal access token - after that initial step you are ready to use the API.


The category determines the purpose of your call. You can insert the following categories:

name
Search by card name
set
Search by full set name
setcode
Search by set code
scryfallid
Search by Scryfall ID
top10
The category
top10
limits the value to set codes. The output are the Top 10 cards with the highest prices of the selected set. You can choose any number after "top" to extend the ranked output (e.g.
top5
,
top20
,
top30
, ...)

  • Example call:
    https://www.mtgstand.com/api/YourAccessToken/top3/MIR/EUR


    JSON result:
    
            
topfoil10
The category
topfoil10
limits the value to set codes. The output are the Top 10 cards with the highest foil prices of the selected set. You can choose any number after "topfoil" to extend the ranked output (e.g.
topfoil5
,
topfoil20
,
topfoil30
, ...)

  • Example call:
    https://www.mtgstand.com/api/YourAccessToken/topfoil3/M12/USD


    JSON result:
    
            
setaverage
The category
setaverage
limits the value to set codes. The output are non-foil and foil average prices of each rarity of the selected set. You will get the following unique output values:

  • common_average_price
  • common_average_foil_price
  • uncommon_average_price
  • uncommon_average_foil_price
  • rare_average_price
  • rare_average_foil_price
  • mythic_average_price
  • mythic_average_foil_price

  • Example call:
    https://www.mtgstand.com/api/YourAccessToken/setaverage/M20/USD


    JSON result:
    
             
getseller
The category
getseller
limits the value to scryfall id or cardname + setcode (separated with | ). The output are all non-foil and foil cards that are currently for sale ordered by each seller. You will get the following unique output values:

  • username
  • user_country
  • quantity
  • condition
  • language
  • SellingPriceCURRENCY (if the offered card is a non-foil card)
  • SellingPriceFoilCURRENCY (if the offered card is a foil card)
  • user_market_stand_url

  • Example call ( d36e87ca-71e1-43d2-841f-b01a58fe27f0 is the scryfall id for our example card Austere Command from Double Masters ):
    https://www.mtgstand.com/api/YourAccessToken/getseller/d36e87ca-71e1-43d2-841f-b01a58fe27f0/EUR


    JSON result:
    
            

  • Example call (example card "Barge in" from Throne of Eldraine):
    https://www.mtgstand.com/api/YourAccessToken/getseller/Barge In|ELD/EUR


    JSON result:
    
            
getbuyer
The category
getbuyer
limits the value to scryfall id. The output are all non-foil and foil cards that are currently on a buylist by other users ordered by each potential buyer. You will get the following unique output values:

  • username
  • user_country
  • quantity
  • condition
  • language
  • BuyingPriceCURRENCY (if the searched card is a non-foil card)
  • BuyingPriceFoilCURRENCY (if the searched card is a foil card)
  • user_market_stand_url

  • Example call ( ff37b863-f8c4-4584-8cc2-ac0e096e583f is the scryfall id for our example card Bazaar of Baghdad from Arabian Nights ):
    https://www.mtgstand.com/api/YourAccessToken/getseller/ff37b863-f8c4-4584-8cc2-ac0e096e583f/EUR


    JSON result:
    
            

  • Example call (example card "Barge in" from Throne of Eldraine):
    https://www.mtgstand.com/api/YourAccessToken/getbuyer/Barge In|ELD/EUR


    JSON result:
    
            


The value defines what card name, set, set code or scryfall ID you are looking for. We are doing some example API calls to give you an idea how it works:

  • Example call:
    https://www.mtgstand.com/api/YourAccessToken/name/Garruk, Primal Hunter/USD


    JSON result:
    
            


You can switch between different currencies for non-foil and foil card prices. The default value is
EUR
. Possible values:

  • EUR
    - Euro
  • USD
    - US Dollar
  • JPY
    - Yen
  • GBP
    - Pound Sterling (UK)
  • RUB
    - Russian Ruble
  • AUD
    - Australian Dollar
  • BRL
    - Brazilian Real
  • CAD
    - Canadian Dollar
  • CHF
    - Swiss Franc
  • NZD
    - New Zealand Dollar
  • SGD
    - Singapore Dollar
  • ZAR
    - South African Rand
  • DKK
    - Danish Krone
  • MYR
    - Malaysian Ringgit
  • PLN
    - Zloty (Poland)
  • SEK
    - Swedish Krona
  • TRY
    - Turkish Lira
  • INR
    - Indian Rupee (Poland)


  • Example call:
    https://www.mtgstand.com/api/YourAccessToken/name/Sliver Legion/GBP


    JSON result:
    
               


    • If you are missing any API functionality that you would need to connect your service or application to MTGstand, please contact us and tell us more about your project. We will develope an individual extension for your requirements.

    • Submitting excessive requests to the server may result in a temporary IP block. Continuing to overload the API after this point may result in a permanent ban of your IP address.


    This website uses cookies to ensure you get the best experience on our website. By using our services, you agree that we use cookies. Learn more.