What is an instance?
An instance stands for an additional copy of the same thing. Having multiple instances of a bot basically means starting the same bot multiple times. This can be useful in many cases, for example when you've got a lot of pairs. If you put 100 pairs into a single instance and each pair takes a set amount of time to calculate, it will take much more time compared to putting 25 pairs into four separate instances. It also allows you to use a different configuration for each instance. Zeno GUI uses PM2 to manage any instances of the bot, this is what it would look like (in the background):
Multiple instances of a bot are not aware of eachother's presence. This means that any API calls made to an exchange by each instance will be duplicated. Most exchanges have strict policies on how often the API can be accessed. Therefore, using to many instances will result in a temporary and ultimately permanent ban. It is very difficult to make specific guidelines for this, but it's best to stick to only a few instances.
Use the configuration screen to configure your instances to your liking. Once you're satisfied with your setup, press "Save". Zeno GUI will automatically restart your bot instances if they are currently active. To learn more about each option, continue reading below.
There are several options to arrange your instances available to you. Select your desired option and press "Apply settings". Each pair will be put into the corresponding instance automatically.
- Single instance
Using this option will unassign all pairs. This will result in a single instance called "unassigned".
- By maximum pairs
To quickly spread out your pairs over multiple instances, simply enter the maximum number of pairs per instance and apply the settings.
- By exchange
This option will put each pair into an instance named after the exchange of each pair.
- By group
This option will put each pair into an instance named after the group of each pair.
- By strategy
This option will put each pair into an instance named after the strategy of each pair.
- Custom instances
Use this option to show a text input field for each pair. Use it to enter a custom name. Only alphabetical characters, numbers, dashes and underscores are allowed.
Because the TradingView addon of the bot behaves in a different way (it doesn't make API calls, but uses IMAP to monitor TV), any pairs you want to use this way need to configured into a specific instance. Use the checkbox on the right side to do so.
When you start the bot, Zeno GUI will generate the configuration files it needs to run your instance(s). It will use "config.js" as a template file. Every instance configuration will be saved into the "configs" folder and each file will be named after the instance you've configured.