信息/余额

余额

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

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

获取余额

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

响应字段

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"
    }
  ]
}

Credentials

Project UUIDAPI key

RequestGET/v1/balance

curl -X GET https://api.2328.io/api/v1/balance \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyShop/1.0 (+https://myshop.example)" \
  -H "project: YOUR_PROJECT_UUID" \
  -H "sign: YOUR_HMAC_SIGNATURE"

Response

Click Try it to see the response here.