跳到主要内容

查询用户交易成交

检索用户的交易历史,包括资金费用数据。需要读取权限。

时间范围限制:

  • startTime + endTime:最多 7 天
  • startTime:从开始时间往后 7 天
  • endTime:从结束时间往前 7 天
  • 都未指定:使用当前时间作为结束时间往前 7 天

请求参数

名称类型是否必填描述
symbolString市场交易对标识符。可选 — 如未指定,将返回所有交易对的成交记录。
startTimeLong开始时间(以毫秒为单位)
endTimeLong结束时间(以毫秒为单位)
countInteger要返回的记录数
clOrderIDString使用自定义订单ID查询交易历史
orderIDString使用订单ID查询交易历史
isMatchSymbolBoolean精确匹配 symbol。如果设置为 true,只匹配该标的物的记录

响应内容

名称类型描述
symbolString市场交易对标识符
sideString交易方向 (BUY 或 SELL)
priceDouble成交价格
sizeDouble原始订单数量
serialIdLong序列ID,运行的序列号
timestampLong成交时间戳
orderIdString订单ID
clOrderIdString自定义订单ID
feeAmountDouble手续费金额
feeCurrencyString手续费货币
example
GEThttps://api.btse.com/spot/api/v3.3/user/trade_history