查看历史订单

类型: GET

描述: /future/trade/v1/order/list-history

参数

名称	类型	必填	默认值	描述	范围
symbol	string	true	N/A	交易对（不传则查询所有交易对）
direction	string	false	NEXT	方向	PREV;NEXT
id	integer	false	N/A	id
limit	integer	false	10	限制数量
startTime	integer	false	N/A	开始时间
endTime	integer	false	N/A	结束时间
forceClose	string	false	false	强平信息，不加该字段则不显示强平订单信息

限流规则

200/s/apikey

请求示例

Request

curl -G "https://fapi.xt.com/future/trade/v1/order/list-history" \
-H "validate-appkey: $APPKEY" \  # 必须
-H "validate-timestamp: $TIMESTAMP" \  # 必须
-H "validate-singature: $SINGATURE" \  # 必须
-H "Content-Type: application/x-www-form-urlencoded" \  # 必须
-d "symbol=eth_usdt" \  # 必须
-d "limit=10"

响应示例

Response

{
"error": {
  "code": "",
  "msg": ""
},
"msgInfo": "",
"result": {
  "hasNext": false,   // 是否有下一页
  "hasPrev": false,   // 是否有上一页
  "items": [          // 数据列表
    {
      "clientOrderId": "",       // 客户订单 ID
      "avgPrice": 0,             // 成交均价
      "closePosition": false,    // 订单条件触发时是否全部平仓
      "closeProfit": 0,          // 平仓盈亏
      "createdTime": 0,          // 创建时间
      "executedQty": 0,          // 成交量（张）
      "forceClose": false,       // 是否为强平订单
      "marginFrozen": 0,         // 占用保证金
      "orderId": 0,              // 订单 ID
      "orderSide": "",           // 订单方向
      "orderType": "",           // 订单类型
      "origQty": 0,              // 数量（张）
      "positionSide": "",        // 仓位方向
      "price": 0,                // 订单价格
      "sourceId": 0,             // 触发条件 ID
      "state": "",               // 订单状态: NEW; PARTIALLY_FILLED; FILLED; CANCELED; REJECTED; EXPIRED
      "symbol": "",              // 交易对
      "timeInForce": "",         // 有效类型
      "triggerProfitPrice": 0,   // 止盈触发价格
      "triggerStopPrice": 0      // 止损触发价格
    }
  ]
},
"returnCode": 0
}

错误码

错误码	描述
invalid_symbol	交易对不存在