ЦеныБлогДокументация
Главная/Покупка по 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

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

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

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

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