ЦеныБлогДокументация
Главная/Покупка по API

Покупка Bandwidth TRON через API

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

Bandwidth — ресурс, которым сеть TRON оплачивает обычные переводы и вызовы контрактов, не затрагивающие хранилище смарт-контракта, — чаще всего это обычный перевод TRX. Один вызов с адресом получателя и объёмом — и мы делегируем Bandwidth напрямую на этот адрес.

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": "bandwidth", "targetAddress": "TXYZ...4f9a", "volume": 1000, "duration": "1h", }, ) print(resp.json())

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

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

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

targetAddressstring

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

volumeinteger

Объём делегирования. Bandwidth: 1 000–300 000. Energy: 65 000–1 000 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
Подключение к проекту
Используйте тот же вызов в своём приложении или сервисе.

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