查看成交明细

类型: 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	结束时间

限流规则

5/s/apikey（与历史订单与成交组共用，突发 15）

请求示例

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	交易对不存在