API

What is Wikiprice API?
Wikiprice API is a market-based tool to keep your prices always up to date. The core consists of a custom URL you create that will allow you to retrieve current MTGO card and booster prices. All the URLs you create has to start with 'http://api.mtgowikiprice.com/api/' . You can use these prices to track card movement on your own application or you can use them to provide your ML Bot with better prices to help you move inventory faster.

What does API provide me if I don't own a ML BOT?

  • Up to the minute card prices for any card or booster on Magic Online.
  • Can be freely used on your own website/application to track card history or analyze market movement.
  • 99% uptime, so you always get the latest prices.

WikiPrice API provides additional features for bot owners:

  • Averages the top bots on WikiPrice to find the best buy and sell price for a card.
  • Allows you to specify card sets you wish to download, as well as rarities, and editions.
  • Keeps your prices competitive so you can move inventory fast.
  • Is completely automated, and fully customizable.
Aggregated API and single card API
There are two types of API: aggregated API and single card API.
The aggregated API returns many card prices in a unique call. The returned card prices are in PersonalPrices.txt format to be direcly used on your ML Bots.
The single card API returns instead a json with the details of a single card. The information is richer but you cannot use it directly on your bots - you need to elaborate it using your own applications.
How does the single card Wikiprice API work?
The usage of the single card API is pretty straightforward. You compose the url below choosing the set (in the example M14) and the cardnumber you want (in the example 157). Don't forget to attach your API key. Do a GET call to the api endpoint. Parse the json output using your own applications.
          
http://api.mtgowikiprice.com/api/card/M14/157?&api_key=YOUR_API_KEY
Try it out
How does the aggregated Wikiprice API work?
Important in order to use any of the API features you need a Wikiprice account. Please create one now if you haven't. Creating an account is free and only takes a minute. If you already have an account, please login.

The very first thing you will need is a API link, this will make a call to the wikiprice server requesting specified cards. Below is a quick example of how you can create and customize your link. You are not limited to the 3 options below (Card or Booster, Filters, Rarity) but this is a good example to start.

Card or Booster
Filters
Rarity
        
http://api.mtgowikiprice.com/api/card/price?sets=M14&rarities=C&api_key=YOUR_API_KEY
Try it out

The Basics

Wikiprice API allows you to download real time Magic online cards or booster prices. Please note: All of the below calls are free, if you need any card or booster (outside M14) you will need an Subscription Package.


Look at the output M14;Archangel of Thune;13.756;20.475;10.175;11.99;4;0
Api img 98583620039e576d9294119776b778a159b49918544228b40bc46b97197aa25c

Each line has a specific meaning: Pay attention the numbers on top of the image

  • The card set: The abbreviated set the card is in example: [GTC -> Gatecrash], [RTR -> Return to Ravnica] for a full list, look here.
  • The card Name: The name of the card
  • Average sell price: by default this averages the top 10 selling bots. You can change it to any number you wish using &averageSellBotLimit=X try it out Shadowborn Demon for Average top 5 selling bots and Shadowborn Demon for Average top 15 bots Look at the line at the #3 place notice how it has changed.
  • Average Sell Price FOIL: This is your sell price for the foil version of the card. It is controlled with &averageSellBotLimitFoil=X.
  • Average Buy Price: by default this averages the top 10 buying bots, you can change it to any number you wish using &averageBuyBotLimit=X try it out Shadowborn Demon for Average top 5 buying bots and Shadowborn Demon for Average top 15 bots Look at the line at the #5 place notice how it has changed.
  • Average Buy Price FOIL: This is your buy price for the foil version of the card. It is controlled with &averageBuyBotLimitFoil=X.
  • Regular Buy Quantity: The amount of foil cards your bot will buy: you can control this number with &Quantity = 1 try it out Regular quantity 1
  • Foil Buy Quantity: The amount of foil cards your bot will buy: you can control this number with &foilQuantity = 2 try it out Foil quantity 2
What is a Daily Request (call)?
A call is a single card or booster returned by the API. For example when you run you would of used 15 calls since, there are 15 mythics in M14. Each Subscription Package. gives you a certain amount of calls, you can use within a 24 hour period.

If you're ready to begin, let's get started.

Begin Registration

  Installation Guide (Creating your personal prices file)

Step 1: Create your folder. Completed Step Picture
Create a New Folder on the desktop of the operating system you will be running your bots on. Name this folder API_update.
Step 2: Creating your Personal Price File.

