> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Список правил для bandwidth

> Все правила автопополнения bandwidth в вашем аккаунте

## Список правил для bandwidth

Возвращает все правила автопополнения bandwidth в вашем аккаунте, начиная со старых. Удалённые правила в список не входят. Нужен скоуп `view`.

### Ответ

**rules** `array`

Ваши правила для bandwidth.

**объект правила**

**id** `number`

ID правила — используйте его в путях изменения и удаления

**target\_address** `string`

Адрес, который правило держит обеспеченным

**label** `string | null`

Ваше название правила

**threshold\_bandwidth** `number`

Правило покупает, когда доступного bandwidth меньше этого значения

**add\_volume** `number`

Сколько bandwidth покупается за одно пополнение

**duration** `string`

Срок аренды для каждого пополнения — `1h` или `1d`

**status** `string`

`active`, `paused` или `stopped_insufficient_balance` — см. [Статус правила](/ru/api-reference/auto-refill/overview#статус-правила)

**stopped\_reason** `string | null`

Почему правило поставлено на паузу или остановлено: `insufficient_balance`, `order_failed`, `activation_failed` или `invalid_params`. `null`, если причины нет.

**consecutive\_failures** `number`

Сколько пополнений подряд не прошло. Когда значение доходит до 5, правило ставится на паузу; успешное пополнение сбрасывает его в 0.

**last\_checked\_at** `string | null`

Когда мы в последний раз проверяли адрес (ISO 8601, UTC) — независимо от того, удалось ли его прочитать. `null` до первой проверки.

**last\_available\_bandwidth** `number | null`

Bandwidth, доступный на адресе при последней успешной проверке, включая бесплатный. `null` до первого успешного чтения.

**last\_read\_error\_at** `string | null`

Когда проверке в последний раз не удалось прочитать адрес (ISO 8601, UTC). `null`, если последняя проверка прошла успешно. Пока значение задано, `last_available_bandwidth` взято из более ранней проверки и может быть устаревшим. Проверка, которой не удалось прочитать адрес, ничего не покупает.

**last\_refill\_at** `string | null`

Когда было последнее пополнение. `null`, если пополнений ещё не было.

**refill\_count** `number`

Число успешных пополнений с момента создания правила

**total\_spent\_trx** `string`

Сколько всего TRX потрачено на эти пополнения

**created\_at** `string`

Когда правило создано (ISO 8601, UTC)

**estimated\_cost\_per\_refill\_trx** `string | null`

Полная цена одного пополнения для вашего аккаунта по текущим ценам, включая фиксированную комиссию. Активация адреса, когда она нужна, оплачивается сверх. `null`, если цена временно недоступна.

**volume\_below\_threshold** `boolean`

`true`, когда `add_volume` меньше `threshold_bandwidth`. Тогда одного пополнения может не хватить, чтобы поднять адрес выше порога, и правило покупает снова после каждой траты, — см. [предупреждение в обзоре](/ru/api-reference/auto-refill/overview#как-выбрать-значения).

### Пример

```bash cURL theme={null}
curl https://api.tronrental.com/v1/bandwidth/auto-refill \
  -H "X-API-Key: your_api_key"
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://api.tronrental.com/v1/bandwidth/auto-refill",
    headers={"X-API-Key": "your_api_key"},
)
print(resp.json())
```

```javascript JavaScript theme={null}
const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto-refill", {
  headers: { "X-API-Key": "your_api_key" },
});
console.log(await resp.json());
```

```json Response theme={null}
{
  "rules": [
    {
      "id": 15,
      "target_address": "TYourRecipientAddress1234567890abc",
      "label": "Payouts",
      "threshold_bandwidth": 1000,
      "add_volume": 5000,
      "duration": "1h",
      "status": "active",
      "stopped_reason": null,
      "consecutive_failures": 0,
      "last_checked_at": "2026-10-14T09:41:02Z",
      "last_available_bandwidth": 3655,
      "last_read_error_at": null,
      "last_refill_at": "2026-10-14T09:12:30Z",
      "refill_count": 4,
      "total_spent_trx": "1.480000",
      "created_at": "2026-10-14T08:15:00Z",
      "estimated_cost_per_refill_trx": "0.370000",
      "volume_below_threshold": false
    }
  ]
}
```

### Ошибки

| Статус | Код | Когда |
| - | - | - |
| `403` | `FORBIDDEN` | У API-ключа нет скоупа `view` |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.