历史订单

查询已成交或已取消的历史订单（分页）。

接口信息

• 方法: POST
• 路径: /api/v1/futures/open-api/order/history

请求参数

参数	类型	必填	说明
symbol	string	否	合约交易对筛选
coType	int	否	合约类型筛选
pageIndex	int	否	页码，默认1
pageSize	int	否	每页数量，默认10，最大100

请求示例

{
  "symbol": "BTCUSDT",
  "coType": 3,
  "pageIndex": 1,
  "pageSize": 20
}

响应字段

字段	类型	说明
id	int64	订单 ID
symbol	string	合约交易对
price	string	挂单价格
avgPrice	string	成交均价
status	int	订单状态：0=init, 1=new, 2=filled, 3=part_filled, 4=canceled, 5=pending_cancel, 6=expired
orderNo	string	订单编号
openFlag	int	开平仓：1=开仓, 2=平仓
orderType	int	委托类型：1=限价, 2=市价
longFlag	int	方向：1=多仓(买), 2=空仓(卖)
vol	string	委托数量
amtTotal	string	订单总价值 (USD)
leverage	string	杠杆倍数
realPnl	string	已实现盈亏
realFee	string	实际手续费
ctime	int64	创建时间（毫秒时间戳）
tradedTime	int64	成交时间（毫秒时间戳）
cancelTime	int64	取消时间（毫秒时间戳）
triggerType	int	触发类型：1=普通, 2=止盈, 3=止损, 4=强平
orderMargin	string	保证金
marginMode	int	保证金模式：1=全仓, 2=逐仓
coType	int	合约类型：1=美股, 2=港股, 3=数字货币
total	int64	总记录数
page	int	当前页码
size	int	每页数量

响应示例

{
  "code": 200,
  "data": [
    {
      "id": 123456,
      "symbol": "BTCUSDT",
      "price": "68500.00",
      "avgPrice": "68520.00",
      "status": 2,
      "orderNo": "CO2026032500001",
      "openFlag": 1,
      "orderType": 2,
      "longFlag": 1,
      "vol": "0.5",
      "amtTotal": "34260.00",
      "leverage": "10",
      "realPnl": "200.50",
      "realFee": "34.26",
      "ctime": 1737446400000,
      "tradedTime": 1737446500000,
      "cancelTime": 0,
      "triggerType": 1,
      "orderMargin": "3425.00",
      "marginMode": 1,
      "coType": 3
    }
  ],
  "total": 150,
  "page": 1,
  "size": 20
}