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

# Настройка BestChange

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

Откройте панель управления **«Парсер курсов — BestChange API парсер»** → нажмите иконку настроек в правом верхнем углу.

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

***

## Включение парсера и API-ключ

{% stepper %}
{% step %}

### Включить парсер

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

Если отключено — курсы не будут обновляться вообще, даже если пары уже созданы.
{% endstep %}

{% step %}

### API-ключ

Введите ваш API-ключ, полученный в кабинете BestChange.

* Это обязательное поле.
* Если ключ неверный или недоступен, справочники (валюты/города/обменники) могут не загрузиться.

{% content-ref url="/pages/76cJ7qoBiy91UhmVZl3p" %}
[API-ключ BestChange](/guide/kursy/bestchange/api-klyuch-bestchange.md)
{% endcontent-ref %}
{% endstep %}

{% step %}

### Таймаут (сек.)

Сколько максимум ждать ответа BestChange API на один запрос.

Рекомендуется:

* 10–15 сек — обычно оптимально
* 20–30 сек — если используете прокси или сеть нестабильна

{% hint style="info" %}
Важно: это не **«интервал обновления»**, а именно время ожидания ответа.
{% endhint %}
{% endstep %}

{% step %}

### Прокси

Если у вас настроены прокси в системе — выберите нужный прокси из списка.

Используйте прокси, если BestChange ограничивает доступ с вашего IP или нужно распределять запросы.

После заполнения нажмите **«Сохранить»** — система попробует загрузить справочники и подготовиться к работе.
{% endstep %}
{% endstepper %}

***

## Версия сайта

Определяет язык справочников и некоторые особенности списков.

* ru — чаще подходит для русскоязычных обменников
* en — если работаете на международный рынок

{% hint style="info" %}

## Важно:

Валюты и названия обменников могут отличаться между версиями. Выбирайте ту версию, где размещён ваш обменник.
{% endhint %}

***

## Тип курса

Настройка **«Тип курса»** влияет на то, как именно парсер выбирает курс из списка обменников на BestChange. От этого зависит, насколько точным будет попадание вашего обменника в нужную вам позицию.

При выборе позиции (например, 3-я или 5-я строка на BestChange) система может учитывать либо только курс, либо курс и рейтинг обменника. Рассмотрим оба варианта подробнее:.

{% stepper %}
{% step %}

#### Вариант 1: Rate (только курс)

*(Стандартный, наиболее распространённый вариант)*

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

<mark style="color:green;">**Преимущества:**</mark>

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

<mark style="color:red;">**Недостатки:**</mark>

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

{% hint style="warning" %}

## Когда стоит выбрать Rate?

Если вам важна максимальная точность попадания в позицию и вы ориентируетесь только на цифры (например, для жёсткой конкуренции по цене).
{% endhint %}
{% endstep %}

{% step %}

#### Вариант 2: RankRate (курс + рейтинг)

*(Продвинутый режим с учётом репутации обменников)*

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

<mark style="color:green;">**Преимущества:**</mark>

* Вы защищены от ненадёжных обменников с низким рейтингом.
* Более стабильная работа с проверенными партнёрами на BestChange.

<mark style="color:red;">**Недостатки:**</mark>

* Курс может оказаться менее выгодным по сравнению с вариантом «Rate».
* Система может пропустить некоторые позиции, если там будут ненадёжные обменники.

{% hint style="info" %}

## Когда стоит выбрать RankRate?

Если вам важна репутация обменников и качество обменов, даже в ущерб точности попадания в позицию по курсу.
{% endhint %}
{% endstep %}

{% step %}

#### Итоговые рекомендации

* **Выберите «Rate»**, если приоритет — это выгодный курс и точность позиции.
* **Выберите «RankRate»**, если важнее всего качество обменников и надёжность операций.

Если не уверены — выберите **Rate**, как наиболее подходящий для большинства случаев.
{% endstep %}
{% endstepper %}

***

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

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

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

{% stepper %}
{% step %}

### По позиции

Система берёт курс с конкретного места в списке BestChange.

Пример:

* Позиция = **3 →** берётся **3-е предложение сверху**
* Позиция = **1–4 →** система выбирает позицию **случайно внутри диапазона**, но стабильно по заданному окну (чтобы курс не «скакал» каждое обновление)

Этот режим самый понятный: **«хочу курс ровно с позиции №N»**.
{% endstep %}

{% step %}

### Среднее

Система берёт **несколько первых предложений** из списка и считает **обычное среднее**.

* Все предложения влияют одинаково
* Сглаживает резкие скачки и «аномальные всплески»
  {% endstep %}

{% step %}

### Взвешенное

Система берёт несколько первых предложений и считает среднее так, чтобы **предложения с большим резервом влияли сильнее.**

* Более «стабильный» курс
* Меньше зависимость от маленьких обменников с крошечным резервом
  {% endstep %}
  {% endstepper %}

