第一步、將 feederapi-tester.py、feederapi.py 跟 FeederAPI.dll 複製到工作目錄底下。
第二步、然後檢查 pyinstaller 安裝目錄已經設定到系統環境變數。
第三步、開啟命令提示字元，輸入以下指令把 feederapi-tester.py 編譯成可執行檔案。
pyinstaller -F feederapi-tester.pyclass FeederAPI
| __version__ |
| 目前版本編號。 |
Methods
| initialize() |
| 功能 : 初始化 API 元件。 回傳 : 成功 True，失敗 False 並顯示初始化錯誤說明。 |
| connect(host, port) |
| 功能 : 建立行情伺服器連線。 參數 : ● host – 伺服器位址 ● port – 伺服器埠口 回傳 : 成功 True，失敗 False。 |
| disconnect() |
| 功能 : 中斷行情伺服器連線。 回傳 : 成功 True，失敗 False。 |
| send_tick_data(exch, code, date, time, price, tick, bid_price, bid_volume, ask_price, ask_volume, volume) |
| 功能 : 發送逐筆明細到行情伺服器。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期，格式:yyyyMMdd ● time – 交易時間，格式:HHmmss ● price – 成交價 ● tick – 成交單量 ● bid_price – 委買價 ● bid_volume – 委買量 ● ask_price – 委賣價 ● ask_volume – 委賣量 ● volume – 累積成交量，需越來越大才有效 回傳 : 小於 0 為錯誤碼，成功則回傳待發送筆數。 |
| send_best_data(exch, code, date, time, bid_price1, bid_volume1, bid_price2, bid_volume2, bid_price3, bid_volume3, bid_price4, bid_volume4, bid_price5, bid_volume5, ask_price1, ask_volume1, ask_price2, ask_volume2, ask_price3, ask_volume3, ask_price4, ask_volume4, ask_price5, ask_volume5) |
| 功能 : 發送最佳五檔到行情伺服器。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期，格式:yyyyMMdd ● time – 交易時間，格式:HHmmss ● bid_price1..5 – 委買價一至五檔 ● bid_volume1..5 – 委買量一至五檔 ● ask_price1..5 – 委賣價一至五檔 ● ask_volume1..5 – 委賣量一至五檔 回傳 : 小於 0 為錯誤碼，成功則回傳待發送筆數。 |
| subscribe_tick(exch, code) |
| 功能 : 新增訂閱逐筆行情。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 回傳 : 小於 0 為錯誤碼，成功則回傳訂閱筆數。 |
| unsubscribe_tick(exch, code) |
| 功能 : 解除訂閱逐筆行情。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 回傳 : 小於 0 為錯誤碼，成功則回傳訂閱筆數。 |
| subscribe_best(exch, code) |
| 功能 : 新增訂閱最佳五檔。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 回傳 : 小於 0 為錯誤碼，成功則回傳訂閱筆數。 |
| unsubscribe_best(exch, code) |
| 功能 : 解除訂閱最佳五檔。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 回傳 : 小於 0 為錯誤碼，成功則回傳訂閱筆數。 |
| request_tick(exch, code, date, begin_time, end_time) |
| 功能 : 回補商品逐筆明細。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期 ● begin_time – 開始時間 ● end_time – 結束時間 回傳 : 小於 0 為錯誤碼，成功則回傳待處理筆數。 |
| request_bars(exch, code, date, begin_time, end_time) |
| 功能 : 回補商品分線。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期 ● begin_time – 開始時間 ● end_time – 結束時間 回傳 : 小於 0 為錯誤碼，成功則回傳待處理筆數。 |
| request_line(exch, code, begin_date, end_date) |
| 功能 : 回補商品日線。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 ● begin_date – 開始日期 ● end_date – 結束日期 回傳 : 小於 0 為錯誤碼，成功則回傳待處理筆數。 |
| setRealTimeTickFunc(callback) |
| 功能 : 設定逐筆行情回呼函式。 參數 : ● callback – 函式定義:RealTimeTickCallBack 回傳 : 成功 True，失敗 False。 |
| setRealTimeBestFunc(callback) |
| 功能 : 設定最佳五檔回呼函式。 參數 : ● callback – 函式定義:RealTimeBestCallBack 回傳 : 成功 True，失敗 False。 |
| setHistoryTickFunc(callback) |
| 功能 : 設定回補商品逐筆回呼函式。 參數 : ● callback – 函式定義:HistoryTickCallBack 回傳 : 成功 True，失敗 False。 |
| setHistoryBarsFunc(callback) |
| 功能 : 設定回補商品分線回呼函式。 參數 : ● callback – 函式定義:HistoryBarsCallBack 回傳 : 成功 True，失敗 False。 |
| setHistoryLineFunc(callback) |
| 功能 : 設定回補商品日線回呼函式。 參數 : ● callback – 函式定義:HistoryLineCallBack 回傳 : 成功 True，失敗 False。 |
Callbacks
| @RealTimeTickCallBack(exch, code, date, time, price, volume, bidprice, bidvolume, askprice, askvolume, totalvolume) |
| 功能 : 接收逐筆明細函式。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期，格式:yyyyMMdd ● time – 交易時間，格式:HHmmss ● price – 成交價 ● tick – 成交單量 ● bidprice – 委買價 ● bidvolume – 委買量 ● askprice – 委賣價 ● askvolume – 委賣量 ● totalvolume – 成交量 |
| @RealTimeBestCallBack(exch, code, date, time, bidprice1, bidvolume1, bidprice2, bidvolume2, bidprice3, bidvolume3, bidprice4, bidvolume4, bidprice5, bidvolume5, askprice1, askvolume1, askprice2, askvolume2, askprice3, askvolume3, askprice4, askvolume4, askprice5, askvolume5) |
| 功能 : 接收最佳五檔函式。 參數 : ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期，格式:yyyyMMdd ● time – 交易時間，格式:HHmmss ● bidprice1..5 – 委買價一至五檔 ● bidvolume1..5 – 委買量一至五檔 ● askprice1..5 – 委賣價一至五檔 ● askvolume1..5 – 委賣量一至五檔 |
| @HistoryTickCallBack(index, exch, code, date, time, price, ticks, volume, bidprice, askprice) |
| 功能 : 接收回補逐筆函式。 參數 : ● index – 索引編號從大到小，0 表示已回補完成 ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期，格式:yyyyMMdd ● time – 交易時間，格式:HHmmss ● price – 成交價 ● tick – 單量 ● volume – 成交量 ● bidprice – 委買價 ● askprice – 委賣價 |
| @HistoryBarsCallBack(index, exch, code, date, time, open, high, low, close, totalticks, totalvolume) |
| 功能 : 接收回補分線函式。 參數 : ● index – 索引編號從大到小，0 表示已回補完成 ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期，格式:yyyyMMdd ● time – 交易時間，格式:HHmmss ● open – 開盤價 ● high – 最高價 ● low – 最低價 ● close – 收盤價 ● totalticks – 成交筆數 ● totalvolume – 總成交量 |
| @HistoryLineCallBack(index, exch, code, date, open, high, low, close, totalticks, totalvolume, openinterest) |
| 功能 : 接收回補日線函式。 參數 : ● index – 索引編號從大到小，0 表示已回補完成 ● exch – 交易所代碼 ● code – 商品代碼 ● date – 交易日期，格式:yyyyMMdd ● open – 開盤價 ● high – 最高價 ● low – 最低價 ● close – 收盤價 ● totalticks – 成交筆數 ● totalvolume – 總成交量 ● openinterest – 未平倉量 |
- 測試影片: