查询成交记录
获取用户的交易历史。
时间范围限制:
startTime+endTime:最多 7 天- 仅
startTime:开 始时间后 7 天 - 仅
endTime:结束时间前 7 天 - 均未指定:当前时间前 7 天
请求参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | String | 否 | 市场符号 |
| startTime | Long | 否 | 开始时间(例如:1624987283000) |
| endTime | Long | 否 | 结束时间(例如:1624987283000) |
| beforeSerialId | Long | 否 | 用于分页检索记录,适用于订单量每毫秒超过 500 的情况 |
| afterSerialId | Long | 否 | 用于分页检索记录,适用于订单量每毫秒超过 500 的情况 |
| count | Long | 否 | 返回的记录数量 |
| includeOld | Boolean | 否 | 检索过去 7 天的交易历史记录 |
| orderID | String | 否 | 通过订单 ID 查询交易历史 |
| clOrderID | String | 否 | 通过自定义订单 ID 查询交易历史 |
响应内容
| 名称 | 类型 | 描述 |
|---|---|---|
| symbol | String | 市场符号 |
| side | String | 交易方向: [BUY, SELL] |
| price | Double | 成交价格 |
| size | Long | 原始订单数量 |
| serialId | Long | 序列号,连续的序列号 |
| tradeId | String | 交易标识符 |
| orderId | String | 订单 ID |
| clOrderID | String | 自定义订单 ID |
| timestamp | Long | 成交时间戳 |
| base | String | 基础货币 |
| quote | String | 报价货币 |
| wallet | String | 钱包名称:CROSS@(全仓钱包)或 ISOLATED@{symbol}-USDT(隔离钱包) |
| feeCurrency | String | 费用货币 |
| feeAmount | Double | 费用金额 |
| filledPrice | Double | 平均成交价格 |
| avgFilledPrice | Double | 平均成交价格 |
| filledSize | Long | 成交大小 |
| orderType | Integer | 订单类型 |
| realizedPnL | Double | 现货中未使用 |
| positionId | String | 当前订单属于的仓位 ID |
| contractSize | Double | 交易合约规模 |
example
GET
https://api.btse.com/futures/api/v2.3/user/trade_history