# Настройка BestChange API

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

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

***

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

{% stepper %}
{% step %}

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

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

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

{% step %}

### API-ключ

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

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

{% content-ref url="/pages/76cJ7qoBiy91UhmVZl3p" %}
[Как получить ключ BestChange API?](/osnovnye/parser-kursov/bestchange-api-parser/kak-poluchit-klyuch-bestchange-api.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**, если в конкретной паре не задано другое.

{% 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 полный список доступных валют и криптовалют. Вам нужно будет выбрать из этого списка только те валюты, с которыми ваш обменник действительно работает или планирует работать.

<figure><img src="/files/5U8plLCqpg7Dbq1MEHav" alt="" width="375"><figcaption></figcaption></figure>

{% 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 %}

***

## Города (только для наличных)

<figure><img src="/files/hc1RTpaLxaIvAe870Pl1" alt="" width="375"><figcaption></figcaption></figure>

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

{% stepper %}
{% step %}

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

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

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

{% step %}

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

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

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

Например:

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

{% hint style="info" %}

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

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

***

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

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

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

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

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

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

  (жёсткое ограничение)

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

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

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

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

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

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

***

## Защита от подозрительных предложений

{% stepper %}
{% step %}

### Отсечение подозрительных предложений (Anti-Fake)

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

* резкие аномалии
* нестабильные обменники
* странные ограничения по суммам и резервам
* дополнительные скрытые комиссии (если BestChange отдаёт такие метки)
  {% endstep %}

{% step %}

### Минимальный уровень доверия

Порог, ниже которого предложение будет отклонено.

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

* **50–70 —** универсально
* если рынок «грязный» — можно поднять до 80
* если хотите максимум конкуренции — можно снизить
  {% endstep %}
  {% endstepper %}

***

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

{% stepper %}
{% step %}

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

Если включено — система может временно исключать обменники, которые регулярно попадают под фильтры (например, unstable / лимиты / странные комиссии).
{% endstep %}

{% step %}

### Длительность блокировки по умолчанию (мин.)

Сколько минут обменник будет игнорироваться после блокировки.

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

* 60–180 минут
* если обменники часто «прыгают» — 120 минут обычно норм

{% hint style="info" %}
Это защищает от ситуации, когда один и тот же обменник каждый раз портит расчёт.
{% endhint %}
{% endstep %}
{% endstepper %}

***

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

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

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

***


---

# Agent Instructions: 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:

```
GET https://docs.iexexchanger.com/osnovnye/parser-kursov/bestchange-api-parser/nastroika-bestchange-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.