读取密钥所属账户的当前余额与累计消耗。需要 balance:read 权限;尚未拿到密钥时,先在控制台获取密钥。
GET /open/v1/balance没有请求参数。
{
"balance": "1.48",
"balanceExact": "1.481480",
"usedBalance": "0.518520",
"currency": "USD"
}| 字段 | 类型 | 说明 |
|---|---|---|
balance |
string | 当前余额,固定两位小数,用于展示 |
balanceExact |
string | 同一个余额,固定六位小数,用于程序判断和计算 |
usedBalance |
string | 累计已消耗金额,固定六位小数 |
currency |
string | 币种,当前为 USD |
balance 和 balanceExact 表示同一笔余额,不要相加。余额按相应小数位向下取整;程序检查余量时使用 balanceExact,避免两位小数掩盖小额差异。从未充值且未使用的账户返回零余额。
金额以十进制字符串返回。计算时使用 Python Decimal、Java BigDecimal 或 JavaScript 十进制库,不要先转成 float、Number 或 parseFloat。余额暂时无法读取时返回 502 upstream_unavailable,不会用零代替读取失败。