Saltar al contenido principal
POST
/
api
/
v1
/
bandwidth
/
rentals
Iniciar alquiler con renovación automática
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>"
}

​
Iniciar alquiler con renovación automática

Delega ancho de banda a una dirección TRON y lo mantiene delegado, cobrando de tu saldo una vez cada 24 horas a la tarifa diaria (1d) hasta que canceles o tu saldo no cubra el día siguiente.

​
Cuerpo de la solicitud

​
target_address
string
requerido
Dirección TRON de destino (formato T…, 34 caracteres)
​
volume
number
requerido
Cantidad de ancho de banda a mantener delegada (mín 350, máx 100,000)

​
Respuesta

​
id
number
Identificador único del alquiler
​
status
string
Estado del alquiler — active si tiene éxito
​
txid
string
Id de la transacción de delegación on-chain
​
daily_trx
string
Importe cobrado por día, en TRX
​
amount_sun
number
Ancho de banda delegado en SUN
​
next_billing_at
string
Marca de tiempo ISO 8601 del próximo cargo diario

​
Cómo funciona el cobro

El primer día se cobra de inmediato. Cada 24h se vuelve a cobrar el importe diario. Si tu saldo no cubre el día siguiente, el alquiler termina y el ancho de banda se des-delega automáticamente — y se reanuda solo cuando recargas. Cancela en cualquier momento con el endpoint de cancelación.

​
Ejemplo

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