> For the complete documentation index, see [llms.txt](https://gunthy.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gunthy.gitbook.io/wiki/how-to-work-with-gunbot/editing-strategies-and-pairs/trading-pairs.md).

# Trading pairs

Adding trading pairs to Gunbot, information about how cycling works.

To configure which trading pairs Gunbot should trade, go to **Pairs** or **Easy edit**.

You can use an unlimited number of trading pairs, across multiple exchanges.

{% content-ref url="/pages/-MKdgtGXOCVJJEWAs\_H1" %}
[Pair processing](/wiki/how-to-work-with-gunbot/editing-strategies-and-pairs/trading-pairs/pair-processing.md)
{% endcontent-ref %}

## Add trading pairs

![](https://949519763-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_Rejuz9K0BDQxSQvUH%2F-MMRFyfx81LVOyN3UzKT%2F-MMRGm5HmsOES8ftqnDF%2Fimage.png?alt=media\&token=33727a74-2646-4001-93c8-bff3fd4ac4a2)

To start trading on a new pair, just enter or select the pair name, pick the exchange and strategy and hit the **Add** button. When you want to temporarily stop trading a pair, use the **Enabled** toggle to disable the pair.

On exchanges that support it, a pair list is automatically provided in the correct format. For some exchanges you need add pair names manually.

{% hint style="success" %}
The *Use safe balance settings* option makes sure that a few critical balance settings are automatically set to known working values, for each newly added BTC, USD, USDT or EUR pair.
{% endhint %}

### Using filters to add multiple pairs at once

Select the **Use filter rules** option to add pairs based on filters you set. This way you can for example easily add the top 10 volume USDT pairs.

When you're done, hit the **Filter** button to add pairs matching your filters.

![](https://949519763-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_Rejuz9K0BDQxSQvUH%2F-MMRFyfx81LVOyN3UzKT%2F-MMRH0hcoHLWGPzKiNci%2Fimage.png?alt=media\&token=80e94b81-93e9-40eb-a363-d2983326cf3a)

{% hint style="warning" %}
Some exchange unfortunately just don't provide the data needed to filter pairs in this way, or their API rate limits are too strict to do it in a practical way. In that case likely just nothing happens when you hit the filter button.
{% endhint %}

## Pair naming conventions

Gunbot uses a standardized format for entering trading pairs, this allows you to use the same syntax for all exchanges you might use.

Where possible it uses this notation: BASECOIN-QUOTECOIN

All pairs with BTC as base currency are written like: BTC-ETH, BTC-ATOM, BTC-ETH

All pairs with USDT as base currency are written like: USDT-BTC, USDT-ETH, USDT-XMR

{% hint style="info" %}
The base coin in Gunbot is the one used to buy another asset. Be aware that some exchange show pair names in the exact reverse order.&#x20;
{% endhint %}

## Symbol name exceptions

A small number of symbol names need to be written in a slightly different way than the exchange lists them on their site.

| Exchange | Symbol exceptions                                                                                                                                           |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| binance  | Use YOYOW instead of YOYO                                                                                                                                   |
| bitfinex | <p>For a few symbols, the API display name is required. These are:</p><p>IOTA = IOT</p><p>DASH = DSH</p><p>QTUM = QTM</p><p>DATA = DAT</p><p>QASH = QSH</p> |
| kraken   | Use BTC instead of XBT                                                                                                                                      |

## Pair naming for futures exchanges

On **Binance Futures** USDT margined pairs, naming works the same as for spot trading: USDT-BTC, USDT-LTC, etc. For coin margined pairs the correct format is: USD-BTC-PERP or USD-COIN-EXPIRYDATE.&#x20;

The long and short sides on **Bybit** are split into separate pairs in Gunbot. Use USDT-BTC-LONG for the long side of your strategy and USDT-BTC-SHORT for the short side of your strategy. Each side pair can only open positions in that direction.

Pairs on **Bitmex** use almost the same symbols as on Bitmex itself, but with a hyphen-minus between the two asset names. Example: XBT-USD

Pairs on **Kraken Futures** follow the following conventions:

* Perpetual contracts: XBT-USD, ETH-USD, LTC-USD, etc.
* Monthly futures: XBT-MONTH, ETH-MONTH, LTC-MONTH, etc
* Quarterly futures: XBT-QUART, ETH-QUART, LTC-QUART, etc

Pairs on **Okex Futures** use the similar notation as on their site, with hyphens in between the different parts of the pair and swapping the symbols. Valid example: USD-BTC-201016

Pairs on **FTX** follow this pattern: XRP-PERP, BTC-PERP

{% hint style="success" %}
Make sure to use the correct [market type](/wiki/setup-and-general-settings/profile-settings/connect-exchange.md#market-selection), especially when using futures.
{% endhint %}

## Override settings

Overrides are pair specific settings, overruling the assigned strategy. Every strategy parameter can be used as an override.

![](https://949519763-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_Rejuz9K0BDQxSQvUH%2F-MOqZrrDfWBGqu_cwAdg%2F-MOq_OWIiAxieDoDiEBF%2Fimage.png?alt=media\&token=bbe7d682-6344-471b-bc9d-f13ea25b89cb)

You can use this, for example, to set a different trading limit for a specific pair.

When adding overrides, you can choose from a list of all available strategy settings. See the strategy settings pages for which values are accepted for each individual parameter.

{% hint style="info" %}
Make sure to only add overrides for settings that actually have a function for the buy and sell methods of your strategy. See the strategy pages for detailed info about relevant settings.
{% endhint %}
