# 잔액

> 통화별 잔액과 함께 가맹점 계정 목록을 조회합니다.

Balance endpoint는 프로젝트 내 모든 가맹점 계정의 사용 가능한 잔액, USD 환산 금액 및 잠긴 금액을 반환합니다.

## 잔액 조회

<TwoCol>

가맹점 계정 목록을 반환합니다. 요청 본문이 없으므로 서명은 빈 문자열을 기준으로 계산합니다.

### 응답 필드

`result`의 각 계정에는 다음이 포함됩니다:

| 필드 | 타입 | 설명 |
|-------|------|-------------|
| `uuid` | string | 계정 UUID |
| `status` | string | 계정 상태 (`active`, `disabled`) |
| `currency_code` | string | 계정 통화 |
| `balance` | decimal | 사용 가능한 잔액 |
| `balance_usd` | decimal | USD로 환산한 사용 가능 잔액 |
| `locked_balance` | decimal | AML로 인해 잠긴 금액 |

### 응답 예시

```json
{
  "state": 0,
  "result": [
    {
      "uuid": "abc123-def456-...",
      "status": "active",
      "currency_code": "USDT",
      "balance": "1250.50",
      "balance_usd": "1250.50",
      "locked_balance": "0.00"
    },
    {
      "uuid": "def456-abc789-...",
      "status": "active",
      "currency_code": "BTC",
      "balance": "0.01320000",
      "balance_usd": "1251.20",
      "locked_balance": "0.00000000"
    }
  ]
}
```

<TwoColAside>

<Credentials />

<TryIt endpoint="GET /v1/balance" />

</TwoColAside>

</TwoCol>