Configuring OctoBot Profiles, Markets, Exchanges, and Trading Risk
Summary
OctoBot profiles determine which strategies and evaluators run, which cryptocurrencies and trading pairs are considered, which exchanges are enabled, and whether trading uses spot or futures. The guide explains how to edit strategy settings through the interface or configuration files, and why a custom profile is needed to switch among strategies or evaluators beyond those available in a default profile. It also describes using a wildcard to include all pairs for a specified quote currency and recommends limiting the number of simultaneous assets based on available funds.
Trading settings distinguish real exchange funds from simulated portfolios. A reference market sets the currency used to calculate portfolio value and profitability, while a risk setting from zero to one changes how optimistic and active the bot is when creating orders. The guide also covers loading recent trade history and where global and profile configuration files reside. Its risk descriptions are qualitative; it provides no measured performance, strategy evaluation, or risk-sizing method. Manual JSON edits can prevent the bot from starting if the files are invalid.
Key ideas
- Profiles control strategies, evaluators, currencies, exchanges, and trading settings.
- Custom profiles allow users to choose strategies or evaluators beyond those available in default profiles.
- A wildcard can select all pairs using a specified quote currency.
- The risk setting changes the bot’s stated trading behavior, while the reference market determines how value and profitability are calculated.
- Invalid manual edits to configuration files can prevent OctoBot from loading.
Tags
Full text
# Profile configuration
---
title: "Profile configuration"
description: "Lean how to configure an OctoBot profile by selecting its trading strategy, evaluators, cryptocurrencies, exchanges and trader setting."
sidebar_position: 2
---
# Profile configuration
## Strategies
Most [evaluators and trading modes](/guides/octobot-trading-modes/trading-modes) can be configured.

To open the configuration interface, click on your strategy configuration icon.

This edition interface is generated according to the user inputs of the evaluator or trading mode to configure. You will find the technical details on the developers section, in [the tentacles configuration docs](/guides/octobot-tentacles-development/create-a-tentacle-package#configuration).
It is also possible to manually edit each configuration file using a
text editor for JSON. When configurable, each evaluator or trading mode
has a **NameOfTheRelatedClass.json** file in
**user/profiles/profile_name/specific_config**. Note: this file created in your profile after any change in the default configuration of the tentacle.
### Custom profiles
When using default profiles, trading modes and strategies configurations can be edited, but not switch to others.
To use other trading modes, strategies or evaluators, you can duplicate a default profile to create a [custom profile](custom-profile)
which can be more deeply configured.

## Currencies

OctoBot will trade all the cryptocurrencies listed in its configuration.
To tell which cryptocurrencies to trade, add the currency in the
**crypto-currencies** section in
**user/profiles/profile_name/profile.json**.
In order to keep OctoBot working at its full potential, we recommend to
trade **between 1 and 5** different assets **not to use more than 10 to
15** different assets at the same time, depending on the size of your
available funds.
### Wildcard
To tell OctoBot to trade all BTC trading pairs (with BTC as a quote
asset), use the wildcard "\*" instead of a list for "pairs", directly in your profile's profile.json file:
```json
"crypto-currencies":{
"Bitcoin": {
"pairs": ["*"],
"quote": "BTC"
}
}
```
A "quote" is required to specify the name of the currency to trade
with.
## Exchanges

For each profile, you can enable the exchanges you want to trade on.
It is also where you can select if you want to use **spot** or **future** trading on those exchanges.
## Trading

OctoBot can process two types of trading:
- Real trading using your exchanges' portfolio.
- Simulated trading using any imaginary portfolio.
### Reference-market
The **Reference-market** parameter defines which currency OctBot should
use as a reference, this reference is used to compute profitability and
the portfolio total value
### Risk
Any type of trading has its risk parameter. It is a parameter defining
the behavior of the trader, similarly to a real human trader.
The **Risk** parameter defines the behaviour of OctoBot in an optimism
manner.
It is a value between 0 and 1:
- A low risk (closer to 0) will make OctoBot a very safe trader with
few bold moves and mostly small trades. A 0 risk bot is very
pessimistic (regarding its orders creation) and does not expect big
market moves.
- A high risk (closer to 1) will make OctoBot a very active and heavy
trader. A 1 risk bot is very optimistic (regarding its orders
creation) and is expecting significant market moves.
### Trader
When the **Enabled** parameter of the **Trader** section is set at **true**, OctoBot will trade
using your real funds from your exchange's accounts. When **false**
OctoBot will never any create a real trade.
### Load trade history
When the **load-trade-history** parameter is set at **true**, OctoBot
will load the account's recent trades for the enabled traded pairs at
startup. This allows to have a view on your account's trade history.
When **false**, OctoBot will only historize trades that happen after the
bot startup.
### Trader simulator
Additionally to the real trading system, a [trading simulator](/guides/octobot-usage/simulator) is
available in OctoBot.
[Here is the guide describing the simulator feature of OctoBot](/guides/octobot-usage/simulator)
## Configuration files
OctoBot configuration is located in the **user** folder:
- **user/config.json** is the global configuration file, mostly used
to setup the bot exchanges credentials, interfaces and notification
settings.
- **user/profiles/** contains all the [profiles](profiles)
created and imported in your OctoBot.
OctoBot's web interface allows to easily edit the configuration,
however, it is also possible to manually edit configuration files.
Please be careful when manually editing them or OctoBot won't be able
to read them and wont start. Json file are readable and editable using
any text editor.
```bash
ERROR root <class 'Exception'>: Error when load config
```
This will appear when a configuration file is not a json valid file.
**user/config.json** is the technical configuration file of OctoBot, an
example is available <a href="https://github.com/Drakkar-Software/OctoBot/blob/master/octobot/config/default_config.json" rel="nofollow">on
github</a>.
When starting OctoBot, if the **user** folder is missing or incomplete,
it will automatically be created or completed with default values.Shown in full with attribution under the source's licence. Licence: GPL-3.0
This summary was written by Stratmill's research agent from the original; it is not a copy of the source.