moomoo API Doc v10.1

# 命令列 OpenD

# 第一步 下載

  • 命令列 OpenD 支援 Windows、MacOS、CentOS、Ubuntu 四種系統。
  • 您可以通過 moomoo 官網 下載。 download-page

# 第二步 解壓

  • 解壓上一步下載的文件，在文件夾中找到 OpenD 設定檔 OpenD.xml 和程式打包數據文件 Appdata.dat。
    • OpenD.xml 用於配置 OpenD 程式啟動參數，若不存在則程式無法正常啟動。
    • Appdata.dat 是程式需要用到的一些數據量較大的資訊，打包數據減少啟動下載該數據的耗時，若不存在則程式無法正常啟動。
  • 命令列 OpenD 支援用户自定義文件路徑，詳見 命令列啟動參數。

# 第三步 參數配置

  • 打開並編輯設定檔 OpenD.xml，如下圖所示。普通使用僅需修改賬號和登入密碼，其他高階選項可以根據下表的提示進行修改。

xml-config

配置項列表：

配置項 說明
ip 監聽地址
api_port API 協議接收連接埠
login_account 登入帳號
login_pwd 登入密碼明文
login_pwd_md5 登入密碼密文（32 位 MD5 加密 16 進制）
lang 中英語言
log_level OpenD 日誌級別
push_proto_type 推送協議類型
qot_push_frequency API 訂閲數據推送頻率控制
telnet_ip 遠端操作命令監聽地址
telnet_port 遠端操作命令監聽連接埠
rsa_private_key API 協議 RSA 加密私鑰（PKCS#1）文件絕對路徑
price_reminder_push 是否接收到價提醒推送
auto_hold_quote_right 被踢後是否自動搶權限
future_trade_api_time_zone 期貨交易 API 時區
websocket_ip WebSocket 服務監聽地址
websocket_port WebSocket 服務監聽連接埠
websocket_key_md5 密鑰密文（32 位 MD5 加密 16 進制）
websocket_private_key WebSocket 證書私鑰文件路徑
websocket_cert WebSocket 證書文件路徑
pdt_protection 是否開啟 防止被標記為日內交易者 的功能
dtcall_confirmation 是否開啟 日內交易保證金追繳預警 的功能

提示

  • 為保證您的證券業務賬户安全，如果監聽地址不是本地，您必須配置私鑰才能使用交易接口。行情接口不受此限制。

  • 當 WebSocket 監聽地址不是本地，需配置 SSL 才可以啟動，且證書私鑰生成不可設置密碼。

  • 密文是明文經過 32 位 MD5 加密後用 16 進製表示的數據，搜索在線 MD5 加密（注意，通過第三方網站計算可能有記錄撞庫的風險）或下載 MD5 計算工具可計算得到。32 位 MD5 密文如下圖紅框區域（e10adc3949ba59abbe56e057f20f883e）：

    md5.png

  • OpenD 預設讀取同目錄下的 OpenD.xml。在 MacOS 上，由於系統保護機制，OpenD.app 在運行時會被分配一個隨機路徑，導致無法找到原本的路徑。此時有以下方法：

    • 執行 tar 包下的 fixrun.sh
    • 用命令列參數-cfg_file指定設定檔路徑，見下面說明

  • 日誌級別預設 info 級別，在系統開發階段，不建議關閉日誌或者將日誌修改到 warning，error，fatal 級別，防止出現問題時無法定位。

# 第四步 命令列啟動

  • 在命令列中切到前面解壓文件夾 OpenD 文件所在的目錄，使用如下命令啟動，即可以 OpenD.xml 設定檔中的參數啟動。
    • Windows：OpenD
    • Linux：./OpenD
    • MacOS：./OpenD.app/Contents/MacOS/OpenD
命令列啟動參數

  • 命令列中也可以攜帶參數啟動，部分參數會與 OpenD.xml 設定檔相同。傳參格式：-key=value startup-command-param.png
    例如：

    • Windows：OpenD.exe -login_account=100000 -login_pwd=123456 -lang=en
    • Linux：OpenD -login_account=100000 -login_pwd=123456 -lang=en
    • MacOS：./OpenD.app/Contents/MacOS/OpenD -login_account=100000 -login_pwd=123456 -lang=en

  • 相同參數若同時存在於命令列與設定檔，命令列參數優先。具體參數詳見如下表格：

參數列表：

配置項 說明
login_account 登入帳號
login_pwd 登入密碼明文
login_pwd_md5 登入密碼密文（32 位 MD5 加密 16 進制）
cfg_file OpenD 設定檔絕對路徑
console 是否顯示控制台
lang 中英語言
api_ip API 服務監聽地址
api_port API 協議接收連接埠
help 輸出命令列啟動參數，並退出程式
log_level OpenD 日誌級別
no_monitor 是否啟動守護程序
websocket_ip WebSocket 服務監聽地址
websocket_port WebSocket 服務監聽連接埠
websocket_private_key WebSocket 證書私鑰文件路徑
websocket_cert WebSocket 證書文件路徑
websocket_key_md5 密鑰密文（32 位 MD5 加密 16 進制）
price_reminder_push 是否接收到價提醒推送
auto_hold_quote_right 被踢後是否自動搶權限
future_trade_api_time_zone 期貨交易 API 時區

← 維護命令 →