# Endpoint del saldo Wan API (https://wanapi.app/it/docs/balance)



Questo endpoint funziona con tutti i modelli. Invia la chiave come `Authorization: Bearer YOUR_API_KEY` a `https://api.wanapi.app`. Restituisce il saldo dell’account a cui appartiene la chiave e non modifica alcun dato.

`GET /v1/balance` restituisce il saldo disponibile dell’account della chiave. Non modifica nulla.

```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           | Significato                                                                                                                            |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `object`        | Sempre `balance`.                                                                                                                      |
| `currency`      | Sempre `USD`.                                                                                                                          |
| `balance`       | Saldo disponibile dell’account in USD. Il Playground e tutte le chiavi API dell’account lo condividono.                                |
| `key_remaining` | Limite residuo di questa chiave in USD, oppure `null` se la chiave non ha limiti. Una chiave non può superare nessuno dei due importi. |

## Errori [#errors]

| Stato | Codice                | Significato                                                       |
| ----- | --------------------- | ----------------------------------------------------------------- |
| 401   | —                     | La chiave API manca oppure non è valida, è disattivata o scaduta. |
| 503   | `balance_unavailable` | Riprova più tardi.                                                |