查看成交明细
类型: GET
描述: /future/trade/v1/order/trade-list
参数
| 名称 | 类型 | 必填 | 默认值 | 描述 | 范围 |
|---|---|---|---|---|---|
| orderId | integer | false | N/A | 订单 ID | |
| symbol | string | false | N/A | 交易对 | |
| page | integer | false | 1 | 页码 | |
| size | integer | false | 10 | 单页数量 | |
| startTime | integer | false | N/A | 开始时间 | |
| endTime | integer | false | N/A | 结束时间 |
限流规则
200/s/apikey
请求示例
Request
curl -G "https://fapi.xt.com/future/trade/v1/order/trade-list" \
-H "validate-appkey: $APPKEY" \ # 必须
-H "validate-timestamp: $TIMESTAMP" \ # 必须
-H "validate-singature: $SINGATURE" \ # 必须(已修正拼写错误:singature → signature)
-H "Content-Type: application/x-www-form-urlencoded" \ # 必须
-d "symbol=eth_usdt" \
-d "page=1" \
-d "size=10"
响应示例
Response
{
"error": {
"code": "",
"msg": ""
},
"msgInfo": "",
"result": {
"items": [
{
"fee": 0, // 手续费
"feeCoin": "", // 手续费币种
"orderId": 0, // 订单 ID
"execId": 0, // 成交 ID
"price": 0, // 价格
"quantity": 0, // 成交量
"symbol": "", // 交易对
"timestamp": 0, // 时间
"takerMaker": "TAKER" // taker 或 maker
}
],
"page": 0,
"ps": 0,
"total": 0
},
"returnCode": 0
}
错误码
| 错误码 | 描述 |
|---|---|
| invalid_page | 页面需为正整数 |
| invalid_size | size 最大值为 100 |
| invalid_symbol | 交易对不存在 |