> 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-faila.md). # Курсы из файла Модуль **«Курсы из файла»** позволяет автоматически получать и обновлять курсы валют, криптовалют и платёжных систем из внешнего файла по ссылке.
Достаточно разместить файл с курсами на вашем сервере, в облачном хранилище или любом другом доступном месте, после чего система самостоятельно будет загружать данные и обновлять курсы в обменном пункте. Данный способ особенно удобен в случаях, когда: * курсы формируются сторонней системой; * используется собственный сервис генерации курсов; * необходимо получать данные от партнёров через файл; * требуется использовать курсы без подключения API. После настройки все обновления выполняются автоматически без участия администратора. ## Как работает система Работа модуля состоит из нескольких этапов: {% stepper %} {% step %} ### Подготовка файла Вы создаёте файл с курсами и размещаете его по прямой ссылке. {% endstep %} {% step %} ### Добавление источника В панели управления создаётся источник, содержащий ссылку на файл. {% endstep %} {% step %} ### Добавление курсов Для каждого курса указывается название пары, которое должно совпадать с названием пары внутри файла. {% endstep %} {% step %} ### Автоматическое обновление Система регулярно скачивает файл, находит необходимые пары и обновляет значения курсов. {% endstep %} {% step %} ### Использование курсов После загрузки курсы можно: * использовать в направлениях обмена; * использовать в формулах; * использовать совместно с другими источниками данных. {% endstep %} {% endstepper %} ## Поддерживаемые форматы файлов Система поддерживает следующие форматы:
ФорматОписание
TXTРекомендуемый формат. Поддерживает простые и сложные расчёты.
CSVТабличный формат с разделением значений по колонкам.
JSONСтруктурированный формат хранения данных.
Для большинства проектов рекомендуется использовать формат **TXT**. ## Добавление источника Перед созданием курсов необходимо добавить источник файла. Для этого перейдите в раздел: **«Парсер курсов» — «Курсы из файла»** После этого нажмите кнопку **«Источники».** Откроется список всех добавленных источников. Для создания нового источника нажмите кнопку **«Добавить источник».** ### Настройка источника
{% stepper %} {% step %} ### Название Укажите произвольное название источника. Например: * Основной файл курсов * Курсы партнёра * Курсы обменника * Внешний источник Название используется только для удобства управления в панели управления. {% endstep %} {% step %} ### Ссылка Укажите прямую ссылку на файл с курсами. Пример: `https://example.com/rates.txt` После сохранения система проверит доступность файла и автоматически определит его формат. {% endstep %} {% step %} ### Список источников В окне источников отображается дополнительная информация: * название источника; * ссылка на файл; * количество подключённых курсов; * статус доступности файла; * тип файла; * размер файла. Также доступны следующие действия: * редактирование источника; * удаление источника; * поиск по списку источников. {% endstep %} {% endstepper %} ## Добавление курса После создания источника нажмите кнопку **«Добавить пару».**
В открывшейся форме заполните следующие поля. {% stepper %} {% step %} ### Источник Выберите ранее созданный источник. Если источник ещё не создан, его можно добавить непосредственно из формы выбора. {% endstep %} {% step %} ### Название Укажите название курса. Например: * BTC - USDT * USD - RUB * ETH - USDT * TRX - RUB Название курса должно полностью совпадать с названием внутри файла. Если названия различаются, система не сможет найти необходимый курс во время обновления. {% endstep %} {% step %} ### Количество знаков после запятой Определяет точность хранения и отображения курса. Для большинства криптовалют рекомендуется использовать от 8 до 10 знаков после запятой. {% endstep %} {% step %} ### Статус Определяет, будет ли курс участвовать в автоматическом обновлении. Если курс отключён, система не будет использовать его при расчётах. {% endstep %} {% endstepper %} ## Проверка курса Во время создания или редактирования система автоматически проверяет указанную пару.
Проверяется: * доступность файла; * корректность названия пары; * наличие пары внутри файла; * найденное значение; * строка, в которой обнаружен курс. Если пара успешно найдена, система покажет информацию о найденном значении. Если пара отсутствует в файле, будет отображено соответствующее предупреждение. Это позволяет сразу убедиться в корректности настройки до сохранения курса. ## Использование курсов в формулах Каждый курс автоматически получает собственный тег. Например: `[fileparser_main_btc-usdt]` или `[fileparser_main_usd-rub]` Данные теги можно использовать в разделе: **«Парсер курсов» — «Курсы по формуле»** Пример: ``` [fileparser_main_btc-usdt] * 1.02 ``` Таким образом курсы из файла можно использовать совместно с курсами из источников, конкурентами и коэффициентами. ## Привязка курса к направлению обмена После создания курса его можно использовать в направлениях обмена. Это позволяет автоматически применять значения из файла при расчёте обменов. После обновления файла направление автоматически получит новое значение курса без необходимости ручного редактирования. {% stepper %} {% step %} ### Переход к настройке направления Перейдите в раздел: **«Основное» — «Направления обмена» — «Список направлений»**
Найдите необходимое направление обмена и нажмите кнопку **«Изменить».** Например: * Tether ERC20 USDT - Bitcoin BTC * Т-Банк RUB - Bitcoin BTC * Tron TRX - Tether ERC20 USDT {% endstep %} {% step %} ### Настройка курса обмена После открытия направления перейдите в раздел: **«Обмен» — «Курс обмена»**
На данной странице доступны все способы получения курса: * Курс из источников * Ручной курс обмена * Курс по формуле * Курс обмена из файла * Курс конкурента Для использования данных из файла необходимо заполнить поле «Курс обмена из файла». {% endstep %} {% step %} ### Выбор курса Нажмите на поле **«Курс обмена из файла».** Откроется список всех курсов, ранее созданных в разделе «Парсер курсов» — «Курсы из файла». Если курсов много, воспользуйтесь строкой поиска и начните вводить название необходимого курса. Например: * BTC - USDT * USD - RUB * USDT - RUB {% endstep %} {% step %} ### Сохранение настроек После выбора курса нажмите кнопку **«Сохранить».** С этого момента направление начнёт использовать данные выбранного курса из файла. Дополнительных действий не требуется. {% endstep %} {% endstepper %} ## Рекомендации Для стабильной работы рекомендуется: * использовать только прямые ссылки на файлы; * следить за доступностью файла; * использовать одинаковые названия курсов в файле и системе; * регулярно проверять дату последнего обновления; * не изменять названия курсов после настройки без необходимости; * использовать формат TXT для максимальной совместимости. ## Вопросы и ответы
Можно ли использовать один файл для нескольких курсов? Да. Один источник может содержать любое количество курсов.
Можно ли использовать курсы из файла в формулах? Да. Каждый курс автоматически получает собственный тег и может использоваться в разделе «Курсы по формуле».
Почему курс не обновляется? Проверьте следующее: * файл доступен по ссылке; * курс присутствует внутри файла; * название курса полностью совпадает; * курс включён; * источник включён и доступен
Модуль **«Курсы из файла»** — это простой и эффективный способ автоматически загружать и обновлять курсы валют прямо из подготовленного вами файла. Вместо ручного ввода данных достаточно разместить актуальный файл по ссылке, и система сама обновит все курсы за несколько секунд. Это решение экономит ваше время, снижает вероятность ошибок и делает работу с обменными операциями ещё удобнее. ## Как это работает {% stepper %} {% step %} ### Подготовка файла Вы создаёте текстовый файл и добавляете туда курсы валют в нужном формате. {% endstep %} {% step %} ### Загрузка файла Вы размещаете файл по прямой ссылке в интернете (например, на вашем сервере или облачном хранилище). {% endstep %} {% step %} ### Автоматическая обработка Система самостоятельно скачивает файл, проверяет и обрабатывает данные, выполняет вычисления и обновляет базу данных. {% endstep %} {% step %} ### Готово Курсы валют обновлены и готовы к использованию. {% endstep %} {% endstepper %} *** ## Правила подготовки файла Файл должен иметь одно из расширений: `.txt`, `.csv` или `.json`. Система автоматически определяет тип файла по его расширению: * **.txt** — самый гибкий и функциональный формат. Поддерживает формулы, проценты, переменные и позволяет указать несколько валютных пар в одной строке. Рекомендуется к использованию. Пример содержимого `.txt` файла: * **csv** — простой формат, в котором валютные пары и их значения разделяются запятыми. * **.json** — структурированный формат, где курсы представлены парами ключ-значение. {% tabs %} {% tab title="TXT" %} ``` USD - RUB : 91.6 BTC - USDT, ETH - USDT : 61500 MAIN = BTC - USDT ETH - USD : (MAIN) + 10% USD - RUB : 91.6 BTC - USDT : 61505 RUB - USD : (USD - RUB) EUR - USD : 1.07 + 0.01 ETH - USDT : (BTC - USDT) + 5% ``` {% endtab %} {% tab title="CSV" %} ```csv BTC - USDT, 61500 ETH - USD, (BTC - USDT) - 2000 USD - RUB, 91.6 TRX - USD, (BTC - USDT) * 0.85 ``` {% hint style="warning" %} В CSV каждая строка должна содержать две колонки: валютная пара и значение. {% endhint %} {% endtab %} {% tab title="JSON" %} ```json { "BTC - USDT": 61500, "ETH - USD": "(BTC - USDT) - 2000", "USD - RUB": 91.6, "TRX - USD": "(BTC - USDT) * 0.85 + 1.5%" } ``` {% endtab %} {% endtabs %} Рекомендуется использовать формат `.txt`, так как он предоставляет максимальную гибкость и удобство для работы с более сложными формулами и расчётами. {% hint style="warning" %} ## Общие рекомендации * Размер файла не должен превышать 2 МБ * Кодировка файла — UTF-8 * Формулы могут включать: +, -, \*, /, %, скобки () * Можно использовать переменные и несколько пар в одной строке (только в .txt) * Названия валют (части валютных пар) должны начинаться с латинской буквы и могут содержать буквы (A-Z), цифры (0-9) и подчёркивание (\_). Максимальная длина каждой части валютной пары — 10 символов (первая буква + до 9 дополнительных символов). {% endhint %} *** ## Что может быть указано в файле? В файле можно указывать данные в самых разнообразных форматах: от простых числовых значений до сложных формул и выражений. Поддерживается гибкая математика, возможность применения переменных, расчёт процентов и указание нескольких пар в одной строке. Ниже перечислены примеры и пояснения по использованию каждого варианта. Это позволяет вам настроить курсы максимально точно и удобно, учитывая специфику вашего обменного сервиса. ### Файл поддерживает | Тип данных | Пример строки | Как это работает | | -------------------------------- | ----------------------------------------------- | ------------------------------------------------------------------------ | | Простое число | USD - RUB : 91.6 | Просто устанавливает указанный курс | | Математическое выражение | BTC - USDT : 61505 + 1 / 2 | Вычисляется формула, можно использовать +, -, \*, /, скобки | | Обратный курс | RUB - USD : (USD - RUB) | Пересчитывает как 1 / (USD - RUB) | | Использование процентов | EUR - USD : (USD - EUR) + 5% | Прибавляет 5% к рассчитанному значению (аналогично и - 3%, \* 120%) | | Несколько пар в строке | BTC - USDT, ETH - USDT : 61500 | Одно и то же значение применяется ко всем указанным парам | | Переменные (алиасы) | MAIN = BTC - USDTETH - USD : (MAIN) + 10 | Сохраняет значение переменной и использует её в дальнейших формулах | | Любой порядок строк | BTC - USD : (BTC - USDT) \* (USDT - USD) | Поддерживает зависимые вычисления. Очерёдность строк не имеет значения | | Автоисправление формата |

