{
"object": "list",
"data": [
{
"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": "internal_error",
"message": "服务内部错误。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}{
"error": {
"code": "service_unavailable",
"message": "余额查询服务暂时不可用,请稍后使用新的时间戳、nonce 和签名重试。"
},
"request_id": "example-request-id",
"timestamp": 1789084800
}全球账户 API
查询全球账户列表
查询当前 API Key 所属商户的全部 Balance Account 及余额,包括系统默认账户和商户自定义账户。无需 merchant_id,不支持分页或业务筛选。
列表使用 object: list 和 data 数组,不使用 global_accounts 外层字段。当前版本不返回账户级 pending_amount。
认证方式沿用公共认证规范。无需传入 merchant_id 或 X-Merchant-Id,服务端只查询当前 API Key 所属商户的数据。无请求体。金额示例为虚构数据,使用账本最小单位。
GET
/
api
/
v1
/
global_accounts
{
"object": "list",
"data": [
{
"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": "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。
Required string length:
16 - 64使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。
最后修改于 2026年10月13日
此页面对您有帮助吗?
