# BestChange Parser

**BestChange Parser** — это инструмент, который автоматически отслеживает позиции вашего обменного пункта в мониторинге BestChange и корректирует курс обмена, чтобы удерживать нужную позицию в рейтинге.

После настройки система будет:

* получать актуальные курсы с BestChange через API
* находить позицию вашего обменного пункта среди конкурентов
* автоматически корректировать курс, чтобы удерживать заданную позицию

Например:

Если вы указали **Target Position = 6**, система сделает курс **на 0.0001% лучше**, чем у обменника, который сейчас находится на **6 месте**.

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

## Вкладка General

В этой вкладке выполняется **глобальная настройка парсера**.

### Enable Parser

**Enable Parser** — глобальный переключатель работы парсера.

Возможные значения:

* **Yes** — парсер включён и работает
* **No** — парсер отключён

Если переключатель выключен — парсер **не будет обрабатывать ни одно направление**, даже если они активны.

### BestChange API Key

**BestChange API Key** — ключ доступа к API BestChange.

Через этот ключ система получает:

* список валют
* список обменников
* текущие курсы
* позиции обменников

#### Где взять API ключ

API ключ выдается в личном кабинете и описан в документации BestChange API.

<figure><img src="https://2391054755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKqXT4jWa7TDQpKKq2Yaf%2Fuploads%2Fm210OGynX7w4ktNsFZcW%2F%D0%97%D0%BD%D1%96%D0%BC%D0%BE%D0%BA%20%D0%B5%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-10%20%D0%BE%2011.05.10.png?alt=media&#x26;token=88e18479-4483-4533-9482-7ca0e3bfada9" alt=""><figcaption></figcaption></figure>

Пример тестового ключа:

```
20cfsnaf25501bscjdsadodsowe255es
```

Пример запроса:

```
https://www.bestchange.app/v2/20cfsnaf25501bscjdsadodsowe255es/currencies/
```

Документация API:\
<https://www.bestchange.app/>

### Your BestChange Changer ID

**Changer ID** — это уникальный идентификатор вашего обменного пункта в системе BestChange.

Он нужен парсеру, чтобы:

* определить **ваш обменник в списке**
* определить **вашу текущую позицию**
* корректно сравнивать курсы с конкурентами

#### Где узнать свой Changer ID

Получить ID можно через API BestChange.

Откройте ссылку:

```
https://www.bestchange.app/v2/ВАШ_API_KEY/changers/
```

Пример:

```
https://www.bestchange.app/v2/20cfsnaf25501bscjdsadodsowe255es/changers/
```

В ответе API будет список обменников, например:

```
{
 "id": 1234,
 "name": "YourExchange"
}
```

Число **id** и есть ваш **Changer ID**, который нужно указать в админ-панели.

## Вкладка Directions

Во вкладке **Directions** настраиваются направления обмена, для которых будет работать парсер.

Вы можете добавить **неограниченное количество направлений**.

### Direction

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

Пример:

```
USDCERC20 -> BTC
```

Это означает:

* отдаём **USDC ERC-20**
* получаем **BTC**

Парсер будет анализировать **конкурентов именно по этому направлению** на BestChange.

### Target Position (1–40)

**Target Position** — позиция в рейтинге BestChange, которую нужно удерживать.

Допустимый диапазон:

```
1 — 40
```

Пример:

```
2
```

Это означает:

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

Алгоритм работы:

1. парсер получает список обменников по направлению
2. определяет курс обменника на нужной позиции
3. устанавливает курс **на 0.0001% выгоднее**
4. обновляет курс 1 раз в минуту

### Active

**Active** — включает или выключает парсер для конкретного направления.

Возможные значения:

* **Yes** — парсер работает
* **No** — направление игнорируется

Важно:

Даже если направление активно, парсер **не будет работать**, если глобальный переключатель **Enable Parser = No**.

## Как работает парсер

Алгоритм работы:

1. Запускается cron-задача.
2. Система отправляет запрос к API BestChange.
3. Получает список курсов по направлению.
4. Определяет позицию вашего обменника.
5. Если позиция ниже заданной — система корректирует курс.

Все действия записываются в таблицу:

```
HistoryExecution
```

Там хранится:

* время выполнения
* направление
* полученные курсы
* новая позиция
* изменения курса

Это позволяет **отслеживать работу парсера и историю изменений**.

## Стоимость плагина

Плагин **BestChange Parser** является платным.

Стоимость:

```
40$ / месяц
```

Также доступен **бесплатный пробный период 14 дней**.