查询单个账户及余额

查询单个账户及余额

GET /api/v1/account/{account_no}

cURL

curl --request GET \
  --url "https://api.stablepay.co/api/v1/account/{account_no}" \
  --header "Authorization: Bearer <API_KEY>" \
  --header "X-StablePay-Timestamp: <TIMESTAMP>" \
  --header "X-StablePay-Nonce: <NONCE>" \
  --header "X-StablePay-Signature: <SIGNATURE>"

200

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

完整认证、签名、数据约定与错误响应。每次重试均须重新生成时间戳、nonce 与签名。

GET /account/{account_no} 按账户编号返回单个账户，字段位于响应顶层。

请求头

Authorization · string · 必填

Bearer API Key。

X-StablePay-Timestamp · string · 必填

Unix 秒，允许与服务端相差最多 5 分钟。

X-StablePay-Nonce · string · 必填

每次请求唯一的随机串，16–64 字符。

X-StablePay-Signature · string · 必填

HMAC-SHA256 签名，小写十六进制；签名必须对应实际发送的请求体。

请求参数

account_no · string · 必填

8 位数字账户编号

merchant_id · string

10 位数字；商户 App 不传，服务商 App 传值指定作用商户

响应

account_no · string · 必填

8 位数字账户编号

account_name · string · 必填

账户展示名称

currency · string · 必填

币种或资产代码

status · string · 必填

active 或 restricted

is_system_default · boolean · 必填

是否默认账户

editable · boolean · 必填

是否允许改名

available_amount · integer · 必填

可用余额

frozen_amount · integer · 必填

冻结余额

total_amount · integer · 必填

总余额

created · integer · 必填

创建时间

as_of · integer · 必填

观察时间

状态与错误

400 编号格式错误；404 账户不存在或不属于目标商户。

cURL

curl --request GET \
  --url "https://api.stablepay.co/api/v1/account/{account_no}" \
  --header "Authorization: Bearer <API_KEY>" \
  --header "X-StablePay-Timestamp: <TIMESTAMP>" \
  --header "X-StablePay-Nonce: <NONCE>" \
  --header "X-StablePay-Signature: <SIGNATURE>"

200

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