Курсы из файла
Last updated
Was this helpful?
Last updated
Was this helpful?
Для корректного и регулярного автоматического обновления курсов валют обязательно добавьте специальное задание в планировщик задач (CRON).
Для этого перейдите по ссылке ниже и внимательно следуйте инструкциям на странице настройки. После того, как вы настроите задание, курсы начнут обновляться автоматически в заданное время. Если вы хотите убедиться в том, что курсы обновляются, перейдите по соответствующей ссылке и добавьте виджет на рабочий стол вашей панели управления. Без добавления задания в планировщик курсы валют обновляться не будут!
Функция «Курсы из файла» позволяет автоматически загружать и обновлять курсы валют в вашей системе из подготовленного текстового файла. Вместо того чтобы вручную вносить каждое значение, вы просто создаёте специальный файл, размещаете его по ссылке, и система сама скачивает и обновляет все курсы за несколько секунд.
Это решение значительно экономит ваше время и исключает ошибки, возникающие при ручном вводе.
Работа функции состоит из нескольких шагов:
Подготовка файла: Вы создаёте текстовый файл и добавляете туда курсы валют в нужном формате.
Загрузка файла: Вы размещаете файл по прямой ссылке в интернете (например, на вашем сервере или облачном хранилище).
Автоматическая обработка: Система самостоятельно скачивает файл, проверяет и обрабатывает данные, выполняет вычисления и обновляет базу данных.
Готово: Курсы валют обновлены и готовы к использованию.
Файл должен быть обычным файлом с расширением .txt, .csv или .json.
Система автоматически определит формат по расширению ссылки и обработает содержимое.
.txt — самый гибкий формат: поддерживает формулы, проценты, переменные и несколько пар в строке
.csv — пары и значения разделены запятой (например: BTC - USDT, 61500)
.json — данные в виде структуры: { "BTC - USDT": 61500 }
Если используется .txt, каждая строка должна описывать курс одной или нескольких валютных пар.
Например:
Общие рекомендации
Размер файла не должен превышать 2 МБ
Кодировка файла — UTF-8
Формулы могут включать: +, -, *, /, %, скобки ()
Можно использовать переменные и несколько пар в одной строке (только в .txt)
Простое число
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 :
Если значение отсутствует — строка игнорируется.
до 100
0.01 секунда
до 500
0.05 секунд
до 1000
0.1 секунда
до 10 000
около 0.5 секунд
Шаг 1: Создайте файл
Создайте простой текстовый файл (например: kurcy.txt) и вставьте туда курсы в правильном формате (см. выше).
Шаг 2: Загрузите файл
Загрузите этот файл в любое место, где можно получить прямую ссылку (ваш сайт, сервер, облако).
Пример ссылки: https://вашсайт.com/kurcy.txt
Шаг 3: Добавьте ссылку в систему
Перейдите в административную панель или личный кабинет вашей системы, вставьте ссылку в соответствующее поле для функции «Курсы из файла».
Шаг 4: Запустите обновление
Система автоматически скачает файл и обработает данные.
Сложение
+
BTC - USD : 25000 + 10
25000 + 10
25010
Вычитание
-
EUR - USD : 1.1 - 0.05
1.1 - 0.05
1.05
Умножение
*
ETH - USD : 1500 * 2
1500 × 2
3000
Деление
/
BTC - EUR : 25000 / 2
25000 ÷ 2
12500
Процент
%
USD - EUR : 1 + 5%
1 + 5% (от 1) → 1 + 0.05
1.05
Скобки
( )
RUB - USD : (USD - RUB)
1 ÷ (USD - RUB)
обратный курс
Используются для расчёта обратных курсов на основе уже указанного курса. Например: USD - RUB : 74.1 RUB - USD : (USD - RUB)
В панели управления откройте раздел «Парсер курсов — Курсы из файла». Здесь вы можете добавить валютные пары и указать ссылку на файл с курсами. Названия валютных пар должны полностью совпадать с названиями пар, указанными внутри вашего файла курсов.
Система автоматически загрузит курсы из указанного файла, обработает их и обновит все добавленные вами валютные пары.
Пример валютной пары:
BTC - USD
(название пары должно быть таким же, как в вашем файле)
Пример ссылки на файл:
https://вашсайт.com/kurcy.txt
Чтобы добавить новую пару, нажмите кнопку "Добавить пару" расположенную в правом вверхнем углу
На открывшейся окне, заполните представленную форму
Источник: Выберите источник, из которого будет происходить загрузка и парсинг курсов.
Название:
Введите название валютной пары точно так, как вы указали её в файле.
(Например: USD - RUB)
Знаки после, запятой:
Укажите точность отображения курса. Рекомендуемое значение — 10 знаков.
(Пример: курс 74.1234567890)
Статус:
Установите статус пары (Включен или Отключен). Неактивные пары не будут обновляться.
Добавление источника
Название: Укажите любое название источника
Ссылка на файл: Укажите ссылку, где у вас расположен файл курсов.
Откройте панель управления.
Перейдите в раздел:
«Основное — Направление обмена — Список направлений»
Найдите нужное вам направление обмена (например: «Сбербанк RUB → Банк. счёт THB»).
Чтобы изменить настройки этого направления, нажмите на значок ✏️ (карандаш).
Если не можете найти нужное направление, используйте поиск или фильтры по статусам (например, «Архивные», «Включенные»).
После нажатия на значок ✏️ откроются настройки направления обмена.
Слева найдите раздел «Обмен» и нажмите на него.
Выберите подраздел «Курс обмена».
Теперь откроется форма настройки курса конкретного направления.
На странице настройки курса обмена вы увидите разные варианты:
«Курс из источников»
«Ручной курс обмена»
«Курс по формуле»
«Курс обмена из файла» (вам нужен именно этот раздел)
Следуйте далее инструкции:
В блоке «Курс обмена из файла» найдите поле «Выберите курс из файла» и нажмите на него.
Откроется список загруженных ранее курсов:
Выберите нужный курс из списка, нажав на него (например, USD - RUB).
После выбора курса:
Убедитесь, что нужный курс корректно отображается в поле.
Нажмите на кнопку «Сохранить».
После сохранения обязательно проверьте, всё ли настроено правильно:
Вернитесь в общий список направлений обмена.
Проверьте, что направление отображает корректный курс из файла.
При необходимости сделайте тестовый обмен, чтобы убедиться в корректности расчётов.
