账户详情查询

接口信息

路径: api/v1/acct/queryAcctDetail
方法: POST
Content-Type: application/json

业务说明

日常对账、交易记录查询、异常交易核查、费用核算
用于查询指定币种的账户交易明细
支持多种交易类型的筛选,包括:充值入账、付款出账、手续费收取、资金冻结解冻等
注意查询时间范围不要过大,避免数据量过大
可以通过txnType参数筛选特定类型的交易

请求参数

请求体

参数名	类型	说明	是否必填
merchantNo	string	商户号	M
currency	string(20)	币种，如：USD	M
beginTime	string	开始时间，格式："2024-06-11 00:00:00"	M
endTime	string	结束时间，格式："2024-07-13 12:12:12"	M
size	integer	每页条数，如：10	M
current	integer	当前页，默认 1	M
txnType	string	交易类型	N
sign	string	签名	M

交易类型说明

费用调整: 0036
月费: 0034
充值: 0043
入账冻结: 1024
入账手续费: 1025
充值入账: 1026
提现: 0032
付款: 1030
提现/付款手续费: 1031
提现/付款手续费冲正: 1038

请求示例

json

{
  "merchantNo": 801129,
  "currency": "USD",
  "beginTime": "2025-06-15 00:00:00",
  "endTime": "2025-09-10 12:12:12",
  "size": "10",
  "current": "1",
  "sign": "d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f842982e7"
}

响应结果

响应示例

json

{
  "respCode": "20000",
  "respMsg": null,
  "data": {
    "currency": "USD",
    "availBalance": "989734.42",
    "freezeBalance": "128.00",
    "accountTransactionDetails": [
      {
        "serviceId": "1965301543088029696",
        "txnType": "0107",
        "subAcntType": "AVAIL",
        "currency": "USD",
        "accountBalanceBefore": 989996.92,
        "moveAmount": -5.00,
        "accountBalanceAfter": 989991.92,
        "remark": "jiaoyiRemark",
        "balanceUpdDate": "2025-09-09 14:29:36"
      },
      {
        "serviceId": "1965301540898603008",
        "txnType": "0035",
        "subAcntType": "AVAIL",
        "currency": "USD",
        "accountBalanceBefore": 989997.98,
        "moveAmount": -1.06,
        "accountBalanceAfter": 989996.92,
        "remark": null,
        "balanceUpdDate": "2025-09-09 14:29:35"
      },
      {
        "serviceId": "1965297185243922432",
        "txnType": "0107",
        "subAcntType": "AVAIL",
        "currency": "USD",
        "accountBalanceBefore": 989999.95,
        "moveAmount": -1.97,
        "accountBalanceAfter": 989997.98,
        "remark": "betaTest",
        "balanceUpdDate": "2025-09-09 14:12:17"
      },
      {
        "serviceId": "1965297181477437440",
        "txnType": "0035",
        "subAcntType": "AVAIL",
        "currency": "USD",
        "accountBalanceBefore": 990000.98,
        "moveAmount": -1.03,
        "accountBalanceAfter": 989999.95,
        "remark": null,
        "balanceUpdDate": "2025-09-09 14:12:16"
      },
      {
        "serviceId": "1964986146396700672",
        "txnType": "0048",
        "subAcntType": "AVAIL",
        "currency": "USD",
        "accountBalanceBefore": 0.00,
        "moveAmount": 990000.98,
        "accountBalanceAfter": 990000.98,
        "remark": null,
        "balanceUpdDate": "2025-09-08 17:36:20"
      }
    ]
  }
}

响应体

参数名	类型	说明
respCode	string	响应码
respMsg	string	响应信息
data	object	响应数据
└─currency	string	币种
└─availBalance	string	可用余额
└─freezeBalance	string	冻结余额
└─accountTransactionDetails	array	交易明细列表

交易明细字段

参数名	类型	说明
serviceId	integer	流水号
txnType	string	交易类型
currency	string	币种
accountBalanceBefore	number	期初金额
moveAmount	number	动账金额
accountBalanceAfter	number	期末金额
remark	string	备注
balanceUpdDate	string	账户余额更新时间

账户详情查询 ​

请求参数 ​

请求体 ​

响应结果 ​

响应体 ​

账户详情查询

请求参数

请求体

响应结果

响应体