Skip to main content

Balance settings

Balance settings define how much the bot can spend, in a strategy made with the strategy builder.

Understanding the most important settings​

Understanding balance settings is crucial for any trading strategy. These settings play a vital role in determining the balance between risk and reward, and can significantly impact the success of your trades. It's important to familiarize yourself with these settings and understand how they work.

Trading Limit​

With this setting you tell Gunbot how much to spend on a buy order.

The trading limit is generally defined in the "base currency" of a pair. This means that if you want to buy LTC with BTC, the trading limit must be set in Bitcoin. If you want to buy BTC with USD, you need to set the trading limit as an amount in US dollars.

Since in crypto there are many different base currencies, it is very important you set this correctly. Not setting it correctly can lead to trades for unwanted amounts, or no trades at all. It is important to set the trading limit at least a bit higher than the minimum trade size of your exchange.

The reason for this is that due to rounding and/or fees a trade mostly results in an amount worth slightly less than the trading limit. If this amount is lower than the minimum trade size of your exchange, it cannot be sold without buying additional units.

Min volume to sell​

This setting defines the minimum trade size for the pair you trade, this is both pair and exchange specific. When set correctly, Gunbot will ignore low balances that can not be sold.

Look up the minimum trade size for your pair, and set it exactly like this.

Usage example:

  • Trading pair: USDT-BTC
  • Exchange defined minimum trade size: 10 USDT
  • Current balance value: 8 USDT

When min volume to sell is correctly set to 10, Gunbot will ignore the current balance and proceed with looking for a buy opportunity.

When min volume to sell is set incorrectly, for example to 3, Gunbot will attempt to sell the current balance worth only 8 USDT. This will fail because the exchange does not allow the trade.

Min volume to buy​

This setting is very similar to min volume to sell, it defines what the minimum amount is that Gunbot can place a buy order for.

Look up the minimum trade size for your pair, and set it exactly like this. It is normal to set this parameter exactly the same as min volume to sell.

In some cases Gunbot will place a buy order in multiple parts, the setting min volume to buy tells the bot what the absolute minimum amount for a partial order can be. If you set it too low, such trades will fail.

tip

Min volume to buy is only needed when using limit orders.

Balance settings parameters​

Trading Limit​

This value defines the trading limit for each buy order. Make sure to always set this higher than MIN_VOLUME_TO_BUY & MIN_VOLUME_TO_SELL.

When you set this to 0.1 and trade BTC-x pairs, Gunbot will place a buy order worth 0.1 BTC each time it buys.

When trading a fiat pair like USD-x, set a whole number like 100 as trading limit.

Trading Limit Percentage​

Alternative method for setting the investment per buy order as a percentage of the available base currency at the time the trade takes place.

Any value above 0 makes Gunbot ignore TRADING_LIMIT and uses the set percentage instead. For example: when set to 10, trading BTC-ALT and you have 1 BTC available at the time Gunbot places a buy order, an order of 0.1 BTC is placed.

Trading Limit All-In​

Alternative method for setting the investment per buy order to use all available base currency at the time the trade takes place.

Keep Quote​

Sets an amount of quote currency that will not be sold. For a BTC-ALT pair, a set amount of ALT will not be sold.

For example: when KEEP_QUOTE is set to 10 for trading BTC-BNB, then Gunbot will leave 10 BNB in your account when placing a sell order, any balance above 10 will get sold as long as it is worth more than MIN_VOLUME_TO_SELL.

To make sure trading continues after a sell order where an amount of quote is kept, make sure to set MIN_VOLUME_TO_SELL at least higher than the assumed value of the kept quote (expressed in base currency).

Funds Reserve​

Sets an amount of base currency that will not be traded. For a BTC-x pair, funds in BTC would be reserved according to this setting. For ETH- pairs ETH would be reserved, etc. It is recommended to use the same value for all pairs of the same base currency you run.

For example: when funds reserve is set to 0.5 for trading BTC-x pairs then 0.5 BTC will not be used by Gunbot.

Min Volume To Buy​

Sets a threshold for buy orders. Prevents orders below the exchange minimum trade size from being placed.

Set this at least to the minimum trade size of your exchange.

When trading a fiat pair like USD-x, set a whole number like 10 as MIN_VOLUME_TO_BUY.

Min Volume To Sell​

Sets a threshold for sell orders lower than the exchange minimum trade size.

If you own less than the set amount, sell orders will not be placed and Gunbot goes into buying mode. Set this at least to the minimum trade size of your exchange.

When trading a fiat pair like USDT-x, set a whole number like 10 as MIN_VOLUME_TO_SELL.

When you hold 0.006 (in base currency) of a coin and have set MIN_VOLUME_TO_SELL to 0.01, Gunbot will not try to sell your current 0.006 balance because it is below the set threshold of 0.01, instead it will place another buy order first as soon as buying are met.