# Wan API 残高確認エンドポイント (https://wanapi.app/ja/docs/balance)



このエンドポイントはすべてのモデルで使えます。`https://api.wanapi.app` に、キーを `Authorization: Bearer YOUR_API_KEY` として送信してください。キーを所有するアカウントの残高を返し、データは変更しません。

`GET /v1/balance` はキーのアカウントで使える残高を返します。読み取り専用です。

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

| フィールド           | 意味                                                    |
| --------------- | ----------------------------------------------------- |
| `object`        | 常に `balance`。                                         |
| `currency`      | 常に `USD`。                                             |
| `balance`       | アカウントで使える残高（米ドル）。Playground とアカウントのすべての API キーで共有します。 |
| `key_remaining` | このキーの残りの上限（米ドル）。上限がないキーでは `null`。キーはどちらの金額も超えて使えません。  |

## エラー [#errors]

| ステータス | コード                   | 意味                           |
| ----- | --------------------- | ---------------------------- |
| 401   | —                     | API キーがないか、無効、停止中、または期限切れです。 |
| 503   | `balance_unavailable` | しばらくしてから再試行してください。           |