> 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/learn/4.-kursy-i-napravleniya/03-large-rate-catalogs.md).

# Большие каталоги и BestChange

Работайте с большими каталогами и настройте BestChange: стратегии, фильтры, рейтинг, шаг и резервный курс

## Что вы получите

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

Большой каталог выбора используется в трёх местах:

* **«Курс обмена»** направления;
* ограничения курса;
* страховка курса.

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

## Как теперь загружается список

```mermaid
flowchart LR
    A["Открыть поле"] --> B["Первая порция"]
    B --> C["Поиск на сервере"]
    B --> D["Прокрутка вниз"]
    D --> E["Следующая порция"]
    C --> F["Найденные курсы"]
    E --> F
    F --> G["Выбранный курс"]
```

Список запрашивается только при открытии и продолжается по мере прокрутки. Это означает:

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

## Найдите курс направления

Откройте **«Основное» — «Направление обмена» — «Список направлений»**, выберите направление и перейдите в **«Обмен» — «Курс обмена»**.

{% stepper %}
{% step %}

### Откройте поле источника

Не нажимайте его многократно. Дождитесь первой порции или понятного сообщения об ошибке.
{% endstep %}

{% step %}

### Введите отличительный запрос

Используйте код пары, название источника или часть названия. Для первого направления ищите созданную формулу BTC-LTC, а не случайный курс с похожим числом.
{% endstep %}

{% step %}

### Проверьте группу и значение

Сверьте источник, ориентацию пары и отображаемое значение. Одинаковые названия из разных групп не считаются одной записью.
{% endstep %}

{% step %}

### Выберите один вариант

После выбора поле должно показать сохранённое название. Нажмите кнопку сохранения страницы направления и дождитесь подтверждения.
{% endstep %}

{% step %}

### Откройте поле повторно

Убедитесь, что выбранный курс восстановился. Затем проверьте фактическое использование через **«Как сформирован курс»**.
{% endstep %}
{% endstepper %}

## Прокрутка или поиск

{% tabs %}
{% tab title="Поиск" %}
Используйте, когда знаете пару или источник. Запрос возвращает ограниченный релевантный набор и подходит для каталога с десятками тысяч записей.
{% endtab %}

{% tab title="Прокрутка" %}
Используйте для просмотра соседних курсов внутри группы. При достижении нижней границы список подгрузит следующую порцию без закрытия поля.
{% endtab %}
{% endtabs %}

Очистка поиска возвращает обычный каталог. Во время нового запроса не выбирайте строку из старого результата, пока состояние загрузки не завершилось.

## Проверьте остальные экраны

### Ограничения

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

### Страховка курса

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

## Подключите BestChange API

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

{% stepper %}
{% step %}

### Сохраните подключение

Укажите **«API‑ключ BestChange»**, таймаут запроса и значение поля **«Версия сайта»** — русский или английский каталог. Прокси выбирайте только тогда, когда он действительно настроен и проверен; в остальных случаях оставьте **«Без прокси»**.
{% endstep %}

{% step %}

### Выберите поле курса

* **Rate** — чистый курс из списка BestChange;
* **RankRate** — сравнительный курс с учётом доступных BestChange комиссий и условий.

Не переключайте поле только ради более привлекательного числа: это меняет основу сортировки и расчёта.
{% endstep %}

{% step %}

### Задайте общую стратегию

В **«Как считать курс»** выберите начальное правило: конкретная позиция, медиана первых предложений или ближайшая строка к средневзвешенному значению. Для медианы и взвешенного расчёта укажите **«Сколько лучших курсов учитывать»**.
{% endstep %}

{% step %}

### Ограничьте рынок при необходимости

Выберите валюты и города. В **«Ограничение обменников»** доступны три режима:

* **«Без ограничений»** — участвуют все подходящие обменники, кроме явно исключённых;
* **«Сначала из списка»** — сначала проверяются разрешённые, затем общий рынок;
* **«Только из списка»** — участвуют только разрешённые.

Список **«Исключённые обменники»** имеет запрещающий приоритет.
{% endstep %}

{% step %}

### Включите диагностику и парсер

