Курсы из файла

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

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

Как это работает

Правила подготовки файла

Файл должен иметь одно из расширений: .txt, .csv или .json. Система автоматически определяет тип файла по его расширению:

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

  Пример содержимого .txt файла:

• csv — простой формат, в котором валютные пары и их значения разделяются запятыми.

• .json — структурированный формат, где курсы представлены парами ключ-значение.

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%

BTC - USDT, 61500
ETH - USD, (BTC - USDT) - 2000
USD - RUB, 91.6
TRX - USD, (BTC - USDT) * 0.85

{
  "BTC - USDT": 61500,
  "ETH - USD": "(BTC - USDT) - 2000",
  "USD - RUB": 91.6,
  "TRX - USD": "(BTC - USDT) * 0.85 + 1.5%"
}

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

Общие рекомендации

• Размер файла не должен превышать 2 МБ

• Кодировка файла — UTF-8

• Формулы могут включать: +, -, *, /, %, скобки ()

• Можно использовать переменные и несколько пар в одной строке (только в .txt)

Что может быть указано в файле?

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

Файл поддерживает

Файл не поддерживает

Эти данные не будут обработаны (система просто их проигнорирует):

Скорость обработки файла

Как начать использовать функцию «Курсы из файла»?

Какие математические операции можно использовать?

USD - BTC = 1 / (BTC - USD) = 1 / 25000 = 0.00004

Настройка валютных пар и файла курсов

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

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

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

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

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

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

Затем заполните открывшуюся форму:

• Источник — Выберите ранее добавленный источник файла курсов или создайте новый, указав название и прямую ссылку на ваш файл.

• Название — Введите название валютной пары точно так же, как указано в вашем файле, соблюдая все пробелы и символы. (Например: BTC - USD)

• Знаки после запятой — Укажите количество знаков после запятой для отображения курса. Рекомендуется использовать не менее 8-10 знаков, чтобы обеспечить точность расчётов.

• Статус — Установите статус пары. Пары с отключённым статусом не будут автоматически обновляться и использоваться в расчётах.

Добавление нового источника

Если у вас ещё нет подходящего источника, создайте его прямо в форме добавления пары:

• В поле «Название» укажите удобное для вас название нового источника.

• В поле «Ссылка на файл» вставьте прямую ссылку на заранее подготовленный файл с курсами.

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

Привязка курса валют из файла к направлению

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

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

1

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

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

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

Совет: используйте поиск или фильтры по статусам, если не можете найти направление.

2

Переход к настройке курса обмена

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

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

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

3

Сохранение изменений

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

4

Проверка работы привязанного курса

После сохранения обязательно убедитесь в корректности настройки:

1. Перейдите обратно в общий список направлений обмена.

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

3. Рекомендуется выполнить тестовый обмен, чтобы убедиться в правильности и точности расчётов.