{
"account_no": "00000001",
"account_name": "Default Account",
"currency": "USDT",
"status": "active",
"is_system_default": true,
"editable": false,
"available_amount": 10000,
"frozen_amount": 2000,
"total_amount": 12000,
"created": 1788998400,
"as_of": 1789084800
}{
"error": {
"code": "invalid_parameter",
"message": "账户号格式不正确;不符合网关匹配规则的路径也可能直接返回 404。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "resource_not_found",
"message": "账户不存在或不属于当前商户;网关未匹配的路径也可能返回纯文本 Not Found。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "internal_error",
"message": "服务内部错误。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "service_unavailable",
"message": "余额查询服务暂时不可用,请稍后使用新的时间戳、nonce 和签名重试。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}查询单个全球账户
按账户编号查询当前 API Key 所属商户的单个 Balance Account 及余额。账户不存在或不属于当前商户时均返回 404 resource_not_found。
账户字段与 as_of 位于响应顶层,不使用 global_account 外层对象。账户编号是 8 位数字字符串,必须保留前导零。
认证方式沿用公共认证规范。无需传入 merchant_id 或 X-Merchant-Id,服务端只查询当前 API Key 所属商户的数据。无请求体。金额示例为虚构数据,使用账本最小单位。
{
"account_no": "00000001",
"account_name": "Default Account",
"currency": "USDT",
"status": "active",
"is_system_default": true,
"editable": false,
"available_amount": 10000,
"frozen_amount": 2000,
"total_amount": 12000,
"created": 1788998400,
"as_of": 1789084800
}{
"error": {
"code": "invalid_parameter",
"message": "账户号格式不正确;不符合网关匹配规则的路径也可能直接返回 404。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "resource_not_found",
"message": "账户不存在或不属于当前商户;网关未匹配的路径也可能返回纯文本 Not Found。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "internal_error",
"message": "服务内部错误。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "service_unavailable",
"message": "余额查询服务暂时不可用,请稍后使用新的时间戳、nonce 和签名重试。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}授权
Bearer API Key,例如 Bearer sk_live_xxx。
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符。
使用商户 API Secret 计算的 HMAC-SHA256 小写 hex 签名。
请求头
Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。
防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
路径参数
8 位数字账户编号。
^[0-9]{8}$响应
查询成功。
账户编号,8 位数字字符串;保留前导零。
^[0-9]{8}$"00000001"
账户展示名称。
"Default Account"
大写账本币种或资产代码,例如 USD、USDT、USDC。
"USDT"
账户可用状态;受限账户仍可查询,是否允许资金操作由对应业务接口决定。
active, restricted 是否为系统默认账户。
是否允许商户修改账户展示名称;本接口不提供修改能力。
可用余额,使用账本币种最小单位的整数。
冻结或预留余额,使用账本币种最小单位的整数。
账户总余额,当前版本等于 available_amount + frozen_amount。
账户创建时间,Unix 秒。
本次查询的数据库观察时间,Unix 秒;不是数据版本号,不保证多次请求处于同一快照。
此页面对您有帮助吗?
