Курсы по формуле

Автоматическое обновление курсов через CRON

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

Для этого перейдите по ссылке ниже и внимательно следуйте инструкциям на странице настройки. После того, как вы настроите задание, курсы начнут обновляться автоматически в заданное время. Если вы хотите убедиться в том, что курсы обновляются, перейдите по соответствующей ссылке и добавьте виджет «История обновления данных» на рабочий стол вашей панели управления. Без добавления задания в планировщик курсы валют обновляться не будут!

Настройка задач CRON

Модуль «Курсы по формуле» автоматически рассчитывает курсы валют и криптовалют по формулам, которые вы создаёте самостоятельно. Он позволяет:

• Использовать данные из различных источников:

  • Биржи (Rapira, Binance и другие)

  • Курсы конкурентов

  • Загруженные файлы в формате TXT

• Создавать формулы, которые автоматически обновляют курсы.

• Использовать коэффициенты (шаблоны формул и фиксированные значения), чтобы упростить и ускорить работу.

---

Откуда брать данные для формул?

Данные для формул доступны в разделах:

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

• Курсы конкурентов

• Курсы из файла (TXT-формат)

Под каждым курсом вы увидите специальный код, например:

[rapira_btc-usdt_ask]
[competitor_usdt-rub]
[file_usdt-rub]

Важно

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

---

Пошаговое создание формулы

Перейдите в раздел «Курсы по формуле» и нажмите кнопку «Добавить формулу».

Заполните необходимые поля:

• Название (понятное вам название курса, например: BTC - RUB)

• Формула (математическое выражение с кодами)

• Знаки после запятой (например: 10)

• Статус («Включен», чтобы заработала сразу после создания)

Пример заполнения:

• Название: BTC в рублях

• Формула:

[rapira_btc-usdt_ask] * [russiancentralbank_usd-rub]

• Знаки после запятой: 10

• Статус: Включен

Правила написания формул (проверьте перед созданием!)

Формулы поддерживают:

• Коды курсов: [rapira_btc-usdt_ask]

• Числа: целые или дробные (100, 0.5, 1.05)

• Проценты: (10% автоматически считается как 0.1)

• Операции: сложение (+), вычитание (-), умножение (*), деление (/)

• Скобки: (( )) для порядка операций

Обязательно проверьте

• Правильность написания всех кодов.

• Все скобки открыты и закрыты правильно.

• Отсутствие деления на ноль.

---

Подробные примеры формул (с пояснениями):

Пример №1: Курс BTC к RUB через USDT

Формула:

[rapira_btc-usdt_ask] * [russiancentralbank_usd-rub]

Это прямой курс, биткоин (BTC) переводим в рубли через курс доллара.

Пример №2: Обратный курс RUB - BTC

Формула:

1 / ([rapira_btc-usdt_ask] * [russiancentralbank_usd-rub])

Получаем, сколько BTC можно купить за 1 рубль.

Пример №3: Средний курс конкурентов

Формула:

([competitor1_btc-usdt] + [competitor2_btc-usdt]) / 2

Среднее значение курсов двух конкурентов.

Пример №4: Курс BTC с учётом комиссии (1.5%)

Формула:

[rapira_btc-usdt_ask] * [russiancentralbank_usd-rub] * 98.5%

ВАЖНОЕ УВЕДОМЛЕНИЕ

Хотя в заголовке указано «1.5%», в формуле используется значение 98.5%, потому что формула должна учитывать остаток после комиссии.

Пример расчёта: 100% - 1.5% = 98.5%.

Если вам нужно использовать комиссию 2%, тогда пишите 98%.

---

Что такое коэффициенты и зачем они нужны?

Коэффициенты — это вспомогательные формулы или фиксированные значения. Они нужны, чтобы:

• Упростить длинные или сложные формулы.

• Использовать одно и то же выражение в разных местах, не копируя каждый раз.

Название коэффициента должно быть только на английском языке.

Это необходимо, так как система автоматически генерирует уникальный код индекса на основе указанного вами названия. Формат сгенерированного индекса всегда такой: [index_your-coefficient-name]

Примеры правильных названий и кодов:

Название коэффициента (на английском)	Код коэффициента (индекс)
BTC-RUB	[index_btc-rub]
usd-manual	[index_usd-manual]
eth-usdt	[index_eth-usdt]

Типы коэффициентов и когда их использовать

Есть два типа коэффициентов:

Тип коэффициента	Когда использовать?
Значение индекса	Для фиксированных значений (например, постоянный курс доллара)
Шаблон формулы	Для часто используемых формул (например, BTC - RUB)

Создание коэффициента: «Значение индекса»

Пошаговая инструкция:

