API аренды энергии TRON
Арендуйте энергию TRON программно вместо расходования TRX на комиссии — на 70–80% дешевле за перевод TRC-20.
- Заказ: укажите адрес получателя, количество энергии и срок аренды. Делегирование выполняется за несколько секунд
- Запрос заказов: проверяйте состояние делегирования и срок действия по идентификатору заказа или адресу
- Цены: текущая цена единицы и ступени для планирования расходов
- Вебхуки: события успешного делегирования и истечения срока с подписью HMAC
GET / POST /api/v1/energy/*
Аутентификация
API аренды энергии использует API-ключ пользователя для аутентификации. Добавляйте следующие заголовки в каждый запрос:
Войдите в консоль → Инструменты и настройки → Управление API, затем создайте и включите ключ для получения X-API-Key и X-Secret-Key.
Подписанные вызовы платных интерфейсов
Создание заказа, разовый заказ и возврат — платные интерфейсы. Новые API-ключи по умолчанию требуют для них подпись (X-Key-ID / X-Timestamp / X-Nonce / X-Sign-Version / X-Signature); ниже полный пример создания заказа. Чтение по-прежнему принимает одни X-API-Key + X-Secret-Key. Если отключить требование подписи для платных операций и конфиденциальных данных, платные интерфейсы тоже принимают обычный X-Secret-Key, но это не рекомендуется.
Обзор
Переводы USDT в TRON расходуют энергию. Адреса без замороженных TRX платят около 6.5-13 TRX газа за транзакцию. С арендованной энергией перевод расходует её, а не сжигает TRX; размер экономии зависит от цены аренды на момент заказа.
Перевод USDT на адрес с балансом USDT: около 65 000 энергии
Перевод USDT на адрес, не получавший USDT: около 135 000 энергии
Получить информацию о платформе
GET /api/v1/energy/info
Получите общую информацию об аренде энергии: доступная энергия, ценовые уровни и ограничения.
Запросить баланс учётной записи
GET /api/v1/energy/balance
Запросите баланс учётной записи этого ключа. Аренда энергии — частые небольшие платежи, поэтому нехватка средств обычна; проверяйте баланс перед пакетными заказами и настройте уведомление о низком остатке.
Список периодов аренды (конечная точка)
GET /api/v1/energy/periods
Возвращает поддерживаемые периоды. Значения вне списка отклоняются с 400, и заказ не создаётся.
Оценка стоимости
GET /api/v1/energy/price
Оцените стоимость аренды для периода и количества энергии. Возвращает цену API в TRX.
Оценить расход энергии
GET /api/v1/energy/estimate-energy
Оцените энергию для перевода USDT на указанный адрес.
Создать заказ аренды
POST /api/v1/energy/order
Создайте заказ аренды энергии; плата списывается с баланса в USD.
Поля ответа
При недостатке средств возвращается code: 400, message: "Insufficient account balance, please top up first"
Разовый заказ энергии
POST /api/v1/energy/order/onetime
Создайте разовый заказ по стратегии на транзакцию; energy_amount назначается системой автоматически.
Запросить список заказов
GET /api/v1/energy/orders
Запросите свои заказы аренды энергии.
Запросить отдельный заказ
GET /api/v1/energy/order/:serial
Запросите подробности заказа и синхронизируйте последнее состояние.
Запросить заказ по вашему номеру операции
GET /api/v1/energy/order/by-trade-no/:out_trade_no
Найдите заказ по своему out_trade_no — наш номер не требуется.
⚠️ При тайм-ауте создание возвращает 504, и у вас есть лишь out_trade_no (наш номер отсутствует в ответе тайм-аута). Для этого и предназначена конечная точка: получите итог по тому же out_trade_no.
Отозвать заказ
POST /api/v1/energy/order/reclaim
Досрочно отзовите неистёкший заказ аренды энергии.
Обратный вызов результата заказа
Для заказов с callback_url (включая разовые) платформа один раз отправляет результат на этот URL при первом окончательном успехе (status=40) или сбое (status=41). Независимо от подтверждения — уведомлением о статусе в реальном времени, опросом заказа, сверкой или восстановлением несохранённого заказа — каждый заказ уведомляется один раз, а неудачная доставка повторяется автоматически. Исключение: создание вернуло 504 с неизвестным результатом (внутри сохраняется временная запись с номером, начинающимся с LOCAL-). Такой заказ разрешается вручную и не уведомляется автоматически; уточняйте результат по собственному номеру заказа. Обратные вызовы отправляет и подписывает платформа; прежний формат обратных вызовов больше не используется. Существующие подключения должны обновить разбор данных и проверку подписи согласно этому разделу.
Запрос — POST с Content-Type: application/json. Тело — плоский JSON-объект, где все значения являются строками (включая status, energy_amount и timestamp), без полей цены. Платформа не следует перенаправлениям, тайм-аут каждого запроса — 10 секунд.
Проверка подписи
Алгоритм совпадает с обратными вызовами платёжных заказов: возьмите все непустые поля, кроме sign, отсортируйте имена в порядке ASCII, объедините как k1=v1&k2=v2&… и вычислите HMAC-SHA256; результат — hex в нижнем регистре. Ключ — Secret Key API-ключа, которым создан заказ; для данных платёжного приложения — его Push Secret (WebhookSecret на странице приложения в консоли, тот же, что для платёжных обратных вызовов). Старые приложения, никогда не создававшие Push Secret, используют App Key.
Уведомление не содержит sign, если заказ создан поддержкой от вашего имени (ключ отсутствует) либо использованный API-ключ или приложение уже удалены. Получив уведомление без sign, перед обработкой подтвердите статус через интерфейс запроса заказа.
Ответ и повторы
Любой статус 2xx означает доставку; тело ответа не проверяется. Другие статусы, тайм-аут, ошибка соединения или перенаправление считаются ошибкой. Платформа повторяет через 30 секунд, 1 минуту, 2 минуты и 5 минут, затем каждые 10 минут, до 10 повторов (остановка примерно через 70 минут). Тело, включая notify_id и sign, повторяется без изменений.
Если сеть оборвётся после обработки вашим сервером, но до получения платформой 2xx, тот же заказ будет уведомлён снова. Удаляйте дубли по notify_id или serial и исключайте побочные эффекты двойной обработки. Уведомление — не единственный источник достоверного результата: если оно не приходит или доставка окончательно неудачна, проверьте через GET /api/v1/energy/order/:serial либо по собственному номеру заказа.
Периоды аренды
Это все поддерживаемые периоды; их также можно получить через GET /api/v1/energy/periods. Другие значения возвращают 400, заказ не создаётся.
Часто задаваемые вопросы
Сколько действительно экономит API аренды энергии?
Прямая оплата TRX за перевод USDT TRC-20 обычно стоит около 6.5-13 TRX. Аренда энергии снижает расходы на 70–80%, а для пакетных переводов разница увеличивается.
Как быстро делегируется энергия и можно ли указать другой адрес?
Делегирование выполняется за несколько секунд. Адрес получателя — тот, который вы передали в запросе. Он не обязан принадлежать аккаунту заказа, поэтому можно пакетно предоставлять энергию любым рабочим адресам.
Связанные страницы: Аренда энергии TRON · Документация API · Мультичейн-платежи в криптовалюте
Загрузка…