> ## 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.

# Список правил для энергии

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

## Список правил для энергии

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

### Ответ

**rules** `array`

Ваши правила для энергии.

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

**id** `number`

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

**target\_address** `string`

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

**label** `string | null`

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

**threshold\_energy** `number`

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

**add\_volume** `number`

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

**duration** `string`

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

**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\_energy** `number | null`

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

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

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

**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_energy`. Тогда одного пополнения может не хватить, чтобы поднять адрес выше порога, и правило покупает снова после каждой траты, — см. [предупреждение в обзоре](/ru/api-reference/auto-refill/overview#как-выбрать-значения).

### Пример

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

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

resp = requests.get(
    "https://api.tronrental.com/v1/energy/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/energy/auto-refill", {
  headers: { "X-API-Key": "your_api_key" },
});
console.log(await resp.json());
```

```json Response theme={null}
{
  "rules": [
    {
      "id": 12,
      "target_address": "TYourRecipientAddress1234567890abc",
      "label": "Hot wallet",
      "threshold_energy": 65000,
      "add_volume": 131000,
      "duration": "1h",
      "status": "active",
      "stopped_reason": null,
      "consecutive_failures": 0,
      "last_checked_at": "2026-10-14T09:41:02Z",
      "last_available_energy": 212480,
      "last_read_error_at": null,
      "last_refill_at": "2026-10-14T08:57:40Z",
      "refill_count": 3,
      "total_spent_trx": "7.854000",
      "created_at": "2026-10-14T08:12:05Z",
      "estimated_cost_per_refill_trx": "2.618000",
      "volume_below_threshold": false
    }
  ]
}
```

### Ошибки

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


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