查询用户交易成交
检索用户的交易历史,包括资金费用数据。需要读取权限。
时间范围限制:
startTime+endTime:最多 7 天- 仅
startTime:从开始时间往后 7 天 - 仅
endTime:从结束时间往前 7 天 - 都未指定:使用当前时间作为结束时间往前 7 天
请求参数
| 名称 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbol | String | 否 | 市场交易对标识符。可选 — 如未指定,将返回所有交易对的成交记录。 |
| startTime | Long | 否 | 开始时间(以毫秒为单位) |
| endTime | Long | 否 | 结束时间(以毫秒为单位) |
| count | Integer | 否 | 要返回的记录数 |
| clOrderID | String | 否 | 使用自定义订单ID查询交易历史 |
| orderID | String | 否 | 使用订单ID查询交易历史 |
| isMatchSymbol | Boolean | 否 | 精确匹配 symbol。如果设置为 true,只匹配该标的物的记录 |
响应内容
| 名称 | 类型 | 描述 |
|---|---|---|
| symbol | String | 市场交易对标识符 |
| side | String | 交易方向 (BUY 或 SELL) |
| price | Double | 成交价格 |
| size | Double | 原始订单数量 |
| serialId | Long | 序列ID,运行的序列号 |
| timestamp | Long | 成交时间戳 |
| orderId | String | 订单ID |
| clOrderId | String | 自定义订单ID |
| feeAmount | Double | 手续费金额 |
| feeCurrency | String | 手续费货币 |
example
GET
https://api.btse.com/spot/api/v3.3/user/trade_history