# Tokens & Orders

```
[
  {
  "ENABLED" : "True",
  
  "SYMBOL": "KPAD",
  "ADDRESS": "0xcfefa64b0ddd611b125157c41cd3827f2e8e8615",

  "USECUSTOMBASEPAIR": "false",  
  "BASESYMBOL": "enter here your custom Base pair symbol if USECUSTOMBASEPAIR =True",
  "BASEADDRESS": "enter here your custom Base pair address if USECUSTOMBASEPAIR =True",
    
  "LIQUIDITYINNATIVETOKEN": "True",

  "BUYAMOUNTINBASE": "0.1",
  "BUYPRICEINBASE": "0.001",
  
  "SELLAMOUNTINTOKENS": "ALL",
  "SELLPRICEINBASE": "0.003",
  
  "MAXTOKENS": "100",
  "MOONBAG": "20",
  "SLIPPAGE": "49",
  "HASFEES": "false",
  "GAS": "BOOST",
  "BOOSTPERCENT": "50",
  "GASLIMIT": "1000000",
  
  "LIQUIDITYCHECK": "true",
  "LIQUIDITYAMOUNT": "10"
  }
]
```

* **ENABLED** : enable trading or not (if false, bot won't try to buy tokens)\\

* **SYMBOL** : symbol of the token you want to buy\\

* **ADDRESS** : contract address of the token you want to buy\\

* **USECUSTOMBASEPAIR** : must be "true" or "false"
  * "**false**" : the bot uses native token (BNB / ETH / MATIC / KCC / etc.)  to make trades \
    :point\_right: **You only need to hold this native token**
  * "**true**" : bot uses the BASE pair you've entered below

{% hint style="danger" %}
**WARNING**\
If liquidity is in native token, be careful not to use this option if you trade with a big amount of money (several thousands dollars).

**Why?**\
By using this option, bot needs to route your transaction through several routes \
(Custom base token :arrow\_right: Native token :arrow\_right: Token you're sniping)\
and one of this route could have low liquidity

:point\_right: If you trade with big amount, it could result in a big price impact, and **make you lose money**

**ecommendations if you want to make big trades:**\
\- if token has native token liquidity (ETH / BNB...) :point\_right: do not use custom base pair\
\- if token has BUSD / USDT liquidity :point\_right: use:\
&#x20;    \- LIQUIDITYINNATIVETOKEN = false\
&#x20;    \- USECUSTOMBASEPAIR = true , with same base pair as liquidity
{% endhint %}

* **BASESYMBOL** : symbol of the token you want to trade with if you selected USECUSTOMBASEPAIR = True\
  \&#xNAN;*(in this example : I want to buy KPAD with the WBNB I have in my wallet)*\\

* **BASEADDRESS** : contract address of the token you want to trade with if you selected USECUSTOMBASEPAIR = True

* **LIQUIDITYINNATIVETOKEN** ( :warning: new in v3.28 :warning:)\
  Use this option if you want to trade with liquidity in BUSD / USDT / USDC / etc.\\

This option will make the bot :&#x20;

* Detect liquidity which is not in native token
* Make transactions go through direct route \\

| Situation                              | What to choose?                                                                                                    |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Liquidity is in **ETH / BNB / etc.**   | LIQUIDITYINNATIVETOKEN = **True**                                                                                  |
| Liquidity is in **BUSD / USDT / etc.** | <p>- LIQUIDITYINNATIVETOKEN = <strong>False</strong></p><p>- CUSTOMBASEPAIR <strong>= liquidity token</strong></p> |

{% hint style="info" %}
**Example with token with BUSD liquidity**

If you want to trade a token with **BUSD** liquidity, you need to set \
**CUSTOMBASEPAIR = BUSD.**\
\
So, you need to set:

```
LIQUIDITYINNATIVETOKEN": "false",
"USECUSTOMBASEPAIR": "true",  
"BASESYMBOL": "BUSD",
"BASEADDRESS": "0xe9e7cea3dedca5984780bafc599bd69add087d56",
```

{% endhint %}

{% hint style="danger" %} <mark style="color:red;">**WARNING : be VERY CAREFUL about this LIQUIDITYINNATIVETOKEN**</mark> <mark style="color:red;">**option**</mark>\ <mark style="color:red;">If you set up wrong configuration, bot will trade on wrong pair and make you lose funds. Beware!</mark>
{% endhint %}

* **BUYAMOUNTINBASE** : put here the amount **in the base symbol** that you want the bot to buy \
  \&#xNAN;*(in this example, the bot will create buy orders of 0.1 WBNB)*\\

* **BUYPRICEINBASE** : Buy price of 1 token **in the base symbol** : if the price of 1 token is < or = to this price, the bot will buy.\
  \
  **Tip : if you want the bot to never buy, set BUYPRICEINBASE = 0** \
  (price cannot be below 0)

{% hint style="info" %}
BUYPRICEINBASE and SELLPRICEINBASE are the buy price of **ONE token in BASE** **pair**.

Think about it as if you were in front of this screen:

![](broken-reference)
{% endhint %}

* **SELLAMOUNTINTOKENS** : put here the **amount** **of token** that you want the bot to sell \\

* **SELLPRICEINBASE** : sell price of 1 token **in the base symbol** :&#x20;

  * if the price of 1 token is > or = to this price, the bot will sell\
    (it will sell at the Market price, not at your price)\\

  **Tip : if you want the bot to never sell, set SELLPRICEINBASE = 99999999** \\

* **MAXTOKENS** : this parameter is used to **make the bot stop buying**:
  * before buying, the bot checks MAXTOKENS&#x20;
  * if you hold more tokens than MAXTOKENS, the bot does not buy

➡️ If you want to make the bot stop buying after 1 trade, set MAXTOKENS to a low value, like "1" for instance.

{% hint style="info" %}
This parameter **does not** **influence how many tokens the bot will buy** during your trade: if you set MAXTOKENS = 1, the bot can buy 50000 tokens for example, no problem
{% endhint %}

* **MOONBAG** : minimal amount of token you want to keep in your wallet. If you don't want to keep any token, put 0.\
  \&#xNAN;*(in this example, the bot will keep at least 20 KPAD token in your wallet)*\\

* **SLIPPAGE** : slippage you want to use\\

* **HASFEES** : select "TRUE" if you want to trade a token with additional fees, like automatic transfer to liquidity when you buy / additional taxes / rebase / etc.\\

* **GAS / BOOSTPERCENT** :&#x20;

  There is 2 ways to set your Gas :

1. **Set your** **own fixed Gas price** --> simply set Gas price in "GAS" parameter

   ```
   "GAS": "200",
   ```
2. **Let the bot calculate Gas price** relating to current Gas Price on blockchain :
   1. it reads the gas price on the blockchain&#x20;
   2. it applies the boost you set on Fast price. Example :

```
"GAS": "BOOST",
"BOOSTPERCENT": "50",
```

* **GASLIMIT** : always used, set it with the value you want to use (we recommend to set it to 1000000 to avoid to be out of Gas)\\

* **LIQUIDITYCHECK** : use this option if you want the bot to check the **amount of liquidity** before buying
  * If you select "**true**", the bots **check the liquidity amount** before buying
  * If you select "**false**", bot still check if liquidity is added, but **will buy with any amount** (be careful, sometimes some people add a very little amount of liquidity to trick bots, so Team recommend to set this setting to "True")\\

* **LIQUIDITYAMOUNT** : minimal amount of liquidity **in the main blockchain token** (ETH / BNB / MATIC...) before bot buys. Used if LIQUIDITYCHECK = True.

{% hint style="danger" %} <mark style="color:red;">**WARNING**</mark> <mark style="color:red;"></mark><mark style="color:red;">: Liquidity check works only when liquidity is added in Native Token (ETH / BNB / etc.)</mark>

It will NOT display a proper amount if liquidity is added in USDT / BUSD...
{% endhint %}

Congratulations if you made it this far :) You are now ready to run your bot ! :rocket:
