Перейти к основному содержанию
GET
/
api
/
v1
/
bandwidth
/
rentals
Список аренд с автопродлением
curl --request GET \
  --url https://api.example.com/api/v1/bandwidth/rentals

​
Список аренд с автопродлением

Возвращает ваши аренды с автопродлением, начиная с новых.

​
Параметры запроса

​
status
string
Фильтр по статусу: active, cancelled или ended_insufficient_balance

​
Ответ

Возвращает rentals — массив объектов аренды с status, volume, daily_trx, total_charged_trx, next_billing_at и временными метками.

​
Статусы аренды

СтатусОписание
activeДелегировано, списание раз в сутки
cancelledОтменено пользователем (или админом)
ended_insufficient_balanceЗавершено автоматически — баланса не хватило на следующий день

​
Пример

curl "https://api.tronrental.com/v1/bandwidth/rentals?status=active" \
  -H "X-API-Key: your_api_key"
Response
{
  "rentals": [
    {
      "id": 4321,
      "address": "TYourRecipientAddress1234567890abc",
      "volume": 350,
      "status": "active",
      "daily_trx": "0.4205",
      "total_charged_trx": "1.2615",
      "billing_count": 3,
      "next_billing_at": "2026-06-11T04:30:00+00:00",
      "last_billed_at": "2026-06-10T04:30:00+00:00",
      "delegate_txid": "abc123...",
      "undelegate_txid": null,
      "ended_at": null,
      "created_at": "2026-06-08T04:30:00+00:00"
    }
  ]
}