Control Panel v4 - Shared collection - Bot manual

Sharing collection also know as Shared inventory is a feature that lets you combine purchasing power from all your bots into each individual bot. Each group will sum up their buy quantity for each card and allow a single bot in that group purchase up to that many. This is a great feature for bots owners that have multiple bots and want to limit the amount of a certain card purchased. You can find this feature on the online control panel Here.

Step 1: Group your bots that you want to share collection.

The grouping of the bots is really easy just slide the bots over into a new group you wish to have share inventory.  You will then have to set the quantity that you wish the group to purchase. 

Step 2: Define the quantity of each card you wish to purchase. 

This can be done by the use of the collection tab or can be taken a step further and be defined by PersonalPrices.

Here we will setup the quantity by using the collection tab.

In this example bot1, bot2, and bot3 are all grouped in a shared inventory. We set how many mythics, rare, unccommons, and commons each bot will buy. If all these bots had no KTK cards on them then each the chain would only buy a total of:

8 mythics
8 rares
4 uncommons
4 commons

Even though bot 3 has it set to buy 0 Mythics it will buy up to 8 depending on how many bot 1,2, and 3 already have.

Here we will set up the quantity by using PersonalPrices:

Bot 1: JOU;Ajani, Mentor of Heroes;12.215;21.4500;11.722;11.5700;2;1
Bot 2: JOU;Ajani, Mentor of Heroes;12.215;21.4500;11.722;11.5700;1;0
Bot 3: JOU;Ajani, Mentor of Heroes;12.215;21.4500;11.722;11.5700;1;0

In this example Your shared inventory chain would buy a total of 4 Ajani, Mentor of Heroes regular and 1 foil.

In summary: 
Any bot in a grouped shared inventory will buy up to the total sum of each bots buying quantity in the group.

Continue reading the bot manual...

Control Panel v4 - WebShop API - Bot Manual

Interested in opening a website to advertise your bot? 

ML Bots WebShop API is a development tool that allows you to set up a pricing website for your customers requests getting set names, card buy/sell prices and quantities held by your bots to display on your website.

Each bot registered with ML Bots has a unique key identifier. This identifier is sent to our API along with your request so we know which bot’s data is desired. We then reply to your request with the data you’ve requested.

If you are not a developer, no problem. ML Bot specialists will gladly assist you to get your website off to the right start. You can contact us on Livechat or email us at staff@mtgolibrary.com

A functioning example of the API in action can be seen at www.decentbot.com.

The following is a php example which makes a call to the API and then displays the data in a simple HTML table.

<?php

/*** MTGO Library API Example ***/

// build the url to the api

$url = 'https://www.mtgolibrary.com/web_shops/inventory?' .  http_build_query(array(

    'bot' => 'YOUR_BOT_NAME_HERE', // your username

    'key' => 'YOUR_API_KEY_HERE',  // your api key

    'set_name' => 'BNG',           // the set name to download

));

// download the inventory

$inventory = json_decode(file_get_contents($url), true);

// create a table with the cards

?>

<table>

    <thead>

    <tr>

        <th>Card Name</th>

        <th>Set Name</th>

        <th>Rarity</th>

        <th>Bot</th>

        <th>Foil</th>

        <th>Buy Price</th>

        <th>Buy Quantity</th>

        <th>Sell Price</th>

        <th>Sell Quantity</th>

    </tr>

    </thead>

    <tbody>

    <?php foreach ($inventory as $card) { ?>

        <tr>

            <td><?php echo stripslashes(urldecode($card['card_name'])); ?></td>

            <td><?php echo $card['set_name']; ?></td>

            <td><?php echo $card['rarity']; ?></td>

            <td><?php echo urldecode($card['bot']); ?></td>

            <td><?php echo $card['foil'] ? 'foil' : ''; ?></td>

            <td><?php echo $card['buy_price']; ?></td>

            <td><?php echo $card['buy_quantity']; ?></td>

            <td><?php echo $card['sell_price']; ?></td>

            <td><?php echo $card['sell_quantity']; ?></td>

        </tr>

    <?php } ?>

    </tbody>

</table>

Results:

Continue reading the bot manual ...

Control Panel v4 - Collection - Bot Manual

In this section we will go over the collection section on the Online Control Panel there are two options to choose from here:

 “Current Collection” - Allows you to browse your collection for individual cards to see exactly what you have on hand. 

“Collection history“ - Here you will find a daily summary of cards on hand by rarity, these totals are based on you selling price of your .csv uploaded during the day. 

 A: Filter - Specify a date range to search. Also you can search a single bot or the entire family.

 B: Results – A breakdown of your collection on a particular date with the total value. Displaying an overall summary, regulars and foils.

Continue reading the bot manual...

Control Panel v4 - Over Protection Rules - Bot manual

In this section we will go over the Over Protection Rules. These rules can  help protect you from speculators, cherry pickers, and vast market fluctuations by increasing or decreasing your buy and sell price when a large quantity a particular card is bought or sold to your bots. You have variety of options in this sections, we will go over them step by step. You can visit this page Here.

