# 回應訂單推送回呼

on_recv_rsp(self, rsp_pb)

  • 介紹

    回應訂單推送,非同步處理 OpenD 推送過來的訂單狀態資訊。
    在收到 OpenD 推送過來的訂單狀態資訊後會回呼到該函數,您需要在衍生類別中覆寫 on_recv_rsp。

  • 參數

    參數 類型 説明
    rsp_pb Trd_UpdateOrder_pb2.Response 衍生類別中不需要直接處理該參數
  • 傳回

    參數 類型 説明
    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 是否允許盤前盤後(僅用於美股)
      session Session 交易訂單時段(僅用於美股)
      aux_price float 觸發價格
      trail_type TrailType 跟蹤類型
      trail_value float 跟蹤金額/百分比
      trail_spread float 指定價差
  • Example

from futu import *
from time import sleep
class TradeOrderTest(TradeOrderHandlerBase):
    """ order update push"""
    def on_recv_rsp(self, rsp_pb):
        ret, content = super(TradeOrderTest, self).on_recv_rsp(rsp_pb)
        if ret == RET_OK:
            print("* TradeOrderTest content={}\n".format(content))
        return ret, content

trd_ctx = OpenSecTradeContext(filter_trdmarket=TrdMarket.HK, host='127.0.0.1', port=11111, security_firm=SecurityFirm.FUTUSECURITIES)
trd_ctx.set_handler(TradeOrderTest())
print(trd_ctx.place_order(price=518.0, qty=100, code="HK.00700", trd_side=TrdSide.SELL))

sleep(15)
trd_ctx.close()
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
  • Output
* TradeOrderTest content=  trd_env      code stock_name  dealt_avg_price  dealt_qty    qty           order_id order_type  price order_status          create_time         updated_time trd_side last_err_msg trd_market remark time_in_force fill_outside_rth session aux_price trail_type trail_value trail_spread currency
0    REAL  HK.00700       騰訊控股              0.0        0.0  100.0  72625263708670783     NORMAL  518.0   SUBMITTING  2021-11-04 11:26:27  2021-11-04 11:26:27      BUY                      HK                  DAY      N/A        N/A       N/A        N/A         N/A          N/A      HKD
1
2