> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/kursy/istochniki/kursy-konkurentov.md).

# Курсы конкурентов

{% hint style="danger" %}
Модуль **«Курсы конкурентов»** устарел. Для получения и автоматического обновления курсов из внешних источников используйте модуль **«Курсы из файла»**.
{% endhint %}

{% content-ref url="/pages/DoE3UmZHRVvH7K1sLZmA" %}
[Курсы из файла](/guide/kursy/istochniki/kursy-iz-faila.md)
{% endcontent-ref %}

***

Модуль **«Курсы конкурентов»** позволяет автоматически получать и использовать курсы валют и криптовалют из XML-файлов других обменных сервисов.

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-cc6f0519f5ae5ed34b14abd17466c38cbad45ca8%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

После настройки система самостоятельно загружает данные из выбранного источника, обновляет курсы и может использовать их в направлениях обмена, формулах и других связанных разделах платформы.

Это позволяет:

* автоматически отслеживать курсы конкурентов;
* быстро реагировать на изменения рынка;
* использовать конкурентные курсы без ручного ввода;
* строить собственные стратегии ценообразования;
* автоматически обновлять направления обмена.

## Как работает система

Работа модуля состоит из нескольких этапов.

{% stepper %}
{% step %}

### Добавление источника

Добавляется ссылка на XML-файл конкурента.
{% endstep %}

{% step %}

### Добавление пары

Указывается валютная пара, которую необходимо получать из XML-файла.
{% endstep %}

{% step %}

### Автоматическое обновление

Система регулярно загружает XML-файл и обновляет курс.
{% endstep %}

{% step %}

### Использование курса

Полученный курс можно:

* использовать в направлениях обмена;
* использовать в формулах;
* использовать совместно с другими источниками данных.
  {% endstep %}
  {% endstepper %}

## Добавление источника

Для начала работы перейдите в раздел: **«Парсер курсов» — «Курсы конкурентов»**

После этого нажмите кнопку **«Источники».**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-62caeb6c59ade3303887d507b22303284457a66e%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Для создания нового источника нажмите кнопку **«Добавить источник».**

{% stepper %}
{% step %}

### Название

Укажите название конкурента или сервиса.

Например:

* Example Exchange
* Crypto Partner
* Exchange API
  {% endstep %}

{% step %}

### Ссылка

Укажите прямую ссылку на XML-файл.

Пример: `https://example.com/valuta.xml`

После сохранения система автоматически проверит доступность файла и его корректность.
{% endstep %}
{% endstepper %}

## Добавление новой пары

После создания источника нажмите кнопку **«Добавить пару».**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-31a01fdf2c1b2918065f8e91ff200f8da72b3fb8%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Заполните следующие поля.

{% stepper %}
{% step %}

#### Источник

Выберите ранее добавленный источник.
{% endstep %}

{% step %}

### Код отдаю (From)

Укажите код валюты из XML-файла конкурента.

Например: `BTC`
{% endstep %}

{% step %}

### Код получаю (To)

Укажите код валюты, которую необходимо получить.

Например: `USDT`

После сохранения будет создан курс: **BTC - USDT**
{% endstep %}

{% step %}

### Корректировать курс

Определяет способ расчёта курса на основании данных XML-файла.

Доступны два варианта:

<table><thead><tr><th width="191.7734375">Значение</th><th>Описание</th></tr></thead><tbody><tr><td>Отдаёте</td><td>Используется значение из поля <code>&#x3C;out></code></td></tr><tr><td>Получаете</td><td>Используется значение из поля <code>&#x3C;in></code></td></tr></tbody></table>

В большинстве случаев рекомендуется использовать значение, указанное поставщиком XML-файла.
{% endstep %}

{% step %}

### Знаки после запятой

Определяет точность хранения курса.

Рекомендуемое значение: **8–10 знаков после запятой**
{% endstep %}

{% step %}

### Статус

Определяет, будет ли курс участвовать в автоматическом обновлении.
{% endstep %}
{% endstepper %}

## Использование курсов в формулах

Каждый курс автоматически получает собственный тег.

Например: `[competitors_exampleexchange_btc-usdt]`

Данный тег можно использовать в разделе: **«Парсер курсов» — «Курсы по формуле»**

{% content-ref url="/pages/WQ7Sr26pHTEFr2jwAscq" %}
[Формулы](/guide/kursy/formuly.md)
{% endcontent-ref %}

Пример:

```
[competitors_exampleexchange_btc-usdt] * 1.02
```

## Привязка курса к направлению обмена

После создания курс можно использовать в направлениях обмена.

Перейдите: **«Основное» — «Направления обмена» — «Список направлений»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-96e4bcfa1d08a4453e27e250b2a40563382c4bd6%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Откройте необходимое направление и перейдите в раздел: **«Обмен» — «Курс обмена»**

В поле: **«Курс конкурента»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-02361b743ef9f5f91e1ed1559b6181024ff75be2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

выберите ранее созданный курс.

После сохранения направление начнёт использовать данные конкурента автоматически.

## Ограничение курса конкурента

Для дополнительной защиты можно настроить ограничения курса.

Доступны следующие параметры:

{% stepper %}
{% step %}

### Минимальный курс

Если курс конкурента станет ниже указанного значения, система перестанет использовать его.
{% endstep %}

{% step %}

### Максимальный курс

Если курс конкурента станет выше указанного значения, система перестанет использовать его.
{% endstep %}

{% step %}

### Резервный курс

Курс, который будет использоваться при выходе конкурентного курса за указанные пределы.
{% endstep %}

{% step %}

### Дополнительная надбавка

Позволяет автоматически добавить процент к резервному курсу.

Например: **2%**

Если резервный курс составляет: **100**

то итоговый курс будет: **102**
{% endstep %}
{% endstepper %}

## Рекомендации

Для стабильной работы рекомендуется:

* использовать только доступные XML-файлы;
* периодически проверять работоспособность источников;
* использовать резервный курс для важных направлений;
* контролировать минимальные и максимальные лимиты;
* проверять корректность кодов валют из XML-файла.