# Wan API 잔액 조회 엔드포인트 (https://wanapi.app/ko/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`       | 계정에서 사용할 수 있는 잔액(USD)입니다. Playground와 계정의 모든 API 키가 함께 사용합니다.          |
| `key_remaining` | 이 키의 남은 한도(USD)이며, 한도가 없는 키는 `null`입니다. 키는 두 금액 중 어느 것도 넘겨 사용할 수 없습니다. |

## 오류 [#errors]

| 상태  | 코드                    | 의미                                      |
| --- | --------------------- | --------------------------------------- |
| 401 | —                     | API 키가 없거나, 유효하지 않거나, 비활성화되었거나 만료되었습니다. |
| 503 | `balance_unavailable` | 잠시 후 다시 시도하세요.                          |