账户与交易（v2）

在 /api/v2/account 下的 现货相关 账户流 REST v2（与同一 API 密钥下合约账户等共用场景一致）。U 本位合约 v2 见 账户与交易（v2）。

查询账户流水 (USER_DATA)

• GET /api/v2/account/balance-flow

权重：5

参数

名称	类型	是否必须	说明
accountType	STRING	NO	MAIN 或 FUTURES（默认 MAIN）
coin	STRING	NO	币种 tokenId
flowType	STRING	NO	流水枚举名（与 data[].flowType 一致，如 USER_ACCOUNT_TRANSFER）
fromId	LONG	NO	顺向游标
endId	LONG	NO	反向游标
startTime	LONG	NO	开始时间（毫秒）
endTime	LONG	NO	结束时间（毫秒）
limit	INT	NO	默认 20，最小 1，最大 1000
timestamp	LONG	YES	时间戳
recvWindow	LONG	NO	recv 窗口

flowType 枚举值

枚举名	说明
TRADE	交易
FEE	交易手续费
TRANSFER	通用转账流水
DEPOSIT	充值
PNL	合约盈亏
LIQUIDATION	强平
FUNDING_SETTLEMENT	资金费率结算
OTC_BUY_COIN	OTC 买币
OTC_SELL_COIN	OTC 卖币
USER_ACCOUNT_TRANSFER	用户账户划转

响应

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "id": "539870570957903104",
      "accountType": "MAIN",
      "coin": "BTC",
      "symbol": "BTCUSDT",
      "flowType": "USER_ACCOUNT_TRANSFER",
      "flowName": "Transfer",
      "change": "-12.5",
      "total": "379.624059937852365",
      "voucherType": 0,
      "deductionAmount": "",
      "created": "1579093587214"
    }
  ]
}

新增返回字段：

名称	类型	说明
voucherType	INT	卡券类型。常见抵扣类型：2 现金券、3 体验金、7 跟单体验金、8 带单体验金；未关联可抵扣卡券时为 0
deductionAmount	STRING	当前流水的卡券抵扣金额，保留字符串精度；未发生抵扣时为空字符串

返回体中 id 与 created 在 JSON 里为字符串形式的数字，与 v2 其它列表接口习惯一致。旧版 v1 列表 GET /api/v1/account/balanceFlow 仍可用；v2 使用字符串 accountType、flowType，公开说明中已省略仅数字类的废弃字段。请求签名见需要签名的接口。