Главная/Покупка по 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
Подключение к проекту
Используйте тот же вызов в своём приложении или сервисе.

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

Обычному переводу TRX требуется около 267 Bandwidth. Другим типам переводов может требоваться чуть больше — наш минимальный заказ на 1 000 покрывает несколько переводов с запасом.

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

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

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

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