Copy the content of the bat file below. You need to change lines 5 and 6 (set remote_file and set local_file) to put your own API call and the folder where you want to save the output (usually the ML Bot "\prices" folder)

          
echo ------------------------------------------- echo -- DOWNLOAD PersonalPrices_M14_Rares.txt -- echo ------------------------------------------- REM ---- SETTINGS (change the two lines below to fit your needs) ---- set remote_file="http://api.mtgowikiprice.com/api/card/price?sets=M14&rarities=M&averageSellBotLimit=10&averageBuyBotLimit=10&quantityFoil=0&api_key=YOUR_API_KEY&ignoreBots=bot1,bot2,bot3&minimumMargin=0.1&minimumMarginFoil=0.1" set local_file=C:\Program Files (x86)\MTGOLibrary\MTGO Library Bot\prices\PersonalPrices_M14_Rares.txt REM ---- DOWNLOADER (do not modify below this line) ---- wget.exe %remote_file% -O "%local_file%.tmp" for %%i in ("%local_file%.tmp") do set "size=%%~zi" if not defined size set size=0 if %size% gtr 0 ( move "%local_file%.tmp" "%local_file%" ) else ( del "%local_file%.tmp" ) echo -- DOWNLOAD DONE! -- echo -------------------------------------------
You can copy these lines multiple times in the same file if you need to call the API more at once.
Step 3: Saving your Personal Prices file. Completed Step Picture
Once you have created the Personal Prices file in step 3, You have two options:
  • Option 1: Use the copy and paste method.
  • Option 2: Download your personal prices file.
Option 1: Copy & Paste
  • Create a new empty ".txt" document in your API_update folder. Picture Guide
  • Copy and paste the output of the batch file generated in step 3. Picture Guide
Option 2: Direct Download
  • Click the download button.
  • On Chrome: Click on the file downloaded, when the file opens in Notepad click save as and select the location of you API_update folder. Picture Guide
  • On Firefox: Click Save as then select the location of the folder.. Picture Guide
  • On Internet Explorer: Please download Chrome, or Firefox then use the download method.
Continue to Automation.    

  Automation Guide(setting up Task Scheduler)

Now that we have our Updateprices.txt we need to convert it into a .bat file. This is so it can work with Windows Task Scheduler.
In order to do this double click your Updateprices.txt file, then click File->Save as. Next we change the extension from .txt to .bat.

1. Delete the text document version of UpdatePrices we don't need it anymore, keep the windows batch file called (UpdatePrices.bat). Your folder should look like mine. Picture
2. In order to do this we will need something called Wget. You might already have this In Windows->System. If you're not sure you can download wget from our server. You can either get it from Directly from us, or from Download Wget . Place the wget.exe into your API_Update folder.
Step 3: Setting up task scheduler. Settings Conditions Actions Triggers General
Time to setup the scheduled task open your start panel and type in Task Scheduler. If nothing comes up you can acccess it through the control panel. Start->Control Panel->Adminstrative Tools->Task Scheduler. Let's create a New Task
Configure your settings to match mine(click on the buttons to open the pictures):
General : The name of the task.
Triggers : This is where you set how often the task runs, I recommend every 1-2 hours.
Actions: This is where we configure the location and parameters of the task.
Conditions: This is where we configure the location and parameters of the task.
Settings: Additional parameters of the task:

Step 4: Run task, check output. Completed Step Picture
Your task should be configured to run every couple of hours. But let's run it now to be sure it works. Open Task Scheduler find the name of whatever you called your Task [MTGO PRICE SYNC], right click on the task and click run.
Now let's check our MTGO Library/Prices folder, it should contain two new text documents. PersonalPrices_Wikiprice and PersonalPrices_Booster. Open each file and make sure it's not empty: an example of the format should be :
JOU;Keranos, God of Storms;6.955;10.824;6.322;7.023;4;0

If your format looks like mine, you're done your prices are now completed automated. Congratulations

API Small

$19.95

/ month
  • 1000 Daily Requests
  • (Standard M+R x2 Daily)

API Medium

$29.95

/ month
  • 5000 Daily Requests
  • (Standard M+R x6 Daily)

API Large

$49.95

/ month
  • 25000 Daily Requests
  • (Extended M+R x12 Daily)

API Extra

$69.95

/ month
  • 75000 Daily Requests
  • (Extended M+R x18 Daily)

API Pro

$99.95

/ month
  • 125000 Daily Requests
  • (Classic M+R x12 Daily)

API Ultimate

$199.95

/ month
  • 400000 Daily Requests
  • (Everything all the time)