# 残高

> 通貨ごとの残高を含むマーチャントアカウントのリストを取得します。

Balance エンドポイントは、プロジェクト内のすべてのマーチャントアカウントとその利用可能残高、USD 換算額、ロック中の金額を返します。

## 残高を取得する

<TwoCol>

マーチャントアカウントのリストを返します。リクエストはボディを取らず、署名は空文字列に対して計算されます。

### レスポンスフィールド

`result` 内の各アカウントには以下が含まれます：

| Field | Type | Description |
|-------|------|-------------|
| `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>