Перейти к основному содержанию
POST
/
api
/
v1
/
bandwidth
/
rentals
Запустить аренду с автопродлением
curl --request POST \
  --url https://api.example.com/api/v1/bandwidth/rentals \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_address": "<string>",
  "volume": 123
}
'
{
  "id": 123,
  "status": "<string>",
  "txid": "<string>",
  "daily_trx": "<string>",
  "amount_sun": 123,
  "next_billing_at": "<string>"
}

​
Запустить аренду с автопродлением

Делегирует bandwidth на TRON-адрес и держит делегирование, списывая с баланса раз в 24 часа по суточному тарифу (1d), пока вы не отмените или баланса не хватит на следующий день.

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

​
target_address
string
обязательно
Целевой TRON-адрес (формат T…, 34 символа)
​
volume
number
обязательно
Объём bandwidth для удержания (мин 350, макс 100 000)

​
Ответ

​
id
number
Уникальный идентификатор аренды
​
status
string
Статус аренды — active при успехе
​
txid
string
Хеш on-chain транзакции делегирования
​
daily_trx
string
Сумма списания в сутки, в TRX
​
amount_sun
number
Делегированный bandwidth в SUN
​
next_billing_at
string
Метка ISO 8601 следующего суточного списания

​
Как работает биллинг

Первый день списывается сразу. Каждые 24ч списывается суточная сумма. Если баланса не хватает на следующий день, аренда завершается, а bandwidth автоматически отзывается — и возобновляется сама после пополнения баланса. Отменить можно в любой момент через endpoint отмены.

​
Пример

curl -X POST https://api.tronrental.com/v1/bandwidth/rentals \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "target_address": "TYourRecipientAddress1234567890abc",
    "volume": 350
  }'
Response
{
  "id": 4321,
  "status": "active",
  "txid": "abc123...",
  "daily_trx": "0.4205",
  "amount_sun": 1000000,
  "next_billing_at": "2026-06-11T04:30:00+00:00"
}