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

# List Energy Rules

> All energy Auto Refill rules on your account

## List Energy Rules

Returns every energy Auto Refill rule on your account, oldest first. Deleted rules are not included. Requires the `view` scope.

### Response

**rules** `array`

Your energy rules.

**rule object**

**id** `number`

Rule ID — use it in the edit and delete paths

**target\_address** `string`

The address the rule keeps supplied

**label** `string | null`

Your name for the rule

**threshold\_energy** `number`

The rule buys when available energy is below this

**add\_volume** `number`

Energy bought per refill

**duration** `string`

Rental duration of each refill — always `1h`

**status** `string`

`active`, `paused` or `stopped_insufficient_balance` — see [Rule status](/api-reference/auto-refill/overview#rule-status)

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

Why the rule was paused or stopped: `insufficient_balance`, `order_failed`, `activation_failed` or `invalid_params`. `null` when there is none.

**consecutive\_failures** `number`

Failed refills in a row. The rule is paused when this reaches 5; a successful refill resets it to 0.

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

When we last checked the address (ISO 8601, UTC), whether or not the read succeeded. `null` before the first check.

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

Energy available on the address at the last successful check. `null` before the first successful read.

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

When a check last failed to read the address (ISO 8601, UTC). `null` when the last check succeeded. While it is set, `last_available_energy` is from an earlier check and may be out of date. A check that cannot read the address buys nothing.

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

When the last refill was made. `null` if there has been none.

**refill\_count** `number`

Successful refills since the rule was created

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

TRX spent on those refills, in total

**created\_at** `string`

When the rule was created (ISO 8601, UTC)

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

Full price of one refill for your account at current prices, fixed fee included. Address activation, when needed, is charged on top. `null` if the price is temporarily unavailable.

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

`true` when `add_volume` is smaller than `threshold_energy`. One refill may then not lift the address above the threshold, and the rule buys again after every spend — see the [warning in the overview](/api-reference/auto-refill/overview#choosing-the-numbers).

### Example

```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
    }
  ]
}
```

### Errors

| Status | Code | When |
| - | - | - |
| `403` | `FORBIDDEN` | The API key lacks the `view` scope |


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