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

{% hint style="danger" %}

### Автоматическое обновление курсов через планировщик задач (CRON)

Чтобы курсы валют на вашем обменнике всегда были актуальными и автоматически обновлялись без вашего участия, необходимо настроить автоматическое обновление через специальный планировщик задач (CRON).

**Как настроить автоматическое обновление курсов:**

1. Перейдите по указанной ссылке на страницу **«Планировщик задач (CRON)».**
2. На открывшейся странице подробно описано, как правильно настроить CRON-задание. Чётко следуйте указанным инструкциям — это позволит вам настроить автоматическое обновление без ошибок.
3. После того как вы завершите настройку, курсы валют начнут обновляться автоматически, регулярно и без вашего участия.

**Как проверить работу автоматического обновления:**

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

* Перейдите в вашу панель управления и добавьте специальный виджет [«История обновления данных»](/osnovnye/parser-kursov/opcii/data-poslednego-obnovleniya-kursov.md) на рабочий стол.
* В этом виджете будет отображаться информация о последних обновлениях курсов валют и времени выполнения задачи.
  {% endhint %}

{% content-ref url="/pages/s3rmInlthvUrJ6o6R9Ut" %}
[Планировщик задач (CRON)](/nachalo-raboty/nastroiki-servera/planirovshik-zadach-cron.md)
{% endcontent-ref %}

***

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

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

***

## Начало работы с источниками

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

<figure><img src="/files/2dGC4JFVGh6kZOsm5xmZ" alt="" width="296"><figcaption></figcaption></figure>

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

<figure><img src="/files/qqrqyXcexNal84qmFZEh" alt=""><figcaption></figcaption></figure>

### Добавление новой пары

Для добавления новой пары валют или криптовалют, курсы которых будут автоматически обновляться из выбранного источника, нажмите кнопку **«Добавить пару»** и заполните форму:

<figure><img src="/files/AiBCgpN3A8HHwzSIDqNK" alt="" width="563"><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 %}

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

***

### Важное про API-ключи (для CoinMarketCap)

Источник **CoinMarketCap** требует использования API-ключей. Эти ключи могут иметь ограничения по количеству запросов:

* Бесплатные ключи позволяют делать ограниченное количество запросов в сутки. Если у вас много валютных пар, создайте сразу несколько ключей (рекомендуем 20-30 штук), чтобы не исчерпать лимиты.
* Платные тарифы CoinMarketCap имеют более высокие лимиты и подходят для большого количества валютных пар.

{% content-ref url="/pages/MSjkeFcrgviNHeXIgvfh" %}
[CoinMarketCap API Keys](/osnovnye/parser-kursov/opcii/coinmarketcap-api-keys.md)
{% endcontent-ref %}

{% hint style="info" %}

## Совет

Следите за лимитами вашего ключа в разделе «API Ключи». Если лимит превышен, система не сможет загрузить новые данные.
{% endhint %}

***

### Что делать, если валютная пара отсутствует в источнике?

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

{% content-ref url="/pages/WQ7Sr26pHTEFr2jwAscq" %}
[Курсы по формуле](/osnovnye/parser-kursov/kursy-po-formule.md)
{% endcontent-ref %}

Создайте валютную пару вручную, задав формулу расчета курса с учетом зависимости от других пар. Например, если в источнике нет пары USD – EUR, её можно создать через промежуточные пары, такие как USD – BTC → BTC – EUR.

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

### Советы по использованию источников

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

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

***

## Опции

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

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

#### Как массово загрузить курсы:

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

{% hint style="info" %}

## Обратите внимание:

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

Если у источника такой опции нет, то пары необходимо добавить вручную через кнопку **«Добавить пару».**
{% endhint %}

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

### Дополнительные возможности управления

Для более удобного управления списком валютных пар предусмотрены следующие опции:

#### Очистка и активация курсов:

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

#### Индивидуальное управление парами:

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

### Настройки отображения и сортировки списка курсов

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

* **Настройка колонок —** Используя значок колонок, выберите поля для отображения (например, название, курс обмена, дата обновления, статус), а также задайте количество записей на одной странице.
* **Сортировка пар —** Используя значок сортировки, выберите параметр и тип сортировки списка (по возрастанию или убыванию). Это поможет вам быстро найти нужные курсы и оптимизировать работу с ними.

***

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

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

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

1. В административной панели перейдите в раздел **«Другие разделы — Proxy Менеджер»**.
2. Создайте новый прокси-сервер и укажите все необходимые параметры.
3. После добавления прокси перейдите в раздел **«Парсер курсов — Курсы из источников»**.
4. В верхней части окна найдите выпадающий список **«Прокси / Действия • Прокси»**, и выберите необходимый прокси-сервер из списка.

Прокси-серверы помечаются статусом **«Активен»** или **«Неактивен».** Используйте только активные прокси, чтобы обеспечить корректную загрузку и обновление курсов.

***

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

Эта настройка позволяет автоматически применять актуальные курсы из внешних источников (Центральный банк, Binance, CoinMarketCap и др.) для конкретных направлений обмена. Вам больше не придется вручную следить за изменениями курсов, что значительно упростит работу и снизит риск ошибок.

Чтобы настроить привязку курса, следуйте инструкции ниже:

{% stepper %}
{% step %}

### Выберите направление обмена

<figure><img src="/files/HNoQzPWuaZcvcXkGZooQ" alt=""><figcaption></figcaption></figure>

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

Найдите необходимое направление (например, *Сбербанк RUB → Bitcoin BTC*) и нажмите **значок ✏️ (карандаш)** для редактирования.

{% hint style="info" %}
**Совет:** используйте поиск или фильтры по статусам, если не можете найти направление.
{% endhint %}
{% endstep %}

{% step %}

### Укажите курс из источника

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

<figure><img src="/files/49KTdR1mDcIuWYNFOKV4" alt=""><figcaption></figcaption></figure>

В блоке **«Курс из источников»** нажмите на поле выбора и найдите подходящий курс, который вы ранее загрузили из нужного источника (например, USD - RUB или BTC - USDT). Для удобства поиска начните вводить название валюты в поле выбора.

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

{% step %}

### Сохраните изменения

Для применения изменений нажмите кнопку **«Сохранить»** в нижней части страницы.
{% endstep %}

{% step %}

### Проверьте результат

Обязательно убедитесь, что курс успешно привязан:

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

Теперь выбранное направление обмена будет автоматически использовать актуальный курс из указанного источника.
{% endstep %}
{% endstepper %}

## Вопросы и Ответы

<details>

<summary>Зачем нужны коды пар?</summary>

Коды необходимы для модуля "[Парсер по формуле](/osnovnye/parser-kursov/kursy-po-formule.md)"

</details>


---

# 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/kursy-iz-istochnikov.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.