Для первоначальной приёмки включите **«Записывать ошибки»**, затем активируйте BestChange и сохраните форму. После сохранения должны загрузиться справочники валют, городов и обменников.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Не публикуйте API‑ключ в снимках экрана, заявках поддержки или журнале приёмки. Значение должно оставаться только в настройках подключения.
{% endhint %}

## Создайте пару из направления

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

1. Нажмите **«Добавить пару»**.
2. В поле направления выберите Bitcoin BTC - Litecoin LTC или другое подготовленное направление. Можно выбрать несколько направлений за один раз.
3. Нажмите **«Добавить»**.
4. Найдите созданную строку и пока оставьте её выключенной.

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

## Настройте отдельную пару

Откройте действие **«Изменить»** у созданной строки. Общие настройки дают стартовую политику, а эта форма определяет расчёт конкретной пары.

{% tabs %}
{% tab title="Позиция" %}
В режиме **«По позиции»** укажите одно положительное число, например `3`, или диапазон, например `3-7`.

Позиция считается не по исходному ответу API. Сначала система применяет списки обменников, лимиты, резерв и остальные правила, затем детерминированно сортирует пригодные предложения. Диапазон позволяет стабильно выбирать одну строку внутри заданных границ. Если после фильтрации строк меньше указанной позиции, используется последняя доступная.
{% endtab %}

{% tab title="Медиана Top‑N" %}
Система рассматривает первые N пригодных предложений, находит медиану и выбирает строку, ближайшую к ней. Такой режим уменьшает влияние одиночного выброса, но не заменяет проверку резервов и лимитов.
{% endtab %}

{% tab title="Взвешенное Top‑N" %}
Система рассчитывает среднее первых N предложений с учётом резервов и выбирает ближайшую строку. Обменники с большим резервом влияют сильнее. Сначала проверьте результат на фактической сумме заявки.
{% endtab %}

{% tab title="Фильтры" %}
Для пары можно отдельно настроить **«Запрещённые обменники»**, **«Разрешённые обменники»**, минимальный и максимальный резерв, минимальную и максимальную сумму. Ноль у границы резерва означает отсутствие ограничения.

Белый список пары сужает рынок до выбранных обменников, а чёрный список исключает записи. Слишком узкие условия могут оставить пару без единого предложения.
{% endtab %}

{% tab title="Шаг и формула" %}
Поле **«Шаг (корректировка)»** принимает число, процент, умножение или деление, например `+0.1%`, `-1%`, `*1.02` или `/1.01`.

Если заполнена **«Формула курса»**, она заменяет стандартный расчёт по выбранной стратегии. Не объединяйте формулу и шаг вслепую: сначала докажите базовый результат в рейтинге, затем добавьте одну корректировку и повторите проверку.

Для расширенного правила используйте только проверенные теги BestChange:

| Задача                                 | Пример                                                  |
| -------------------------------------- | ------------------------------------------------------- |
| взять курс позиции                     | `[pos:2]`                                               |
| узнать число положительных отзывов     | `[exchanger_rating:1]`                                  |
| получить процент положительных отзывов | `[exchanger_trust:1]`                                   |
| выбрать по доверию                     | `[if][exchanger_trust:1]>90 [pos:1] [else][pos:2][/if]` |
| использовать резервную ветку           | `[fallback:[pos:1],[pos:2]]`                            |

Позиции отсчитываются с единицы уже после фильтрации и сортировки. Отсутствующая позиция или повреждённое значение должны завершить выбранную ветку ошибкой либо перевести расчёт в `fallback`, а не становиться нулём.
{% endtab %}
{% endtabs %}

Опцию **«Фиксировать курс вручную»** для обычной автоматической пары оставьте выключенной. Она переводит расчёт на вручную заданный курс и может скрыть проблему основного источника.

## Проверьте рейтинг и симуляцию

В строке пары нажмите **«Рейтинг»**. Этот экран сравнивает сохранённые значения с новым снимком рынка и позволяет безопасно подобрать шаг до его применения.

{% stepper %}
{% step %}

### Укажите контрольную сумму

Введите реальную сумму обмена и нажмите **«Обновить»**. Пустое поле означает просмотр рынка без фильтра по сумме; минимум вашего направления сам по себе не должен отбрасывать предложения BestChange.
{% endstep %}

{% step %}

