Onerway
POST

查询账户余额总览

受限
查看 Markdown
该接口用于查询各币种账户余额汇总，并在汇率可用时返回用于总览展示的展示币种总金额。
访问受限
账户服务 API 的访问权限需经 Onerway 审批后开通。

请求

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

请求示例

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

响应

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

响应示例

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "totalAmount": "5000.00",
    "displayCurrency": "USD",
    "currencyBalances": [
      {
        "currency": "USD",
        "paymentBalance": "1500.00",
        "fundingBalance": "1000.00",
        "pendingSettlementBalance": "200.00",
        "onHoldBalance": "100.00",
        "riskDepositAmount": "200.00",
        "totalBalance": "3000.00",
        "status": "Active"
      },
      {
        "currency": "EUR",
        "paymentBalance": "1500.00",
        "fundingBalance": "1000.00",
        "pendingSettlementBalance": "0.00",
        "onHoldBalance": "500.00",
        "riskDepositAmount": "0.00",
        "totalBalance": "2000.00",
        "status": "Active"
      }
    ]
  }
}
该接口暂未记录错误响应。

查询账户余额

查询指定单一币种的账户余额明细。

导出每日账户账单

导出指定日期的每日账户账单 CSV。