> 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/bestchange.md).

# BestChange

{% hint style="danger" %}

## Важно

Автоматический парсинг курса через BestChange API будет работать только при активном статусе направления обмена.

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

***Убедитесь, что все необходимые направления обмена включены, чтобы парсер мог корректно и своевременно обновлять ваши курсы.***
{% endhint %}

Модуль «BestChange API парсер» предназначен для автоматического получения курсов обмена с мониторинга BestChange и использования этих данных в направлениях обмена.

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

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

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

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

## Перед началом работы

Перед добавлением пар необходимо выполнить первоначальную настройку парсера:

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

Подробная инструкция:

{% content-ref url="/pages/K3L5jmPvkn4YYZinBIeL" %}
[Настройка BestChange](https://docs.iexexchanger.com/guide/kursy/bestchange/nastroika-bestchange.md)
{% endcontent-ref %}

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

Перейдите в раздел: **«Парсер курсов» — «BestChange API парсер»**

Нажмите кнопку **«Добавить пару».**

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

В открывшемся окне выберите направление обмена из списка и нажмите **«Добавить»**.

После этого новая запись появится в общем списке и станет доступна для настройки.

## Настройка пары

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

{% stepper %}
{% step %}

### Активность пары

Включает или отключает автоматическое обновление курса.

Если пара отключена, система не будет получать данные из BestChange.
{% endstep %}

{% step %}

### Отдаю

Выберите валюту, которую отдаёт клиент.

Примеры:

* Bitcoin BTC
* Tether ERC20 USDT
* T-Банк RUB
* Tron TRX
  {% endstep %}

{% step %}

### Получаю

Выберите валюту, которую получает клиент.

Примеры:

* Bitcoin BTC
* Tether ERC20 USDT
* Litecoin LTC
* Сбербанк RUB
  {% endstep %}

{% step %}

### Город

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

Если направление связано с наличными средствами, выберите соответствующий город.

Для безналичных направлений оставьте значение: **Без города**
{% endstep %}

{% step %}

### Как считать курс

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

Доступны три режима:

<table><thead><tr><th width="179.921875">Режим</th><th>Назначение</th></tr></thead><tbody><tr><td>По позиции</td><td>Используется курс с конкретной строки BestChange</td></tr><tr><td>Медиана</td><td>Используется медианное значение среди нескольких лучших предложений</td></tr><tr><td>Взвешенное</td><td>Используется среднее значение с учётом резервов обменников</td></tr></tbody></table>

Подробное руководство:

{% content-ref url="/pages/5QPUNGvXsjcGKTwvs0BG" %}
[Как считать курс](https://docs.iexexchanger.com/guide/kursy/bestchange/opcii/kak-schitat-kurs.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Позиция в списке

Используется в режиме **«По позиции»**.

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

Примеры: **1** или **1-3**

Подробное руководство:

{% content-ref url="/pages/abSY5yT7NslTAOUxyRUz" %}
[Позиция в списке](https://docs.iexexchanger.com/guide/kursy/bestchange/opcii/poziciya-v-spiske.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Шаг

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

Поддерживаются: **+2, -5, +1%, -2%, \*1.02, /1.05**

{% content-ref url="/pages/1nbtBDPRb0ZUueJvHacM" %}
[Шаг (корректировка курса)](https://docs.iexexchanger.com/guide/kursy/bestchange/opcii/shag-korrektirovka-kursa.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Формула курса

Если формула указана, система будет использовать её вместо стандартного расчёта.

Пример: `[pos:1] * 1.01`

В данном случае курс первой позиции будет увеличен на 1%.

Формулы позволяют создавать собственные правила расчёта поверх данных BestChange.
{% endstep %}

{% step %}

### Запрещённые обменники

Список обменников, которые никогда не будут участвовать в расчёте курса.

Используйте данный список для исключения:

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

{% step %}

### Разрешённые обменники

Если список заполнен, система будет использовать только указанные обменники.

Все остальные предложения будут проигнорированы.

Это удобно, если необходимо ориентироваться только на определённую группу обменников.
{% endstep %}

{% step %}

### Минимальный и максимальный резерв

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

<table><thead><tr><th width="181.41015625">Настройка</th><th>Назначение</th></tr></thead><tbody><tr><td>Мин. резерв</td><td>Игнорировать обменники с резервом ниже указанного</td></tr><tr><td>Макс. резерв</td><td>Игнорировать обменники с резервом выше указанного</td></tr></tbody></table>

Если указано значение: **0** ограничение не применяется.
{% endstep %}

{% step %}

### Минимальная и максимальная сумма

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

| Настройка   | Назначение                     |
| ----------- | ------------------------------ |
| Мин. сумма  | Минимальная сумма предложения  |
| Макс. сумма | Максимальная сумма предложения |

Если значение равно: **0** ограничение не применяется.
{% endstep %}

{% step %}

### Фиксировать курс вручную

Если включить данный режим, система перестанет использовать автоматический курс BestChange.

После включения становятся доступны следующие варианты:

<table><thead><tr><th width="201.125">Вариант</th><th>Описание</th></tr></thead><tbody><tr><td>Стандартный курс</td><td>Использовать фиксированное ручное значение</td></tr><tr><td>Источник курса</td><td>Использовать курс из другого источника</td></tr><tr><td>Источник формулы</td><td>Использовать курс из раздела «Курсы по формуле»</td></tr></tbody></table>

Рекомендуемый вариант:

* Источник курса
* Источник формулы
  {% endstep %}
  {% endstepper %}

## История курсов

В меню **«Ещё»** доступен раздел: **«История курсов»**

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

Здесь можно посмотреть:

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

## Массовое изменение

В меню **«Ещё»** доступен раздел: **«Массовое изменение»**

Позволяет изменить сразу несколько записей.

Поддерживаются массовые изменения:

<table><thead><tr><th width="214.23828125">Тип изменения</th><th>Что изменяется</th></tr></thead><tbody><tr><td>Позиция</td><td>Изменение позиции или диапазона</td></tr><tr><td>Шаг</td><td>Изменение корректировки курса</td></tr><tr><td>Как считать курс</td><td>Изменение режима расчёта</td></tr></tbody></table>

Используйте данный инструмент, если необходимо быстро изменить стратегию работы сразу у большого количества направлений.

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

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

Пример: `[bestchange_trx_usdt]`

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

Пример: `[bestchange_trx_usdt] * 1.02`

Это позволяет объединять данные BestChange с другими источниками курсов и создавать собственные алгоритмы расчёта.

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

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

<table><thead><tr><th width="222.8515625">Настройка</th><th>Настройка</th></tr></thead><tbody><tr><td>Режим расчёта</td><td>По позиции</td></tr><tr><td>Позиция</td><td>2-4</td></tr><tr><td>Шаг</td><td>0</td></tr><tr><td>Мин. резерв</td><td>0</td></tr><tr><td>Макс. резерв</td><td>0</td></tr></tbody></table>

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