# Endpoint de saldo de Wan API (https://wanapi.app/es/docs/balance)



Este endpoint funciona con todos los modelos. Envía tu clave como `Authorization: Bearer YOUR_API_KEY` a `https://api.wanapi.app`. Devuelve el saldo de la cuenta propietaria de la clave y no modifica ningún dato.

`GET /v1/balance` devuelve el saldo disponible de la cuenta de la clave. No modifica nada.

```bash
curl https://api.wanapi.app/v1/balance \
  -H "Authorization: Bearer $WAN_API_KEY"
```

```json
{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "key_remaining": null
}
```

| Campo           | Significado                                                                                                                         |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `object`        | Siempre `balance`.                                                                                                                  |
| `currency`      | Siempre `USD`.                                                                                                                      |
| `balance`       | Saldo disponible de la cuenta en USD. El Playground y todas las claves de API de la cuenta lo comparten.                            |
| `key_remaining` | Límite restante de esta clave en USD, o `null` si la clave no tiene límite. Una clave no puede superar ninguno de los dos importes. |

## Errores [#errors]

| Estado | Código                | Significado                                                           |
| ------ | --------------------- | --------------------------------------------------------------------- |
| 401    | —                     | Falta la clave de API o no es válida, está desactivada o ha caducado. |
| 503    | `balance_unavailable` | Inténtalo más tarde.                                                  |