### Сравните три результата

Различайте **«Сохранённый курс источника»**, **«Расчёт по этому снимку»** и **«Сохранённый курс направления»**. Проверьте поле Rate или RankRate, стратегию, позицию или Top‑N, время успешной проверки и время последней попытки.
{% endstep %}

{% step %}

### Изучите отфильтрованные предложения

Экран показывает исходное и оставшееся количество строк. Раскройте причины исключения: списки обменников, резерв, минимальная и максимальная сумма, недостаточный резерв или некорректный курс. В таблице отдельно отмечены выбранный источник, свой обменник и предпочтительные обменники.
{% endstep %}

{% step %}

### Подберите цель шага

Можно опередить или сравняться с ближайшим, лучшим либо выбранным предложением. Система покажет фиксированный и процентный варианты, результат после применения, оценочное место и выход за границы курса.
{% endstep %}

{% step %}

### Примените только актуальную рекомендацию

Кнопка **«Применить шаг»** целиком заменяет поле **«Шаг»**. Она не прибавляет рекомендацию к старому выражению и не меняет опубликованный курс мгновенно. Если сумма изменилась или снимок устарел, сначала нажмите **«Обновить»**. После сохранения дождитесь следующего обновления BestChange и снова проверьте направление с комиссиями.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Оценочное место рассчитывается среди предложений, оставшихся после ваших фильтров. Оно не гарантирует официальную позицию на сайте BestChange, прибыль или пригодность курса для любой суммы.
{% endhint %}

## Используйте группы и массовые изменения

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

Для одинакового изменения нескольких строк отметьте их в таблице. Для всего результата текущего фильтра используйте **«Ещё» — «Массовое изменение»**. Поддерживаются:

* включение или отключение;
* номер позиции или диапазон;
* шаг;
* способ расчёта и его позиция либо Top‑N.

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

## Разберите ошибку, не стирая рабочий курс

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

1. Откройте **«Ещё» — «Лог ошибок»**.
2. Найдите направление и пару BestChange.
3. Сверьте причину, режим, поле курса и время последнего появления ошибки.
4. Вернитесь в **«Рейтинг»** и проверьте причины исключения.
5. Убедитесь, что настроен следующий допустимый источник курса либо безопасное отключение направления.

Не заменяйте отсутствие данных нулём. Политику использования старого значения и границу 15 минут при строгой проверке настройте в следующем уроке.

## Если каталог не открылся

{% stepper %}
{% step %}

### Прочитайте состояние поля

Различайте первичную загрузку, пустой результат поиска и ошибку сети. Пустой запрос после поиска не равен отсутствию всех курсов.
{% endstep %}

{% step %}

### Нажмите «Повторить»

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

{% step %}

### Проверьте источник

Убедитесь, что источник включён, нужная пара активна и имеет свежее положительное значение.
{% endstep %}

{% step %}

### Перезагрузите экран

После восстановления сети снова найдите запись и проверьте сохранённый выбор. Если ошибка повторяется, остановите направление и перейдите к диагностике.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Виртуальный список показывает только видимую часть каталога. Число строк в разметке браузера не является числом доступных курсов и не доказывает потерю данных.
{% endhint %}

## Этап завершён, если

* [ ] первая порция загружается только после открытия поля;
* [ ] поиск находит курс вне первой видимой порции;
* [ ] прокрутка подгружает продолжение без закрытия;
* [ ] группа, источник, пара и значение не перепутаны;
* [ ] выбор сохраняется и восстанавливается;
* [ ] ошибка показывает повторную попытку;
* [ ] BestChange подключён без раскрытия API‑ключа;
* [ ] пара создана из правильного направления и настроена отдельно;
* [ ] стратегия, фильтры и контрольная сумма объясняют выбранное предложение;
* [ ] рейтинг отличает сохранённый курс от расчёта по текущему снимку;
* [ ] шаг проверен до и после ближайшего обновления источника;
* [ ] журнал показывает причину отказа, а последний успех не принят за свежий рынок;
* [ ] фактический курс доказан через «Как сформирован курс».

Далее проверьте [актуальность, ориентацию и точность](https://docs.iexexchanger.com/learn/4.-kursy-i-napravleniya/04-verify-rates.md).