1. Перейдите в раздел «Коэффициенты» и нажмите «Добавить коэффициент».

2. Заполните поля:

   • Название: Обязательно на английском языке (например: usd-manual)

   • Тип индекса: выберите «Значение индекса»

   • Сумма: Укажите число (например: 85.60)

   • Комментарий: Можно оставить пустым.

3. Нажмите «Добавить».

После добавления вы получите код коэффициента такого вида:

[index_usd-manual]

Теперь этот коэффициент доступен для использования во всех формулах.

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

Допустим, коэффициент [index_usd-manual] имеет значение 85.60.

[rapira_btc-usdt_ask] * [index_usd-manual]

Теперь при изменении курса доллара достаточно поправить только значение коэффициента, и все формулы пересчитаются автоматически.

Создание коэффициента: «Шаблон формулы» (рекомендуется!)

Пошаговая инструкция:

1. Перейдите в раздел «Коэффициенты» и нажмите «Добавить коэффициент».

2. Заполните поля:

   • Название: на английском языке (например: btc-rub)

   • Тип индекса: «Шаблон формулы»

   • Шаблон формулы: укажите формулу (например: [rapira_btc-usdt_ask] * [russiancentralbank_usd-rub])

   • Комментарий: можно оставить пустым.

3. Нажмите «Добавить».

После добавления вы получите уникальный код коэффициента:

[index_btc-rub]

Теперь этот коэффициент можно использовать в других формулах вместо повторения длинного выражения.

Пример использования :

Создан коэффициент [index_btc-rub] с формулой [rapira_btc-usdt_ask] * [russiancentralbank_usd-rub].

Формула без коэффициента (сложная и длинная):

1 / ([rapira_btc-usdt_ask] * [russiancentralbank_usd-rub])

Формула с коэффициентом (короткая и простая):

1 / [index_btc-rub]

Использование коэффициентов сильно упрощает и ускоряет работу, снижает вероятность ошибок.

Полезные советы и уведомления

• Всегда используйте только английский язык и дефисы (-) для разделения слов в названиях коэффициентов.

• Не создавайте несколько одинаковых коэффициентов, это усложнит управление.

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

• После любых изменений обязательно проверьте, корректно ли коэффициент рассчитывается.

---

Привязать формулу к направлению

Шаг 1: Переход к направлению обмена

1. Откройте панель управления.

2. Перейдите в раздел:

   «Основное — Направление обмена — Список направлений»

3. Найдите нужное вам направление обмена (например: «Сбербанк RUB → Банк. счёт THB»).

4. Чтобы изменить настройки этого направления, нажмите на значок ✏️ (карандаш).

   

Совет

Если не можете найти нужное направление, используйте поиск или фильтры по статусам (например, «Архивные», «Включенные»).

Шаг 2: Переход в раздел «Курс обмена»

После нажатия на значок ✏️ откроются настройки направления обмена.

1. Слева найдите раздел «Обмен» и нажмите на него.

2. Выберите подраздел «Курс обмена».

Теперь откроется форма настройки курса конкретного направления.

Шаг 3: Привязка созданной формулы

На странице настройки курса обмена вы увидите разные варианты:

• Курс из источников (если вы хотите использовать стандартные курсы)

• Ручной курс обмена (если вы хотите вручную задать курс)

• Курс по формуле (этот пункт вам нужен для привязки созданных формул)

Следуйте далее инструкции:

1. В блоке «Курс по формуле» найдите поле «Выберите курс по формуле» и нажмите на него.

   Вы увидите выпадающий список всех созданных ранее формул.

2. Выберите нужную вам формулу из этого списка (например, BTC - RUB).

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

Шаг 4: Сохранение изменений

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

• Формула должна быть явно указана в поле «Курс по формуле».

После этого нажмите кнопку «Сохранить».

Шаг 5: Проверка работы привязанной формулы

После сохранения обязательно проверьте, правильно ли работает формула:

1. Вернитесь в общий список направлений.

2. Убедитесь, что направление обмена активно и показывает корректный курс.

3. При необходимости, совершите тестовый обмен для полной проверки.

---

Частые вопросы:

Что делать, если формула не рассчитывается?

• Проверьте коды: все они должны быть написаны точно так же, как указаны в разделах.

• Убедитесь, что все курсы, использованные в формуле, существуют и включены.

• Проверьте, чтобы не было деления на ноль.

• Проверьте статус формулы (должен быть «Включен»).

Можно использовать данные из разных разделов одновременно?

Да, просто вставьте их коды в формулу.

Какую максимальную точность можно использовать?

До 18 знаков после запятой.

Что делать, если формула временно не нужна?

Переключите её статус в «Отключен».