> 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="/files/GjOwtwO0sAn2jqKLR386" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

<figure><img src="/files/cq9haTaypGLVVZbhztIP" 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" %}
[Как считать курс](/guide/kursy/bestchange/opcii/kak-schitat-kurs.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

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

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

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

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

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

{% content-ref url="/pages/abSY5yT7NslTAOUxyRUz" %}
[Позиция в списке](/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" %}
[Шаг (корректировка курса)](/guide/kursy/bestchange/opcii/shag-korrektirovka-kursa.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

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

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

Пример: `[pos:1] * 1.01`&#x20;

В данном случае курс первой позиции будет увеличен на 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="/files/3G1MgS8OY197J0m0ca5V" 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>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/guide/kursy/bestchange.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.