Bot settings

The bot settings menu lets you change global settings that affect all trading pairs.

To change them, go to Settings > Bot Settings.

Global bot settings

Settings descriptions

Below you'll find detailed descriptions of all available parameters for bot settings. A few advanced settings are only available in the config.js file.

Watch Mode

Description
Values
Name

When set to true, Gunbot will process the configured pairs, but will not place actual buy or sell orders. Good for testing.

Values: true or false

Default value: false

Parameter name in config.js: WATCH_MODE

Multiple Base

Description
Values
Name

Use this option to trade pairs with cross-over between quote and base (for example BTC-ETH and ETH-ADA).

When enabled, Gunbot won't sell all available quote units when selling, instead it will only sell the invested funds (as defined in the trading limit). Also affects the TradingView add-on.

Only enable this when you really need it.

Values: true or false

Default value: false

Parameter name in config.js: MULTIPLE_BASE

Debug

Description
Values
Name

Used to show debug messages in the bot, when set to true. Only use this if you really need to debug something.

Values: true or false

Default value: false

Parameter name in config.js: debug

Verbose

Description
Values
Name

Setting this to true will lead to more detailed information being shown in the console.

Values: true or false

Default value: false

Parameter name in config.js: VERBOSE

Reserve Pile Up

Description
Values
Name

When set to true, trading gains will be automatically added to the funds reserve and be kept out of further trading.

Values: true or false

Default value: false

Parameter name in config.js: RESERVE_PILE_UP

Bot Delay

Description
Values
Name

Bot will delay processing a new pair for a set amount of seconds.

Useful for when Gunbot requests data faster than the exchange API is allowing you to do. As the needed delay depends on the amount of pairs and the speed your system needs to cycle pairs, there are no recommended values.

This is the global setting for bot delay, it is ignored when an exchange specific delay is set.

Values: numerical – represents time in seconds.

Default value: 1

Parameter name in config.js: BOT_DELAY

Bot CClean

Description
Values
Name

This parameter forces the Gunbot cache to be cleaned by restarting the bot every x hours. This setting does not trigger TRADES_TIMEOUT.

Only set this to a low value when your bot actually has problems not trading after a longer period of use.

Values: numerical – represents time in hours.

Default value: 2

Parameter name in config.js: BOT_CCLEAN

Interval Ticker Update

Description
Values
Name

Deprecated

Period Storage Ticker

Description
Values
Name

Deprecated

Timeout Buy

Description
Values
Name

This is an internal timeout that prevents the bot from buying again within the set amount of milliseconds after a buy order has been placed.

Values: numerical – represents time in milliseconds.

Default value: 59000

Parameter name in config.js: timeout_buy

Timeout Sell

Description
Values
Name

This is an internal timeout that prevents the bot from selling again within the set amount of milliseconds after a sell order has been placed.

Values: numerical – represents time in milliseconds.

Default value: 60000

Parameter name in config.js: timeout_sell

Cancel Orders Enabled

Description
Values
Name

When set to true, the bot will cancel unfilled or partially filled orders when the price has moved away from the buy or sell price.

Set this to false if you also trade manually to prevent the bot from cancelling your open orders.

Simulated Fill Or Kill (FOK)

When an order is not or only partially filled and gets cancelled, Gunbot will attempt to fill the order by replacing it at current bid/ask.

For buy orders this means that FOK orders are sent as long as the number of quote units held are worth less than TRADING_LIMIT and the difference is higher than MIN_VOLUME_TO_BUY.

For sell orders this means that FOK orders are sent as long as the number of quote units held (minus KEEP_QUOTE, if used) are worth more than MIN_VOLUME_TO_SELL and bid is higher than the break-even point.

Values: true or false

Default value: false

Parameter name in config.js: CANCEL_ORDERS_ENABLED

Cancel Orders Cycle Cap

Description
Values
Name

This only applies when using MAKER_FEES or CANCEL_ONCAP.

Set the number of rounds that pending orders need to be kept open. After this number of rounds passes, Gunbot will cancel the pending order.

Values: numerical - represents a number of rounds.

Default value: 10

Parameter name in config.js: CANCEL_ORDERS_CYCLE_CAP

Cancel Orders Oncap

Description
Values
Name

Enabling this changes the behavior of cancelling orders: orders are cancelled after CANCEL_ORDERS_CYCLE_CAP passes.

Values: true or false

Default value: false

Parameter name in config.js: CANCEL_ONCAP

Withdraw Threshold

Description
Values
Name

Set the amount of BTC to be accumulated with RESERVE_PILE_UP before an automatic withdraw will be executed.

Values: numerical - represents an amount of BTC

Default value: 0.5

Parameter name in config.js: withdraw_threshold

Withdraw Address

Description
Values
Name

Set a valid BTC wallet address to enable automatic withdraws each time the threshold is reached.

Please use this feature at your own risk only.

Values: string

Default value: YOURBTCADDRESSHERE

Parameter name in config.js: withdraw_address

Json_output

Description
Values
Name

Sets the path for storing .json files. These files are where Gunbot saves its trading information.

Values: text, represents a folder location.

Default value: ./json

Parameter name in config.js: json_output