Saltar para o conteúdo principal
POST
/
api
/
v1
/
bandwidth
/
rentals
Iniciar aluguel com renovação 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 aluguel com renovação automática

Delega largura de banda a um endereço TRON e a mantém delegada, cobrando do seu saldo uma vez a cada 24 horas pela tarifa diária (1d) até você cancelar ou o saldo não cobrir o dia seguinte.

​
Corpo da requisição

​
target_address
string
obrigatório
Endereço TRON de destino (formato T…, 34 caracteres)
​
volume
number
obrigatório
Quantidade de largura de banda a manter delegada (mín 350, máx 100.000)

​
Resposta

​
id
number
Identificador único do aluguel
​
status
string
Status do aluguel — active em caso de sucesso
​
txid
string
Id da transação de delegação on-chain
​
daily_trx
string
Valor cobrado por dia, em TRX
​
amount_sun
number
Largura de banda delegada em SUN
​
next_billing_at
string
Carimbo ISO 8601 da próxima cobrança diária

​
Como funciona a cobrança

O primeiro dia é cobrado imediatamente. A cada 24h o valor diário é cobrado novamente. Se o saldo não cobrir o dia seguinte, o aluguel termina e a largura de banda é des-delegada automaticamente — e retoma sozinho quando você recarrega. Cancele a qualquer momento pelo endpoint de cancelamento.

​
Exemplo

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