Onerway
POST

查询账户余额

受限
查看 Markdown
该接口用于查询指定币种的账户余额结构，包括 Payment、Funding、待结算、冻结、风险保证金和总余额。
访问受限
账户服务 API 的访问权限需经 Onerway 审批后开通。

请求

apikeystring必填
Onerway 分配的账户服务 API key 请求 Header；必须使用与请求域名相同环境的值。
示例：replace_with_account_service_apikey
x-timestampstring必填
请求时间戳；网关使用该 Header 防止请求被重放。
示例：1776931200
约束
规则
时间戳必须在服务端当前时间 10分钟以内；支持 10 位秒级或 13 位毫秒级时间戳。
requestIdstring必填
请求 ID，用于幂等控制和链路追踪。
示例：REQ-BAL-20260423-0001
onBehalfOfstring可选
平台商户代子商户查询时使用的子商户号；调用方商户必须是子商户的父商户。
示例：replace_with_sub_merchant_no
currencystring必填
需要查询余额的币种；使用 ISO 4217 三位字母货币代码。
示例：USD

请求示例

curl -X POST 'https://sandbox-api.onerway.com/account-server/api/v2/account/balance/query' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "requestId": "REQ-BAL-20260423-0001",
  "currency": "USD"
}'

响应

respCodestring
标准化响应码；20000 表示成功。
respMsgstring
与 respCode 对应的可读响应信息。
指定币种的账户余额明细。
标准化错误对象；成功响应中该字段为 null，序列化时省略。

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "currency": "USD",
    "paymentBalance": "1500.00",
    "fundingBalance": "1000.00",
    "pendingSettlementBalance": "200.00",
    "onHoldBalance": "100.00",
    "riskDepositAmount": "200.00",
    "totalBalance": "3000.00",
    "status": "Active"
  }
}
该接口暂未记录错误响应。

按交易单号查询账户流水

按一个或多个交易单号查询关联的账户余额变动记录。

查询账户余额总览

查询多币种账户余额汇总和可选的展示币种总金额。