# 余额

> 获取项目中所有商户账户的余额列表。

Balance 接口返回项目内所有商户账户、各账户可用余额、美元等值，以及因 AML 而锁定的金额。

## 获取余额

<TwoCol>

返回商户账户列表。该请求无请求体 — 签名基于空字符串计算。

### 响应字段

`result` 中的每个账户包含：

| 字段 | 类型 | 说明 |
|------|------|------|
| `uuid` | string | 账户 UUID |
| `status` | string | 账户状态（`active`、`disabled`） |
| `currency_code` | string | 账户币种 |
| `balance` | decimal | 可用余额 |
| `balance_usd` | decimal | 可用余额的美元等值 |
| `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>