> 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/help-center/ai-docs/nastroika-obmena/rate-source-selection/bestchange.md).

# BestChange API парсер

BestChange-парсер получает рыночные предложения и рассчитывает базовый курс для связанного направления. Он не публикует ваш обменный пункт в мониторинге: публикация выполняется отдельным экспортом курсов.

Для работы требуется право «Разрешить управление BestChange парсером в админпанели».

## Общие настройки

В панели управления откройте:

**«Парсер курсов» — «BestChange API парсер»**

На открытой странице нажмите «Настройки».

### Подключение

Заполните:

* «API-ключ BestChange»;
* «Таймаут запроса (сек.)»;
* «Версия сайта»;
* «Тип курса»;
* «Прокси»;
* «Валюты»;
* «Города»;
* «Записывать ошибки»;
* общий статус.

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

«Rate» берёт чистый курс из списка. «RankRate» использует значение для сравнения с учётом доступных условий мониторинга. После смены типа пересмотрите позицию: порядок предложений может измениться.

### Способ расчёта

| Режим        | Как выбирается значение                       | Когда проверять особенно внимательно         |
| ------------ | --------------------------------------------- | -------------------------------------------- |
| «По позиции» | Строка с выбранной позиции                    | При частой смене состава верхних предложений |
| «Медиана»    | Ближайшая строка к медиане первых предложений | При одиночных выбросах                       |
| «Взвешенное» | Значение с учётом резервов первых предложений | При сильно различающихся резервах            |

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

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

«Ограничение обменников» имеет режимы:

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

«Разрешённые обменники» задают предпочтительный пул. «Исключённые обменники» и «Запретить обменники» исключают записи. Слишком строгий или пустой список может оставить пары без курса.

## Создание пары

Откройте:

**«Парсер курсов» — «BestChange API парсер»**

Нажмите «Добавить пару». Выберите готовое направление обмена и нажмите «Добавить». Затем откройте запись и настройте соответствующую пару, город, режим, позицию или количество лучших курсов, шаг и ограничения.

Пара должна совпадать с реальной услугой. Для наличного направления проверьте город; для онлайн-направления не назначайте случайный город.

## Позиция и шаг

В режиме «По позиции» указывается положительный номер или диапазон в формате, который принимает форма. «Шаг» допускает число, процент, умножение или деление, например:

* `2`;
* `-1.5`;
* `10%`;
* `-3%`;
* `*1.1`;
* `/2`.

Знак шага относится к числовому курсу. Он не гарантирует рост прибыли во всех ориентациях пары. После изменения сравните клиентскую сумму, а не только большее или меньшее число.

## Фильтры пары

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

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

## Рейтинг

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

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

## Список и массовые действия

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

«Массовое изменение» позволяет применить к выбранным или всем отфильтрованным записям:

* статус;
* позицию;
* шаг;
* способ расчёта и связанное значение.

Сначала примените изменение к одной тестовой паре. Для операции по фильтру повторно проверьте все условия выборки.

## Журнал ошибок

Откройте «Ещё» — «Лог ошибок». Журнал показывает направление, пару, причину, режим, поле курса, связанную запись и время.

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

## Проверка перед включением

1. Сохраните общие настройки без публикации пары.
2. Убедитесь, что справочники загрузились.
3. Создайте одну тестовую связь.
4. Откройте «Рейтинг».
5. Проверьте список после всех фильтров.
6. Сравните Rate и RankRate, если выбор неочевиден.
7. Проверьте шаг на контрольной сумме.
8. Включите запись.
9. Откройте «Как сформирован курс» направления.
10. Создайте тестовую заявку на `https://ваш_домен`.

## Если курс отсутствует

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


---

# 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/help-center/ai-docs/nastroika-obmena/rate-source-selection/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.