First step is to choose what you want to apply the rule to: you can apply this rule to any of the following rarities listed on the Right.  Keep in mind you can create multiple rules for different rarities. 

Next you need to specify after how many cards are bought or sold the rule will trigger.

Next you will choose whether this rule will only trigger if 4 or more are bought/sold on your chain or all of your bots. 

 Next you will choose the action to take; You can have the bot cancel trade or increase or decrease the price If the quantity has been reached.

 Here you will choose if this rule will increase, decrease, or cancel trade on your chain, single bot, or all your bots. 

The rule will be base on cards bought/sold to  a specific customer or based on cards bought/sold from all customers. 

The Over Selling protection example above would: Refuse trade for a specific customer that bought more than 4 of a Particular mythic from your chain and would cancel trade if they tried to buy  that mythic on any of your bots. 

**NOTE** These rules are only good for a 24 hour period. 

Continue reading the bot manual...

Control Panel v4 - Credits - Bot Manual

On the Credits page you can view, add , or delete a customers credit, you can view this page Here. These credits can also be shared between all your bots or certain bot chains in the "sharing credits" feature. 

 Section A:  “Buddy Name” - Locate a specific buddy name to view their credit. “Having credit” – Filter to show customers that have credit > or < a specific value.

Section B: New Credit button – Use this to give credits to a specific customer if they do not have any.

Section C: “View Trades” – This is a link which will bring you to the trade logs and show you all trades done with this buddy.

Section D:  “Edit” – You can modify credits of a customer using this link. **

** Warning:  Removal of customer’s credit is frowned upon and is against terms of service of WOTC.

Continue reading the bot manual...

Control Panel v4 - Sharing credits - Bot Manual

Sharing Credits allows you to group multiple bots so that your customers credits can be shared across your chain.

Select a bot from the main dropdown that currently is not included in your chain then press the blue button.

The above image shows the current YourBot chain consisting of 3 bots: YourBot, YourBot-1 and YourBot-2. All sharing credits. In the dropdown you chose your newest bot (YourBot-3) to add to this list. By pressing the blue button you will add YourBot-3 to this chain and therefore will proceed to share customer credits with your other bots.

Continue reading the bot manual...

Control Panel v4 - Personal Price List - Bot Manual

 In this section you will find the ability to update your prices on the fly and query your collection from any web browser.

A: Upload a new personal price list:

 Prepare a price file on your computer and upload it to one, or all of your bots quickly and easily.

 Once you prepare your pricing file, locate it on your computer and deliver to one or all of your bots. 

Please note that the price file must be in a specific format. (See Below) 

This is a sample of a price file. Each row is semi-colon separated and consists of a card name, its set, and the prices and quantities you want to use for it.

Here’s a closer look at a row.

A: Set

B: Card Name

C: Regular Sell Price

D: Foil Sell Price

E: Regular Buy Price

F: Foil Buy Price

G: Max Regular Buy Quantity

            H: Max Foil Buy Quantity  

B: Create a personal price list:

Instead of creating a price file on your computer for upload, you can also fill out this form to accomplish the same goal.

            A: Card row containing the card name, buy/sell price for regular and foils and also the desired quantities.

            B: Add Card Price: This button will create a new blank row. Note that the card name auto-populates as you type with all the cards available on Magic Online.

           C: Save Draft: Didn’t finish filling in all the information you wanted? You can save your copy and return to it later or tomorrow. The browser does not require to remain open. You can also navigate to this page on another computer to continue working on your prices.

            D: Deliver Price List: When you’re done and ready, this button will deliver your prices to the bot(s) that you have checked above.

            E: Reset Draft: Clears all fields, removes all rows.

            F: Del: Delete this row. This cannot be undone.

Continue reading the bot manual...

Control Panel v4 - Buy/Sell Consistency - Bot Manual

Buy/sell consistency is a great way to prevent unforeseen price fluctuations. This feature allows you to maintain a certain amount of profit on your cards for x amount of days.  

How it works: 

Buy/sell consistency ensures you make only profitable trades. Your bots won't sell a card cheaper than the price they paid to purchase it. Your bots won't buy a card paying more than the price they sold it.

In this example: 

Selling consistency turned on: Your bot sells a card at 6 tickets for the first 21 days if the actual price goes below 6 tickets then your bot will maintain a 6 Ticket sell price until 21 days are over or the market goes above 6 tickets.

Buying consistency turned on: Your bot buys a card for 6 tickets it will maintain a 6 ticket buy price for 21 days then if the price went to 7 tickets on the 22nd day your buy price would increase to 6.50. 

Real scenario:

Ashiok, Nightmare Weaver in a 3 month period had 2 major spikes

On September 6 2014 Buy price spiked to 9.86 then dropped 8.20 sell price on September 10 2014 with out buy protection You would have bought them at the highest price and lost 1.66 per card purchased. 

Then on October 8 2014 the price jumped from 8.18 buy price to an 11.14 buy price on Oct. 11th, then on Oct. 14th the sell price dropped to 7.825 with out buyer consistency you would have lost  3.31 per card purchased during that spike. 

Continue reading the bot manual...