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

# Cotización de recarga de energía

> Precio de una recarga de energía, antes de crear una regla

## Cotización de recarga de energía

Devuelve lo que cuesta a tu cuenta una recarga de `add_volume` de energía: el precio que paga por recarga una regla con este volumen, comisión fija incluida. No se crea ni se cobra nada. Requiere el alcance `view`.

El precio depende de cómo hagas la llamada. Con una clave API, es el precio de una regla creada con esa clave API; desde el sitio web, el precio de una regla creada en el sitio web. Es el precio en el momento de la solicitud, y no incluye la activación de una dirección que todavía no existe on-chain — eso lo añade la primera recarga.

### Parámetros de consulta

**add\_volume** `number` *required*

Energía por recarga. De 32,000 a 5,000,000, el mismo rango que al crear una regla.

Las recargas de energía siempre duran una hora, así que no hay parámetro `duration`; la respuesta siempre trae `"duration": "1h"`.

### Respuesta

**add\_volume** `number`

El volumen que consultaste

**duration** `string`

Duración del alquiler de la recarga — siempre `1h` para la energía

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

Precio completo de una recarga para tu cuenta, comisión fija incluida

### Ejemplo

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

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

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

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

```json Response theme={null}
{
  "add_volume": 131000,
  "duration": "1h",
  "estimated_cost_per_refill_trx": "2.618000"
}
```

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| `403` | `FORBIDDEN` | La clave API carece del alcance `view` |
| `422` | — | Falta `add_volume` o está fuera de 32,000 – 5,000,000 |
| `503` | `TEMPORARILY_UNAVAILABLE` | No se pudo obtener el precio en este momento — reintenta pasados los segundos de `Retry-After` |

```json theme={null}
{
  "detail": {
    "error": {
      "code": "TEMPORARILY_UNAVAILABLE",
      "message": "Please retry shortly"
    }
  }
}
```

Un error de validación llega en el formato del framework, con `detail` como array:

```json theme={null}
{
  "detail": [
    {
      "type": "greater_than_equal",
      "loc": ["query", "add_volume"],
      "msg": "Input should be greater than or equal to 32000",
      "input": "1000",
      "ctx": {"ge": 32000}
    }
  ]
}
```


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