Котировки

Эта страница является центральным хабом для управления всеми курсами валют (котировками) на вашем криптообменнике. Здесь отображается полный список всех имеющихся курсов, их ключевые параметры, и отсюда администратор может быстро добавлять, редактировать, активировать или деактивировать любой курс. Котировки - это курсы валют, которые ваш сайт использует для расчёта обмена, например 1 BTC = 102000 USDT, 1 USDT = 0.93 EUR и так далее, по сути, это основные данные, на которых строится весь обменный процес, если котировок нет - система не понимает, по какому курсу считать курсы валют.

Подробное описание элементов интерфейса:

  1. Кнопка "+ Добавить" в правом верхнем углу:

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

  2. Таблица существующих котировок:

    Это ядро страницы. Она предоставляет обзор всех курсов в системе в структурированном виде. Каждая строка — отдельная котировка. Колонки дают следующую информацию:

    • #: Уникальный числовой идентификатор котировки в базе данных. Критически важен для технической идентификации записи. Сортируются по умолчанию от нового к старому.

    • Группа: Название группы, к которой привязана данная котировка. Группы служат для логической сортировки курсов (например, "Направления USDT", "Направления BTC", "Фиатные гривневые направления"). Это значительно упрощает поиск нужного курса, когда их очень много. Название группы доступно быстрой фильтрации по группам котировок.

    • Формула: Самое важное поле. Отображает математическое выражение, с помощью которого рассчитывается конечный курс для данного направления обмена. Это может быть как статическое число (например, 40), так и динамическая формула, состоящая из произведения других котировок (например, Whitebit:BTC_USDT * USDTTRC20_P24UAH). Система автоматически вычисляет эту формулу в реальном времени для конвертации.

    • Значение: Уже рассчитанный курс по созданной вами формуле, на скриншоте ниже вы можете наблюдать примеры уже рассчитанных значений, важно понимать, что они не есть окончательными, и если в вашей формуле есть волатильные, то есть постоянно меняющие курс монеты или валюты, в системе они также будут обновлять свой курс относительно актуального, поэтому вам не стоит переживать о том, что вы вчера могли создать котировку Bitcoin - USDT по цене 90.000$ за 1 единицу BTC, а сегодня его цена превысила 100.000$ за единицу и вам придётся создавать или обновлять котировку по-новому. Статические котировки будут неизменными в том случае, если вы создадите котировку без формулы, просто со значением, например, “10”.

    • Действия (Колонка "Операции"):

      • Иконка "Карандаш" (Редактировать): Нажатие на эту иконку открывает форму редактирования выбранной котировки, где можно изменить все параметры: формулу, группу, статус.

      • Иконка "Корзина" (Удалить): Удаляет выбранную котировку из системы. Это действие следует выполнять осторожно, поскольку оно может быть необратимым. Система запрашивает подтверждение перед удалением.

Практическое применение: Администратор заходит на эту страницу, чтобы убедиться, что все курсы актуальны. Он может быстро найти котировку по названию группы, проверить её формулу и, при необходимости, выключить её для технического обслуживания или отредактировать, если курс требует корректировки. И так, уже зная обозначения полей котировок, приступим к непосредственному созданию одной из них, разберём весь путь до создания направления обмена на примере нескольких направлений обмена. Для создания котировки нам необходимо сначала создать группу в меню Группы, нажав на кнопку “+Добавить”, мы направимся на страничку, где необходимо заполнить поля с названием нашей группы, и описанием комфортным для нас, и соответствующим данной котировке.

Далее, возвращаясь в раздел Котировки, также жмём “+Добавить”

Форма добавления/редактирования котировки

  1. Попав в соответсвующее меню нам необходимо прописать формулу подходящую под наши требования по созданию, а именно: В первом поле “Формула” мы прописываем первоначальную формулу расчёта, где первое слово всегда означает источник курса, в нашем случае это биржа WhiteBit, это также может быть и другая биржа, например Binance, через двоеточие мы прописываем первую расчётную формулу, а именно курс BTC на стейблкоин USDT - Whitebit:BTC_USDT. После того как система распознает математический расчёт, он будет отображаться в скобках данной котировки.

  1. В случае если бы наше направление обмена было просто BTC на USDT нам было бы достаточно данной котировки, но так как нам необходимо иметь динамичекий расчёт BTC - PrivatBank24 UAH, нам необходимо совешить следующий шаг - создание условий для отображения курса второй половины формулы USDT-PrivatBank24 UAH. Для этого мы можем использовать либо существующий курсы по данной паре обмена из существующих динамических источников (Например Whitebit:USDT_UAH) что мы можем сделать сразу, нажав на кнопку "Выберите расчетную формулу",

