Skip to main content
POST
/
api
/
v1
/
bandwidth
/
rentals
Start Auto-renew Rental
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>"
}

​
Start Auto-renew Rental

Delegates bandwidth to a TRON address and keeps it delegated, charging your balance once every 24 hours at the daily (1d) rate until you cancel or your balance can’t cover the next day.

​
Request body

​
target_address
string
required
Target TRON address (T… format, 34 characters)
​
volume
number
required
Amount of bandwidth to keep delegated (min 350, max 100,000)

​
Response

​
id
number
Unique rental identifier
​
status
string
Rental status — active on success
​
txid
string
On-chain delegation transaction id
​
daily_trx
string
Amount charged per day, in TRX
​
amount_sun
number
Delegated bandwidth in SUN
​
next_billing_at
string
ISO 8601 timestamp of the next daily charge

​
How billing works

The first day is charged immediately. Every 24h the daily amount is charged again. If your balance can’t cover the next day, the rental ends and the bandwidth is undelegated automatically — and it resumes on its own once you top up. Cancel any time with the cancel endpoint.

​
Example

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"
}