# 查询未完成订单

# order_list_query

order_list_query(order_id="", status_filter_list=[], code='', start='', end='', trd_env=TrdEnv.REAL, acc_id=0, acc_index=0, refresh_cache=False)

  • 介绍

    查询指定交易业务账户的未完成订单列表

  • 参数

    参数 类型 说明
    order_id str 订单号过滤
    status_filter_list list 订单状态过滤
    code str 代码过滤
    start str 开始时间
    end str 结束时间
    trd_env TrdEnv 交易环境
    acc_id int 交易业务账户 ID
    acc_index int 交易业务账户列表中的账户序号
    refresh_cache bool 是否刷新缓存
  • 返回

    参数 类型 说明
    ret RET_CODE 接口调用结果
    data pd.DataFrame 当 ret == RET_OK 时,返回订单列表
    str 当 ret != RET_OK 时,返回错误描述
    • 订单列表格式如下:
      字段 类型 说明
      trd_side TrdSide 交易方向
      order_type OrderType 订单类型
      order_status OrderStatus 订单状态
      order_id str 订单号
      code str 股票代码
      stock_name str 股票名称
      qty float 订单数量
      price float 订单价格
      currency Currency 交易货币
      create_time str 创建时间
      updated_time str 最后更新时间
      dealt_qty float 成交数量
      dealt_avg_price float 成交均价
      last_err_msg str 最后的错误描述
      remark str 下单时备注的标识
      time_in_force TimeInForce 有效期限
      fill_outside_rth bool 是否允许盘前盘后(仅用于美股)
      aux_price float 触发价格
      trail_type TrailType 跟踪类型
      trail_value float 跟踪金额/百分比
      trail_spread float 指定价差
  • Example

from futu import *
trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
ret, data = trd_ctx.order_list_query()
if ret == RET_OK:
    print(data)
    if data.shape[0] > 0:  # 如果订单列表不为空
        print(data['order_id'][0])  # 获取未完成订单的第一个订单号
        print(data['order_id'].values.tolist())  # 转为 list
else:
    print('order_list_query error: ', data)
trd_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
  • Output
        code stock_name trd_side           order_type   order_status             order_id    qty  price              create_time             updated_time  dealt_qty  dealt_avg_price last_err_msg      remark time_in_force fill_outside_rth aux_price trail_type trail_value trail_spread currency
0   HK.00700                 BUY           NORMAL  CANCELLED_ALL  6644468615272262086  100.0  520.0  2021-09-06 10:17:52.465  2021-09-07 16:10:22.806        0.0              0.0               asdfg+=@@@           GTC              N/A       560        N/A         N/A          N/A      HKD
6644468615272262086
['6644468615272262086']
1
2
3
4

接口限制

  • 每 30 秒内最多请求 10 次查询未完成订单接口
  • 调用此接口,只有在刷新缓存时,才受到限频限制