This article is meant for power users who want to run Gunbot without using the GUI. This is not an exhaustive overview of all available settings, just a quick overview of how to manually work with the config file. Refer to other parts of the wiki for detailed settings descriptions.
All Gunbot settings are defined in a single file named
config.js. This is where you set up your exchange API keys, add pairs and define your strategies. You can refer to the included
config-js-example.txt file for an example of a config file with properly defined pairs and all needed parameters for adding each exchange. Throughout this wiki you'll find detailed descriptions for every parameter available in the config file.
When the config file is overwritten while Gunbot is running, the changed settings will be loaded automatically.
Make sure that no parameters are removed when setting it up. Make sure the JSON-formatting stays intact. If you are unsure about your config file, you can validate it on https://jsonlint.com (or a similar JSON validator). The only action that requires using the GUI is updating registered API keys.
To disable the GUI completely, make the following change in the GUI section of
To connect an exchange, add the relevant settings to the exchange section of
It looks like this:
Note that you can use a different API key for trading than the registered key. If you don't use a secondary key, you can just enter the registered key in the
A strategy is defined by giving it a unique name and adding it to the
strategies section of the config file. This strategy can then be assigned to one or more trading pairs.
It looks like this:
pairs section of the config file you can add one or more pairs inside a block specifying the exchange the pairs will run on.
Each pair must be assigned an existing strategy, it must be specified if the pair is enabled or not.
The override section allows for pair specific modifications to the assigned strategy. Any strategy parameter can be used as an override.
In the example above the pair will run the strategy named
SMACROSS, using a
TRADING_LIMIT different from what is defined in the strategy itself.