<details>

<summary>Сколько лучших курсов учитывать</summary>

Это число используется только для **"Среднее"** и **"Взвешенное".**

Рекомендация:

* обычно 3–10
* если рынок «шумный» — можно 10–20
* слишком большое значение может делать курс «тяжёлым» и менее конкурентным

</details>

<details>

<summary>Позиция в списке (по умолчанию)</summary>

Используется только для режима "По позиции", если в паре позиция не задана.

Пример:

* 3 → берём 3-ю позицию
* 1–4 → выбираем в диапазоне

{% hint style="info" %}
Если в конкретной паре вы укажете свою позицию — глобальная позиция не применяется.
{% endhint %}

</details>

***

## Валюты

После того, как вы ввели API-ключ и сохранили базовые настройки, система загрузит с BestChange полный список доступных валют и криптовалют. Вам нужно будет выбрать из этого списка только те валюты, с которыми ваш обменник действительно работает или планирует работать.

{% hint style="info" %}

## Зачем выбирать валюты?

* Парсер будет получать курсы только по тем направлениям, которые вы выбрали.
* Если валюта не выбрана, то вы не сможете использовать её для создания направлений обмена и получать по ней автоматическое обновление курсов.
  {% endhint %}

{% hint style="info" %}

## Как правильно выбрать валюты?

Выбирайте валюты в зависимости от того, с чем вы реально работаете:

* Электронные деньги (например, QIWI, ЮMoney, WebMoney).
* Банковские карты и платежные системы (Visa, Mastercard, Сбербанк, Тинькофф и др.).
* Криптовалюты (Bitcoin, Ethereum, Litecoin и т.д.).
* Наличные (рубли, доллары, евро и т.д.).
  {% endhint %}

#### Примеры выбора валют:

* Вы хотите обменивать Bitcoin на рубли через карты Сбербанка и Тинькофф: выберите валюты Bitcoin (BTC) и Сбербанк RUB, Тинькофф RUB.
* Вы хотите обменивать Ethereum на наличные доллары и евро: выберите валюты Ethereum (ETH) и наличные валюты USD, EUR.

{% hint style="warning" %}

## Важные рекомендации по выбору валют:

* Не выбирайте валюты, которые не используете — это ускорит работу системы и упростит вам дальнейшую настройку.
* Если вы планируете работать с новой валютой в будущем, её можно будет добавить позже — список всегда доступен для редактирования.
  {% endhint %}

***

## Города

Если вы работаете с наличными обменами (например, обмен криптовалюты на наличные рубли), обязательно укажите города, в которых вы предоставляете эту услугу. Без указания городов наличные направления обмена работать не будут.

{% stepper %}
{% step %}

### Почему важно выбрать города?

Для наличных операций на BestChange существуют отдельные списки курсов, которые зависят от города. Например, курс обмена наличных в Москве может значительно отличаться от курса обмена в Санкт-Петербурге.

* Если город указан — парсер получит курс именно для указанного города.
* Если город не выбран — парсер просто не найдёт курс для направления с наличкой, так как BestChange разделяет курсы наличных направлений по городам.
  {% endstep %}

{% step %}

### Как правильно выбрать города?

Выбирайте города, в которых:

* У вас есть реальный пункт обмена наличных средств.
* Вы готовы проводить операции с клиентами лично или через своих курьеров.

Например:

* Если у вас обменный пункт наличных только в Москве — выберите только город Москва.
* Если вы работаете с клиентами в нескольких городах (Москва, Казань, Екатеринбург) — выберите все эти города из списка.
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}

## Важные рекомендации по городам:

* Не выбирайте города, в которых вы не ведёте реальной деятельности — это только усложнит работу системы и приведёт к некорректному отображению курса.
* Список городов можно изменить в любой момент. Если вы откроете пункт в новом городе — просто добавьте его позже в настройках.
  {% endhint %}

***

## Ограничение обменников

Этот блок заменяет старую путаницу с «белым списком» и делает логику проще:

вы задаёте разрешённых и исключённых обменников, а затем выбираете режим.

{% stepper %}
{% step %}

### Режим ограничения обменников

* Без ограничений — используются все обменники BestChange (кроме исключённых)
* Предпочитать — если есть предложения от разрешённых, система возьмёт их; если нет — возьмёт остальных

  (это мягкий приоритет)
* Только разрешённые — система берёт предложения только из списка разрешённых

  (жёсткое ограничение)
  {% endstep %}

{% step %}

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

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

{% step %}

### Исключённые обменники

Обменники, которые нужно игнорировать всегда:

* некорректные курсы
* подозрительное поведение
* конкуренты, которых вы не хотите учитывать

{% hint style="info" %}
Важно: **«исключённые»** работают во всех режимах.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## Записывать логи ошибок

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

* проблемы доступа к API
* пустые ответы по парам
* ошибки расчёта формул и т. д.