либо, создать котировку со статическим значением под конкретную валюту выплаты, и под неё создавать в дальнейшем другие котировки которые всегда в формуле будут завязаны под ваше статическое значение, например - если вы создадите статическую котировку USDT - PrivatBank24 со значением "42", где 42 это единственная ваша статическая котировка, вы сможете завязать эту котировку под все последующие котировки для приёма этой валюты, например: Whitebit:BTC_USDT*(Название вашего сайта)USDT - PrivatBank24, Binance:ETH_USDT*(Название вашего сайта)USDT - PrivatBank24, где в случае изменения курса по которому вы можете совершать обмен, вы можете в ручную проводить изменения только одного значения котировки PrivatBank24, например с 42 на 41.5 или наоборот увеличить курс до 42.5 и ваши расчётные формулы по всем остальным направлениям завязанным под данную, будут также нести незамедлительные изменения в расчётном курсе. 3. И так, для создания статической формулы котировки, нам достаточно по предварительно созданной группе котировок создать новую котировку с удобным статическим значением по отношению к USDT, например 42 в случае UAH, 470 в случае KZT, 0.92 в случае EUR, 1 для создания котировки стабильной валюты для USD либо USDT, 32.5 в случае TRY (цифры есть лишь примерами, и не означают обязательное указание таких же при создании конкретной котировки, это лишь примерные соотношения стабильной монеты к валюте).

Создайте 2 котировки: Одну с формулой "42" и группой "UAH" Вторую с формулой "1" и группой "Stable" для использования котировки при создании валюты в дальнейшем После создания простой формулы, нажимайте опубликовать, чтобы котировка появилась в общем списке Котировок. 4. И так, на данном этапе ознакомления с разделом Котировки у нас должно быть 3 созданные котировку вручную - Whitebit:BTC_USDT, просто статическое значение под нужную нам валюту, в нашем случае просто "42", и значение "1" которое мы будем использовать как котировку при создании валюты USDT(trc20). Следующий шаг если мы желаем иметь формулу расчёта на которую мы всегда сможем влиять - создание условий для отображения котировки следующей части расчётной формулы, а именно USDT_42 (USDT/42). Для этого нам необходимо создать 3 валюты в разделе админ-панели Общие - Валюты. Следуйте инструкции по заполнению полей описаной в разделе для создания следующих монет: BTC, USDT, P24UAH которые будут завязаны в дальнейшем в вашем направлении обмена - https://lara-script.gitbook.io/docs/ru/funkcional-admin-paneli/obshie/valyutyarrow-up-right 5. Если Вы уже прошли весь путь следуя инструкции описаной в разделах Валюты и Направления, значит вы снова вернётесь в раздел котировки, и по остаточному принципу, будете создавать новую котировку, где увидите непривычные для вас ранее формулы, а именно *Название Вашего сайта*:USDTTRC20_P24UAH, то есть новую формулу расчёта, которая будет тянуться из созданных вами направлений обмена на сайте, и именно с использованием этой формулы, все ваши направления завязанные под эту формулу можно будет удобно редактировать внося коррективы только в эдиную изначальную котировку для UAH с формулой "42"

В случае, когда требуется простая котировка (например, BTC → USDT), достаточно подключить один парсер.

Однако для более сложных направлений, где нет прямой котировки (например, BTC → UAH), используется формула с операциями умножения или деления:

  • Система берёт два котирования из разных источников (либо с бирж, либо из внутреннего Self Rate Provider).

  • Далее они между собой перемножаются или делятся, образуя финальный курс.

Пример:

  • Парсер №1: BTC_USDT (с Binance или WhiteBit).

  • Парсер №2: USDT_UAH (с биржи, из курса НБУ или с собственного сайта).

  • Результат: курс BTC → UAH = BTC/USDT × USDT/UAH.

Таким образом, можно формировать так называемое “дерево зависимых котировок” и в обратном направлении, когда одна котировка базируется на другой.

Последнее обновление