Skip to main content
GET

授权

Authorization
string
header
必填

Bearer API Key,例如 Bearer sk_live_xxx。

X-StablePay-Timestamp
string
header
必填

Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。

X-StablePay-Nonce
string
header
必填

防重放随机字符串,长度 16-64 个字符。

X-StablePay-Signature
string
header
必填

使用商户 API Secret 计算的 HMAC-SHA256 小写 hex 签名。

请求头

X-StablePay-Timestamp
string
必填

Unix 时间戳(秒)。必须与服务端时间相差不超过 5 分钟。

X-StablePay-Nonce
string
必填

防重放随机字符串,长度 16-64 个字符,建议每次请求使用新的 UUID。

Required string length: 16 - 64
X-StablePay-Signature
string
必填

使用商户 API Secret 对 {timestamp}.{nonce}.{requestBody} 计算 HMAC-SHA256,结果为小写 hex。GET 请求的 requestBody 为空字符串。

路径参数

account_no
string
必填

8 位数字账户编号。

Pattern: ^[0-9]{8}$

响应

查询成功。

account_no
string
必填

账户编号,8 位数字字符串;保留前导零。

Pattern: ^[0-9]{8}$
示例:

"00000001"

account_name
string
必填

账户展示名称。

示例:

"Default Account"

currency
string
必填

大写账本币种或资产代码,例如 USD、USDT、USDC。

示例:

"USDT"

status
enum<string>
必填

账户可用状态;受限账户仍可查询,是否允许资金操作由对应业务接口决定。

可用选项:
active,
restricted
is_system_default
boolean
必填

是否为系统默认账户。

editable
boolean
必填

是否允许商户修改账户展示名称;本接口不提供修改能力。

available_amount
integer<int64>
必填

可用余额,使用账本币种最小单位的整数。

frozen_amount
integer<int64>
必填

冻结或预留余额,使用账本币种最小单位的整数。

total_amount
integer<int64>
必填

账户总余额,当前版本等于 available_amount + frozen_amount。

created
integer<int64>
必填

账户创建时间,Unix 秒。

as_of
integer<int64>
必填

本次查询的数据库观察时间,Unix 秒;不是数据版本号,不保证多次请求处于同一快照。

最后修改于 2026年10月13日