> 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/istochniki/kursy-iz-istochnikov.md).

# Курсы из источников

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

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

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

Среди поддерживаемых источников доступны:

* Binance
* ByBit
* CoinMarketCap
* Rapira
* WhiteBit
* MEXC
* CryptoCash
* Центральный банк РФ
* Moex
* и другие источники данных

***

## Подключение источника

Для начала работы перейдите в раздел: **«Парсер курсов» — «Курсы из источников»**

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

В левой части страницы отображается список всех доступных источников.

Для подключения источника найдите необходимый сервис и включите его с помощью переключателя статуса.

После активации источник начнёт участвовать в автоматическом обновлении курсов.

Для каждого источника дополнительно отображается:

* количество курсов;
* дата последнего обновления;
* статистика обновления;
* количество ошибок;
* процент успешного получения данных;
* назначенный прокси-сервер.

## Добавление нового курса

После выбора источника нажмите кнопку **«Добавить пару»**.

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

В открывшейся форме заполните необходимые поля.

{% stepper %}
{% step %}

#### Источник

Выберите сервис, с которого будет производиться загрузка курсов. Например, CoinMarketCap, Rapira, Binance и др.
{% endstep %}

{% step %}

#### Код Отдаю

Укажите код валюты или криптовалюты, курс которой вы хотите получить. Например, BTC.
{% endstep %}

{% step %}

#### Код Получаю

Укажите код валюты или криптовалюты, по отношению к которой будет рассчитываться курс. Например, USD или USDT.
{% endstep %}

{% step %}

#### Знаки после запятой

Определите количество знаков после запятой для точности расчётов. Рекомендуемое значение: не менее 8–10 знаков.
{% endstep %}

{% step %}

#### Тип парсинга

Выберите подходящий тип парсинга:

* **Серверный (основной тип)**\
  Курс загружается напрямую из внешнего источника (например, CoinMarketCap или Binance).\
  Пример: BTC – USD, система напрямую получает курс 1 BTC = 10 000 USD.\
  Используйте серверный парсинг всегда первым, он является основой для внутреннего.
* **Внутренний (вспомогательный тип)**\
  Создаёт курс на основе уже имеющегося серверного курса путём расчета формулы: 1 ÷ Серверный курс.\
  Пример: Уже загружен серверный курс BTC – USD (1 BTC = 10 000 USD). Для получения курса USD – BTC выберите тип парсинга «Внутренний». Система автоматически рассчитает: 1 ÷ 10 000 = 0,0001.
  {% endstep %}

{% step %}

#### Статус

Активируйте статус («Активен») для регулярного автоматического обновления курса пары.
{% endstep %}

{% step %}

#### Разрешить добавить обратную пару

Включите опцию, чтобы система автоматически создала обратную пару. Например, если вы добавили пару BTC → USD, то после активации этой опции добавится и пара USD → BTC. Это избавит вас от необходимости вручную создавать обратные пары и значительно сэкономит время.
{% endstep %}
{% endstepper %}

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

## Массовая загрузка курсов

Для некоторых источников доступна автоматическая загрузка всех поддерживаемых курсов.

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

Для этого:

1. Выберите источник.
2. Нажмите кнопку **«Прокси / Действия».**
3. Выберите пункт **«Загрузить все курсы».**

После выполнения операции система автоматически добавит все доступные курсы выбранного источника.

{% hint style="info" %}
Обратите внимание: данная возможность поддерживается не всеми поставщиками данных.
{% endhint %}

## Использование API-ключей

Некоторые источники требуют наличие API-ключей.

{% hint style="info" %}

### Рекомендации для CoinMarketCap

Бесплатные API-ключи имеют ограничения по количеству запросов.

Если используется большое количество курсов, рекомендуется добавить несколько API-ключей.

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

Для крупных проектов рекомендуется использовать платные тарифы CoinMarketCap.
{% endhint %}

Например:

* CoinMarketCap
* Fixer API

{% content-ref url="/pages/MSjkeFcrgviNHeXIgvfh" %}
[CoinMarketCap API Keys](https://docs.iexexchanger.com/guide/kursy/istochniki/kursy-iz-istochnikov/coinmarketcap-api-keys.md)
{% endcontent-ref %}

Для управления ключами нажмите кнопку «API-ключи».

В данном разделе доступны следующие действия:

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

## Использование Proxy

Для отдельных источников может потребоваться использование прокси-сервера.

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

Прокси позволяют:

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

Для настройки прокси:

{% content-ref url="/pages/tmEryY8Ho8y1wvpgwTTh" %}
[Прокси-менеджер](https://docs.iexexchanger.com/guide/utility/proksi-menedzher.md)
{% endcontent-ref %}

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

Рядом с прокси отображается его текущий статус. Для стабильной работы рекомендуется использовать только активные прокси-серверы.

## История изменений и аналитика

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

Для каждого курса доступна история изменения значений.

Чтобы открыть историю, нажмите кнопку «История данных» напротив нужного курса.

В открывшемся окне отображается график изменения курса за выбранный период времени.

Для получения расширенной информации используйте раздел «Полная аналитика».

В данном разделе доступны:

* история изменения курса;
* статистика за последние 24 часа;
* количество изменений;
* процент изменения курса;
* дополнительная аналитическая информация.

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

## Использование курсов в формулах

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

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

Например: `[binance_btc-usdt]`

Данные теги можно использовать в разделе: **«Парсер курсов» — «Курсы по формуле»**

{% content-ref url="/pages/WQ7Sr26pHTEFr2jwAscq" %}
[Формулы](https://docs.iexexchanger.com/guide/kursy/formuly.md)
{% endcontent-ref %}

Пример формулы:

```
[binance_btc-usdt] * [coinmarketcap_usdt-rub]
```

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

## Привязка курса обмена к направлению

После создания курса в разделе **«Парсер курсов» — «Курсы из источников»** его можно использовать в направлениях обмена.

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

Например, если направление использует курс BTC - USDT, то после обновления данного курса в источнике направление автоматически получит новое значение без необходимости ручного редактирования.

{% stepper %}
{% step %}

### Переход к настройке направления

Перейдите в раздел: **«Основное» — «Направления обмена» — «Список направлений»**

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

Найдите необходимое направление обмена и нажмите кнопку «Изменить».

Например:

* Tether ERC20 USDT - Bitcoin BTC
* T-Банк RUB - Bitcoin BTC
* Tron TRX - Tether ERC20 USDT
  {% endstep %}

{% step %}

### Настройка курса обмена

После открытия направления перейдите в раздел: **«Обмен» — «Курс обмена»**

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

На данной странице расположены все доступные способы получения курса:

* Курс из источников
* Ручной курс обмена
* Курс по формуле
* Курс обмена из файла
* Курс конкурента

Для использования данных из внешних источников необходимо заполнить поле «Курс из источников».
{% endstep %}

{% step %}

### Выбор курса

Нажмите на поле **«Курс из источников».**

Откроется список всех доступных курсов, ранее созданных в разделе **«Парсер курсов» — «Курсы из источников».**

Курсы автоматически группируются по источникам.

Например:

**ByBit**

* BTC - USDT
* USDT - BTC

**Binance**

* BTC - USDT
* ETH - USDT
* TRX - USDT

Для быстрого поиска используйте строку поиска в верхней части списка.
{% endstep %}

{% step %}

### Сохранение настроек

После выбора необходимого курса нажмите кнопку «Сохранить» в верхней части страницы.

С этого момента направление начнёт использовать данные выбранного источника.

Дополнительных действий не требуется.
{% endstep %}
{% endstepper %}
