Основные концепции
Краткий глоссарий для разработчиков, интегрирующих API. Актуальные цены и сетку тарифов всегда запрашивайте через API — данные ниже служат исключительно описанием принципов работы.
Энергия и пропускная способность (Energy & Bandwidth)
При каждой транзакции в сети TRON расходуются два типа ресурсов: энергия (расходуется при вызовах смарт-контрактов, включая переводы токенов TRC-20, таких как USDT) и пропускная способность (зависит от размера транзакции в байтах). Если ресурсов на адресе недостаточно, сеть сжигает TRX. Мы предоставляем аренду энергии и пропускной способности на фиксированное время и делегируем их в блокчейне на указанный вами адрес — средства остаются на вашем кошельке, а приватный ключ никогда не требуется.
Тарифы (Tiers)
Тир (Tier) — это временное окно аренды, обозначаемое длительностью: 5m, 15m, 1h, 1d, 3d, 30d. Не все тиры могут быть доступны для покупки в конкретный момент — запрашивайте GET /v1/prices для получения списка открытых тарифов в реальном времени.
Периоды суток (Day parts)
Стоимость энергии меняется в зависимости от времени суток и нагрузки на сеть: платформа выделяет несколько периодов суток (например, ночной спад, низкая нагрузка, утренний рост, пиковые часы), каждый со своей ставкой за единицу энергии. Границы окон задаются на сервере в формате UTC; на сайте они отображаются с конвертацией в ваш часовой пояс. Всегда запрашивайте текущий период через GET /v1/prices.
Стейт-машина заказа (Order states)
Каждый заказ проходит через единую цепочку состояний: created → paid → allocating → delegated → confirmed → active → expired | reclaimed. При возникновении ошибок заказ переходит в терминальные ветки failed или refunded. Частичное выполнение не является отдельным статусом — это признак partial: true и значение delivered_amount, меньшее заказанного объема, в заказе со стандартным статусом confirmed или active.
Срок действия котировки (Quote TTL)
Котировка фиксирует стоимость заказа на короткий промежуток времени (120 секунд). Оформление заказа по quote_id до истечения срока гарантирует списание именно зафиксированной суммы. После истечения срока запросите новую котировку.
Идемпотентность через client_order_id
При создании заказа всегда передавайте собственный уникальный идентификатор client_order_id. Повторный вызов с тем же id вернет созданный ранее заказ вместо дублирования покупки — это безопасный способ повторить запрос при сетевом тайм-ауте без риска двойного списания средств.
Прямой перевод с Memo
Для пополнения баланса или оплаты без авторизации поддерживается прямой перевод TRX на общий адрес с указанием Memo вашего аккаунта. Обязательно указывайте Memo в точности так, как указано в инструкции, иначе средства не смогут быть зачислены автоматически.