Главная/Покупка по API

Аренда энергии TRON через API

Открыть документацию →

Энергия — ресурс, который сеть TRON расходует при выполнении смарт-контракта в транзакции — чаще всего это перевод USDT (TRC-20). Один вызов с адресом получателя и объёмом — и мы делегируем энергию напрямую на этот адрес.

import requests resp = requests.post( "https://trongas.ai/api/v1/orders", headers={ "X-Api-Key": "tgk_4f9a1c8e2b7d...", "Idempotency-Key": "5c1e2b6a-9e21-4b7a-8f3d-1a2b3c4d5e6f", }, json={ "resource": "energy", "targetAddress": "TXYZ...4f9a", "volume": 65000, "duration": "1h", }, ) print(resp.json())

Формат запросов

Тело запроса
resourcestring

"energy" или "bandwidth". Если не указано — по умолчанию energy.

targetAddressstring

Адрес TRON, на который делегируется ресурс.

volumeinteger

Объём делегирования. Energy: 65 000–1 000 000. Bandwidth: 1 000–300 000.

durationstring

"15m", "1h" или "1d".

Заголовки
X-Api-Key

Ваш API-ключ.

Idempotency-Key

UUID, который вы генерируете сами. Повтор запроса с тем же ключом вернёт исходный заказ вместо повторного списания.

Тело ответа
id

Идентификатор заказа.

status

Сначала "Created", затем "Filled" после делегирования (или "Failed"). Подпишитесь на вебхук order.filled, чтобы узнать момент доставки.

priceTrx / activationTrx / totalTrx

Сумма списания в TRX. activationTrx ненулевой только если адрес получает TRX впервые (активация).

txId

Хеш транзакции делегирования, появляется после доставки заказа.

Получить API ключ

От нуля до первого запроса

01
Регистрация
Создайте бесплатный аккаунт TronGasAi.
02
Получение ключа
Выпустите ключ с нужным scope в кабинете.
03
Тестовый запрос
Вызовите POST /orders с вашим ключом.
04
Подключение к проекту
Используйте тот же вызов в своём приложении или сервисе.

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

Около 65 000 энергии, если на адресе получателя сейчас есть USDT, и около 131 000, если баланс USDT у получателя нулевой (контракту приходится создавать новую запись баланса). Важен только текущий баланс USDT получателя — а не то, новый ли адрес и принадлежит ли он бирже.

Заказ отклоняется до какого-либо списания (402, wallet.insufficient_balance) — пополните внутренний TRX-баланс и повторите запрос с тем же Idempotency-Key.

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

Пока нет — каждый заказ списывает реальный внутренний TRX-баланс. Начните с минимального объёма (65 000 энергии, 15 минут), чтобы проверить весь путь с минимальными затратами.

Ответ приходит сразу со статусом "Created". Подпишитесь на вебхук order.filled (или опрашивайте заказ), чтобы точно знать момент доставки — обычно это происходит примерно за 0.3 сек.