btc:usdt : 61000
btc -usdt : 61000

| Приводит названия валют в нужный формат: BTC - USDT | | Коды валют с подчёркиванием | USDT\_TRC20 - BTC : 61000 | Поддерживает сложные коды, например USDT\_ERC20, USD\_CASH, BTC\_TESTNET | | Математика с переменными |

VAL = BTC - USD
USD - RUB : (VAL) + 2

| Можно использовать переменные в любой части выражения | | Объединение выражений | BTC - USDT : ((BTC - USD) / (USDT - USD)) + 10 | Позволяет строить вложенные вычисления | | Произвольное количество пробелов | BTC - USDT : 61000 | Система сама нормализует отступы и пробелы | | Поддержка дробных и целых чисел | USD - RUB : 84, BTC - USD : 0.000024 | Поддерживаются значения с высокой точностью (до 18 знаков) | ### Файл не поддерживает Эти данные не будут обработаны (система просто их проигнорирует): | Что делать нельзя | Пример (неправильно) | Почему это неправильно | | ----------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Неправильный код валюты | 123BTC - USD : 100 | Код валюты должен начинаться с заглавной латинской буквы и содержать от 3 до 10 символов (A–Z, 0–9, подчёркивание). Код 123BTC — недопустим. | | Пропуск двоеточия : | USD - RUB 84.1 | После валютной пары обязательно должно быть двоеточие : — иначе строка не распознаётся. | | Не числовое значение | USD - RUB : семьдесят четыре | Значение курса должно быть числом или корректной формулой. Текст будет проигнорирован. | | Деление на ноль | USD - BTC : 1 / 0 | Вычисление вызывает ошибку. Результат будет 0, но в лог запишется предупреждение. | | Ссылка на несуществующую пару | RUB - USDT : (AAA - BBB) | Если (AAA - BBB) не была определена ранее — строка пропускается. | | Пустое значение | BTC - USDT : | Если значение отсутствует — строка игнорируется. | | Слишком длинный код валюты | LONG\_CURRENCY - USD : 123 | Код валюты должен содержать от 3 до 10 символов (первая буква + до 9 дополнительных символов). Код LONG\_CURRENCY превышает допустимую длину и будет проигнорирован. | *** ## Скорость обработки файла | Количество строк | Время загрузки (примерное) | | ---------------- | -------------------------- | | до 100 | 0.01 секунда | | до 500 | 0.05 секунд | | до 1000 | 0.1 секунда | | до 10 000 | около 0.5 секунд | *** ## Как начать использовать функцию «Курсы из файла»? {% stepper %} {% step %} ### Создайте файл Создайте простой текстовый файл (например: `kurcy.txt`) и вставьте туда курсы в правильном формате (см. выше). {% endstep %} {% step %} ### Загрузите файл Загрузите этот файл в любое место, где можно получить прямую ссылку (ваш сайт, сервер, облако). Пример ссылки: `https://вашсайт.com/kurcy.txt` {% endstep %} {% step %} ### Добавьте ссылку в систему Перейдите в административную панель или личный кабинет вашей системы, вставьте ссылку в соответствующее поле для функции **«Курсы из файла».** {% endstep %} {% step %} ### Запустите обновление Система автоматически скачает файл и обработает данные. {% endstep %} {% endstepper %} *** ## Какие математические операции можно использовать?
ДействиеЗнакПример записиКак считается?Результат
Сложение+BTC - USD : 25000 + 1025000 + 1025010
Вычитание-EUR - USD : 1.1 - 0.051.1 - 0.051.05
Умножение*ETH - USD : 1500 * 21500 × 23000
Деление/BTC - EUR : 25000 / 225000 ÷ 212500
Процент%USD - EUR : 1 + 5%1 + 5% (от 1) → 1 + 0.051.05
Скобки( )RUB - USD : (USD - RUB)1 ÷ (USD - RUB)обратный курс
{% hint style="info" %} ## Использование скобок ( ) для расчётов: Вы можете использовать скобки, чтобы сослаться на значение другой валютной пары. **Например:** * USD - RUB : 74.1 * RUB - USD : (USD - RUB) В этом случае курс RUB - USD будет автоматически рассчитан как обратное значение курса USD - RUB. {% endhint %}
Что такое «обратный курс»? Например, если у вас уже известен курс пары: * **BTC - USD : 25000** Это значит, что 1 биткоин стоит 25000 долларов. Теперь вам нужен обратный курс, то есть сколько долларов стоит 1 биткоин и наоборот. Чтобы не считать вручную, вы просто указываете обратную пару таким образом: * **USD - BTC : (BTC - USD)** Система автоматически понимает это как команду: «возьми уже существующий курс пары BTC - USD и рассчитай его обратное значение». Расчёт выглядит так: ```bash USD - BTC = 1 / (BTC - USD) = 1 / 25000 = 0.00004 ``` Таким образом, указывать (BTC - USD) — это удобный и простой способ сообщить системе, что нужно автоматически рассчитать обратный курс на основе уже имеющегося курса валютной пары.
*** ## Настройка в панели управления В разделе **«Парсер курсов — Курсы из файла»** вы можете настроить автоматическую загрузку курсов валют из заранее подготовленного файла.
Это удобное решение позволяет быстро и без ошибок загружать актуальные курсы, избавляя вас от необходимости вручную вводить данные. Система скачивает указанный вами файл по ссылке, распознаёт его содержимое и автоматически обновляет курсы валютных пар, которые вы добавили в систему. Названия пар в файле и в вашей системе должны полностью совпадать. В панели управления откройте раздел «Парсер курсов — Курсы из файла». Здесь вы можете добавить валютные пары и указать ссылку на файл с курсами. Названия валютных пар должны полностью совпадать с названиями пар, указанными внутри вашего файла курсов. Система автоматически загрузит курсы из указанного файла, обработает их и обновит все добавленные вами валютные пары.
### Добавление новой валютной пары Чтобы добавить новую валютную пару из файла, нажмите кнопку **«Добавить пару»**, расположенную в правом верхнем углу страницы.
Затем заполните открывшуюся форму:
* **Источник —** Выберите ранее добавленный источник файла курсов или создайте новый, указав название и прямую ссылку на ваш файл. * **Название —** Введите название валютной пары точно так же, как указано в вашем файле, соблюдая все пробелы и символы. *(Например: BTC - USD)* * **Знаки после запятой —** Укажите количество знаков после запятой для отображения курса. Рекомендуется использовать не менее 8-10 знаков, чтобы обеспечить точность расчётов. * **Статус —** Установите статус пары. Пары с отключённым статусом не будут автоматически обновляться и использоваться в расчётах. ### Добавление нового источника
Если у вас ещё нет подходящего источника, создайте его прямо в форме добавления пары: * В поле **«Название»** укажите удобное для вас название нового источника. * В поле **«Ссылка»** вставьте прямую ссылку на заранее подготовленный файл с курсами. После нажатия на кнопку «Добавить источник» новый источник станет доступен для выбора при добавлении следующих пар. *** ## Привязка курса валют из файла к направлению После загрузки и настройки курсов из файла необходимо привязать их к конкретным направлениям обмена. Это обеспечит автоматическое и регулярное обновление курсов валют при совершении операций обмена на вашем сервисе. Выполните указанные ниже шаги, чтобы легко и быстро подключить актуальные курсы из файла к нужным направлениям. {% stepper %} {% step %} ### Выберите направление обмена В панели управления перейдите в раздел **«Основное — Направление обмена — Список направлений».**
Найдите необходимое направление (например, *Сбербанк RUB → Bitcoin BTC*) и нажмите **значок ✏️ (карандаш)** для редактирования. {% hint style="info" %} **Совет:** используйте поиск или фильтры по статусам, если не можете найти направление. {% endhint %} {% endstep %} {% step %} ### Переход к настройке курса обмена В открывшемся меню слева перейдите: **«Обмен — Курс обмена»**
В разделе **«Курс обмена из файла»** откройте выпадающий список и выберите нужный курс валюты из ранее загруженных данных (например, USD - RUB или BTC - USDT). Если список слишком большой, начните вводить название валютной пары, чтобы быстро найти нужный курс. {% endstep %} {% step %} ### Сохранение изменений Убедитесь, что выбранный курс из файла корректно отображается в поле «Курс обмена из файла», затем нажмите кнопку **«Сохранить»**, чтобы применить изменения. {% endstep %} {% step %} ### Проверка работы привязанного курса После сохранения обязательно убедитесь в корректности настройки: 1. Перейдите обратно в общий список направлений обмена. 2. Проверьте, что у выбранного вами направления отображается актуальный курс из файла. 3. Рекомендуется выполнить тестовый обмен, чтобы убедиться в правильности и точности расчётов. {% endstep %} {% endstepper %} --- # 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/guide/kursy/istochniki/kursy-iz-faila.md?ask=&goal= ``` `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.