[StellarBot](https://stellarbot.top) is a free and [open source](https://github.com/ety001/stellar-bot) making market robot.

This tutorial will guide you through using this robot.

## Tutorial Start
**1.Open your stellar wallet and get your privatey key.**

![](https://steemitimages.com/DQme9xqh9UqYms6yvENKhbY9D8hBRna8YgP5WNT1vqwFCK6/image.png)

**2.Copy your private key and add it into your StellarBot config page (**ATTENTION:**: the robot won't send your private key to anywhere and anybody but save it in your browser.)**

![1.gif](https://steemitimages.com/DQmXQHFgyZMdnKviiYxQE6gmYh1RTwBJiZADRjUyt56nA45/1.gif)

When you see the public key and XLM balance, it means your configuration is successful.

**3.Add trustlines and assets which you 'll use to trade.**

![2.gif](https://steemitimages.com/DQmXe95PBdsZzM7oLy8xeiCQG8jzQBYLZoRTre15DbseGuQ/2.gif)

**4.Edit assets' amount you can hold**

![3.gif](https://steemitimages.com/DQmXcuusN7KeonS6dLroXm4SCRc8PxEZYMSXyq6hGa5ucgc/3.gif)

**5.Remove the trustline.(*Please empty the asset on the trustline and then remove the it*)**

![4.gif](https://steemitimages.com/DQmaU3fz5aQRJEd6CGaTDhDnf5bDPfALJYATNKuR6CbMMLd/4.gif)

**6.Add exchange pair. The robot will only work if the exchange pair is added.**

![5.gif](https://steemitimages.com/DQmW7h5csjntPex1CkdVNEig9S83d7UfKAHXYGdYoHeXT3c/5.gif)

**7.Config the exchange pair. This step is the most central step and the least understandable.**

![6.gif](https://steemitimages.com/DQmWLesd6BpxgSZzvkrUz66JZpW87c6AvR8UBqEt2teqQaK/6.gif)

When the robot is running, buying/selling orders will be made according to the parameters which configured in this step.

![123.png](https://steemitimages.com/DQmVYusikb6BzJgkRWsYCyBSasK8J5mARmmYSNXS9hLgxw3/123.png)

For example, in this snapshot I will explain how the robot works on the BTC/CNY pair.

*At this moment, BTC/XLM ask price is 41700 and CNY/XLM bid price is 0.823.*

First the robot will get the BTC/CNY price 40000, buying BTC rate 2% and buying order value 20 XLM.

> buying BTC order price = the highest buying BTC order price 40000 * ( 1 - buying BTC rate 2%) = 39200
>
> buying BTC order amount = buying order value 20 XLM  / (BTC/XLM ask price 41700)=  20 / 41700 = 0.0004796
>
> selling CNY amount = buying BTC order price * buying BTC amount = 39200 * 0.0004796 = 18.8000000

Since `selling CNY amount 18.8` is less than `CNY balance 1736.79`, and `BTC balance value 1.5894309` is less than `BTC MAX value 500`, the robot will place buying BTC order based on the calculation just made.

When the price grows than 40000, the robot will cancel current order and make a new buying order.

The calculation of making a selling order is similar to the process of making a buy order.

> selling BTC order price = the lowest buying CNY order price 200000 * ( 1 + buying CNY rate 2%) = 204000
> 
> selling BTC order amount = buying CNY value 20 XLM  / (CNY/XLM ask price 0.823) / (selling BTC order price 204000)=  20 / 0.823 / 204000 = 0.0001191
> 
> buying CNY amount = selling BTC order price * selling BTC amount = 204000 * 0.0001191 = 24.2964000

Since `BTC balance 0.0000391` is less than `selling BTC order amount 0.0001191`, the robot will not place selling BTC order.

**8.Remove the pair**

![7.gif](https://steemitimages.com/DQmYUv8eB1XRN1p3cVLAxmSwPHhfBqz3eVCt7SYpjqCtWbq/7.gif)

**9.Start the robot.**
* When the robot starts working, please keep browser opening and don't power off your computer.
* ***ATTENTION: Make sure that your computer will not be used by other people, because the private key stores in your brower!!!!***

![9.gif](https://steemitimages.com/DQmXAyV7P8uUJ71qRdK3tTRQKBjN5686r7goDNT5MRk6LJk/9.gif)

**10.You can check the orderbooks of some pairs at the bottom of the page.**

![8.gif](https://steemitimages.com/DQmNnn9QgGRqKe3T33amdXKu4vEHjUEetq5wmv9ERf786Hu/8.gif)


## Question

If you have any question, please feel free to add an issue on [Github](https://github.com/ety001/stellar-bot/issues) or email me work#domyself.me(change # to @).

You can also get in the [Telegram Group](https://t.me/joinchat/EGkaWhMSOna0dEKULvA8FA) for help.

<br /><hr/><em>Posted on <a href="https://utopian.io/utopian-io/@ety001/how-to-use-stellarbot-a-free-making-market-robot">Utopian.io -  Rewarding Open Source Contributors</a></em><hr/>