委托历史

查询所有状态的委托历史，支持多维度筛选。

接口信息

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

请求参数

参数	类型	必填	说明
symbol	string	否	合约交易对筛选
coType	int	否	合约类型筛选
status	int	否	状态筛选：0=全部，1=new，2=filled，3=part_filled，4=canceled，5=pending_cancel，6=expired
openFlag	int	否	开平仓筛选：1=开仓，2=平仓
longFlag	int	否	方向筛选：1=多仓，2=空仓
startTime	int64	否	开始时间（毫秒时间戳）
endTime	int64	否	结束时间（毫秒时间戳）
pageIndex	int	否	页码，默认1
pageSize	int	否	每页数量，默认10，最大100

请求示例

{
  "symbol": "BTCUSDT",
  "status": 2,
  "openFlag": 1,
  "startTime": 1705737600000,
  "endTime": 1705824000000,
  "pageIndex": 1,
  "pageSize": 20
}

响应字段

字段	类型	说明
id	int64	订单 ID
symbol	string	合约交易对
price	string	挂单价格（市价单为0）
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	委托数量
filledVol	string	已成交数量
amtTotal	string	订单总价值 (USD)
leverage	string	杠杆倍数
realPnl	string	已实现盈亏
realFee	string	实际手续费
orderMargin	string	保证金
marginMode	int	保证金模式：1=全仓, 2=逐仓
coType	int	合约类型：1=美股, 2=港股, 3=数字货币
triggerType	int	触发类型：1=普通, 2=止盈, 3=止损, 4=强平
ctime	int64	创建时间（毫秒时间戳）
tradedTime	int64	成交时间（毫秒时间戳）
cancelTime	int64	取消时间（毫秒时间戳）
total	int64	总记录数
page	int	当前页码
size	int	每页数量

响应示例

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