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

# Listar reglas de energía

> Todas las reglas de Recarga automática de energía de tu cuenta

## Listar reglas de energía

Devuelve todas las reglas de Recarga automática de energía de tu cuenta, de la más antigua a la más reciente. Las reglas eliminadas no se incluyen. Requiere el alcance `view`.

### Respuesta

**rules** `array`

Tus reglas de energía.

**objeto de regla**

**id** `number`

ID de la regla — úsalo en las rutas de edición y eliminación

**target\_address** `string`

La dirección que la regla mantiene abastecida

**label** `string | null`

Tu nombre para la regla

**threshold\_energy** `number`

La regla compra cuando la energía disponible está por debajo de este valor

**add\_volume** `number`

Energía comprada en cada recarga

**duration** `string`

Duración del alquiler de cada recarga — siempre `1h`

**status** `string`

`active`, `paused` o `stopped_insufficient_balance` — ver [Estado de la regla](/es/api-reference/auto-refill/overview#estado-de-la-regla)

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

Por qué se pausó o se detuvo la regla: `insufficient_balance`, `order_failed`, `activation_failed` o `invalid_params`. `null` si no hay ningún motivo.

**consecutive\_failures** `number`

Recargas fallidas seguidas. La regla se pausa cuando llega a 5; una recarga exitosa lo devuelve a 0.

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

Cuándo comprobamos la dirección por última vez (ISO 8601, UTC), se haya podido leer o no. `null` antes de la primera comprobación.

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

Energía disponible en la dirección en la última comprobación correcta. `null` antes de la primera lectura correcta.

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

Cuándo falló por última vez una comprobación al leer la dirección (ISO 8601, UTC). `null` si la última comprobación fue correcta. Mientras tenga valor, `last_available_energy` procede de una comprobación anterior y puede estar desactualizado. Una comprobación que no puede leer la dirección no compra nada.

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

Cuándo se hizo la última recarga. `null` si aún no ha habido ninguna.

**refill\_count** `number`

Recargas exitosas desde que se creó la regla

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

TRX gastados en esas recargas, en total

**created\_at** `string`

Cuándo se creó la regla (ISO 8601, UTC)

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

Precio completo de una recarga para tu cuenta a los precios actuales, comisión fija incluida. La activación de la dirección, cuando hace falta, se cobra aparte. `null` si el precio no está disponible temporalmente.

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

`true` cuando `add_volume` es menor que `threshold_energy`. En ese caso, una recarga puede no subir la dirección por encima del umbral, y la regla vuelve a comprar después de cada gasto — consulta la [advertencia de la descripción general](/es/api-reference/auto-refill/overview#cómo-elegir-los-valores).

### Ejemplo

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

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| `403` | `FORBIDDEN` | La clave API carece del alcance `view` |


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