Command Line OpenD

Step 1: Download

Command line OpenD can be runned under 4 operating systems: Windows、MacOS、CentOS、Ubuntu (Click to download).

• OpenD - Windows、MacOS 、CentOS 、Ubuntu

Step 2: Decompression

• Extract the file downloaded in the previous step and find the OpenD configuration file FutuOpenD.xml and the program packaged data file Appdata.dat in the folder.
  • FutuOpenD.xml is used to configure the startup parameters of the OpenD program. If it does not exist, the program cannot start correctly.
  • Appdata.dat is a large amount of data information the program needs to use, packaging data to reduce the time of downloading data while starting OpenD. If it does not exist, the program can not start correctly.
• Command line OpenD supports user-defined file paths, refer to Command line startup parameters。

Step 1: Download

• You can download through moomoo official website.

Step 2: Decompression

• Extract the file downloaded in the previous step and find the OpenD configuration file OpenD.xml and the program packaged data file Appdata.dat in the folder.
  • OpenD.xml is used to configure the startup parameters of the OpenD program. If it does not exist, the program cannot start correctly.
  • Appdata.dat is a large amount of data information the program needs to use, packaging data to reduce the time of downloading data while starting OpenD. If it does not exist, the program can not start correctly.
• Command line OpenD supports user-defined file paths, refer to Command line startup parameters。

Step 3: Parameter Configuration

• Open and edit the configuration file FutuOpenD.xml as the picture below. For general use, you only need to change your account and login password, and other options can be modified according to the instructions in the following table.

Configuration item list：

Configuration Item	Description
ip	listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards) the address of one of your network card 127.0.0.1 by default.
api_port	API protocol receiving port. 11111 by default. Also can be specified in Command Line Startup.
login_account	Login account. Also can be specified in Command Line Startup.
login_pwd	Login password in plaintext. Also can be specified with login password ciphertext Also can be specified in Command Line Startup.
login_pwd_md5	Login password ciphertext (32-bit MD5 encrypted hexadecimal). When both ciphertext and plaintext exist, only ciphertext is used. Also can be specified with login password plaintext.
Lang	Language. Option: Simplified Chinese English
log_level	Log level of OpenD. Option: no (no log) debug (the most detailed) info (less detailed) info level by default.
push_proto_type	API protocol type. Determines the format of the package body. Option: 0 (pb) 1 (json) PB format by default
qot_push_frequency	API subscription data push frequency In milliseconds. Candlestick and Time Frame are not included. If not set, the frequency will not be limited.
telnet_ip	Remote operation command listening address. 127.0.0.1 by default.
telnet_port	Remote operation command listening port. If not set, remote command will not be enabled.
rsa_private_key	API protocol RSA encrypted private key (PKCS#1) file absolute path. If not set, the protocol will not be encrypted.
price_reminder_push	Whether to receive the price reminder. Option: 0: not received, 1: received (callback function set_handler needs to be set in the script). It will be pushed by default.
auto_hold_quote_right	Whether to automatically grab quote right after being kicked. Option: 0: No, 1: Yes (when this option is enabled, FutuOpenD will automatically grab back quote right after being grabbed. If it is robbed again within 10 seconds, the other terminal will get the highest quote right, and FutuOpenD will not grab it again). The permission will be robbed automatically by default.
future_trade_api_time_zone	Specify the futures trading API time zone. When trading API is called with futures accounts, the time involved is in accordance with this parameter. Also can be specified in Command Line Startup. If not set, the exchange time zone will be the default.
websocket_ip	WebSocket listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards) 127.0.0.1 by default.
websocket_port	WebSocket service listening port. If not set, WebSocket service will not be enabled.
websocket_key_md5	Key ciphertext (32-bit MD5 encrypted hexadecimal). Used to judge whether the connection is trusted when JavaScript scripts are connected.
websocket_private_key	WebSocket certificate private key file path. The private key cannot be configured with a password. If not configured, WebSocket is not enabled. It needs to be configured at the same time with the certificate.
websocket_cert	WebSocket certificate file path. If not configured, WebSocket is not enabled. It needs to be configured with the private key at the same time.
pdt_protection	Whether to turn on the Pattern Day Trade Protection. Specific parameters for FUTU US Option: 0: No, 1: Yes (We will prevent you from placing orders which might mark you as a Pattern Day Trader(PDT). The Protection can not guarentee that you won't be marked as a PDT. If you are marked as a PDT, you will not be allowed to open new positions until your equity is above $25000.) The Pattern Day Trade Protection will be turned on by default.
dtcall_confirmation	Whether to turn on the Day-Trading Call Warning. Specific parameters for FUTU US Option: 0: No, 1: Yes (We will prevent you from placing orders which might exceed your remaining day-trading buying power. We will alert you that you are placing orders that exceed your remaining day-trading buying power. If you close the positions today, you will receive a Day-Trading Call. The DT Call can ONLY be met by depositing funds in the full amount of the call.) The Day-Trading Call Warning will be turned on by default.

Tips

• To ensure safety of your trading accounts, if the listening address is not local, you must configure a private key to use the trading interface. The quote interface is not subject to this restriction.

• When the WebSocket listening address is not local, you need to configure SSL to start it, and a password should not be set during the certificate private key generation.

• Ciphertext is represented in hexadecimal after plaintext is encrypted by 32-bit MD5, which can be calculated by searching online MD5 encryption (note that there may be a risk of records colliding with libraries calculated through third-party websites) or by downloading MD5 computing tools. The 32-bit MD5 ciphertext is shown in the red box area (e10adc3949ba59abbe56e057f20f883e):

  

• OpenD reads FutuOpenD.xml in the same directory by default. On MacOS, due to the system protection mechanism, OpenD.app will be assigned a random path at run time, so that the original path can not be found. At this point, there are the following methods:

  • Execute fixrun.sh under tar package
  • Specify the configuration file path with the command line parameter -cfg_file, as described below

• The log level defaults to the info level. During the system development phase, it is not recommended to close the log or modify the log to the warning, error, fatal level to prevent failure to locate problems.

Step 3: Parameter Configuration

• Open and edit the configuration file OpenD.xml as the picture below. For general use, you only need to change your account and login password, and other options can be modified according to the instructions in the following table.

Configuration item list：

Configuration Item	Description
ip	listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards) the address of one of your network card 127.0.0.1 by default.
api_port	API protocol receiving port. 11111 by default. Also can be specified in Command Line Startup.
login_account	Login account. Also can be specified in Command Line Startup.
login_pwd	Login password in plaintext. Also can be specified with login password ciphertext Also can be specified in Command Line Startup.
login_pwd_md5	Login password ciphertext (32-bit MD5 encrypted hexadecimal). When both ciphertext and plaintext exist, only ciphertext is used. Also can be specified with login password plaintext.
Lang	Language. Option: Simplified Chinese English
log_level	Log level of OpenD. Option: no (no log) debug (the most detailed) info (less detailed) info level by default.
push_proto_type	API protocol type. Determines the format of the package body. Option: 0 (pb) 1 (json) PB format by default
qot_push_frequency	API subscription data push frequency In milliseconds. Candlestick and Time Frame are not included. If not set, the frequency will not be limited.
telnet_ip	Remote operation command listening address. 127.0.0.1 by default.
telnet_port	Remote operation command listening port. If not set, remote command will not be enabled.
rsa_private_key	API protocol RSA encrypted private key (PKCS#1) file absolute path. If not set, the protocol will not be encrypted.
price_reminder_push	Whether to receive the price reminder. Option: 0: not received, 1: received (callback function set_handler needs to be set in the script). It will be pushed by default.
auto_hold_quote_right	Whether to automatically grab quote right after being kicked. Option: 0: No, 1: Yes (when this option is enabled, FutuOpenD will automatically grab back quote right after being grabbed. If it is robbed again within 10 seconds, the other terminal will get the highest quote right, and FutuOpenD will not grab it again). The permission will be robbed automatically by default.
future_trade_api_time_zone	Specify the futures trading API time zone. When trading API is called with futures accounts, the time involved is in accordance with this parameter. Also can be specified in Command Line Startup. If not set, the exchange time zone will be the default.
websocket_ip	WebSocket listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards) 127.0.0.1 by default.
websocket_port	WebSocket service listening port. If not set, WebSocket service will not be enabled.
websocket_key_md5	Key ciphertext (32-bit MD5 encrypted hexadecimal). Used to judge whether the connection is trusted when JavaScript scripts are connected.
websocket_private_key	WebSocket certificate private key file path. The private key cannot be configured with a password. If not configured, WebSocket is not enabled. It needs to be configured at the same time with the certificate.
websocket_cert	WebSocket certificate file path. If not configured, WebSocket is not enabled. It needs to be configured with the private key at the same time.
pdt_protection	Whether to turn on the Pattern Day Trade Protection. Specific parameters for FUTU US Option: 0: No, 1: Yes (We will prevent you from placing orders which might mark you as a Pattern Day Trader(PDT). The Protection can not guarentee that you won't be marked as a PDT. If you are marked as a PDT, you will not be allowed to open new positions until your equity is above $25000.) The Pattern Day Trade Protection will be turned on by default.
dtcall_confirmation	Whether to turn on the Day-Trading Call Warning. Specific parameters for FUTU US Option: 0: No, 1: Yes (We will prevent you from placing orders which might exceed your remaining day-trading buying power. We will alert you that you are placing orders that exceed your remaining day-trading buying power. If you close the positions today, you will receive a Day-Trading Call. The DT Call can ONLY be met by depositing funds in the full amount of the call.) The Day-Trading Call Warning will be turned on by default.

Tips

• To ensure safety of your trading accounts, if the listening address is not local, you must configure a private key to use the trading interface. The quote interface is not subject to this restriction.

• When the WebSocket listening address is not local, you need to configure SSL to start it, and a password should not be set during the certificate private key generation.

• Ciphertext is represented in hexadecimal after plaintext is encrypted by 32-bit MD5, which can be calculated by searching online MD5 encryption (note that there may be a risk of records colliding with libraries calculated through third-party websites) or by downloading MD5 computing tools. The 32-bit MD5 ciphertext is shown in the red box area (e10adc3949ba59abbe56e057f20f883e):

  

• OpenD reads OpenD.xml in the same directory by default. On MacOS, due to the system protection mechanism, OpenD.app will be assigned a random path at run time, so that the original path can not be found. At this point, there are the following methods:

  • Execute fixrun.sh under tar package
  • Specify the configuration file path with the command line parameter -cfg_file, as described below

• The log level defaults to the info level. During the system development phase, it is not recommended to close the log or modify the log to the warning, error, fatal level to prevent failure to locate problems.

Step 4: Command Line Startup

• On the command line, change the directory to the folder which FutuOpenD is located, and run the following command to start Command Line FutuOpenD with configuration from FutuOpenD.xml.
  • Windows：FutuOpenD
  • Linux：./FutuOpenD
  • MacOS：./FutuOpenD.app/Contents/MacOS/FutuOpenD

Command Line Startup Parameters

• You can also start with parameters on the command line, some of which are the same as the FutuOpenD.xml configuration file. Parameter format: -key=value
  For example:
  • Windows：FutuOpenD.exe -login_account=100000 -login_pwd=123456 -lang=en
  • Linux：FutuOpenD -login_account=100000 -login_pwd=123456 -lang=en
  • MacOS：./FutuOpenD.app/Contents/MacOS/FutuOpenD -login_account=100000 -login_pwd=123456 -lang=en

Step 4: Command Line Startup

• On the command line, change the directory to the folder which OpenD is located, and run the following command to start Command Line OpenD with configuration from OpenD.xml.
  • Windows：OpenD
  • Linux：./OpenD
  • MacOS：./OpenD.app/Contents/MacOS/OpenD

Command Line Startup Parameters

• You can also start with parameters on the command line, some of which are the same as the OpenD.xml configuration file. Parameter format: -key=value
  For example:

  • 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

If the same parameters exist on both the command line and the configuration file, the command line parameters take precedence. For details of the parameters, please see the following table:

parameter list:

Configuration Item	Description
login_account	Login account. Also can be specified in configuration file.
login_pwd	Plaintext of login password. Also can be specified in configuration file.
login_pwd_md5	Login password ciphertext (32-bit MD5 encrypted hexadecimal). When both ciphertext and plaintext exist, only ciphertext is used. Also can be specified in configuration file.
cfg_file	The absolute path of OpenD configuration file. If not set, use OpenD.xml in the directory where the program is located.
console	Whether to display the console. Option: 0: background operation 1: console operation Console operation by default.
lang	OpenD language Option: Simplified Chinese English
api_ip	API service listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards) the address of one of your network card
api_port	API listening port.
help	Output startup command line parameters and exit the program.
log_level	Log level of OpenD. Option: no (no log) debug (the most detailed) info (less detailed)
no_monitor	Whether to start the daemon. Option: 0: start 1: do not start Start with the daemon by default.
websocket_ip	WebSocket listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards)
websocket_port	WebSocket service listening port.
websocket_private_key	WebSocket certificate private key file path. The private key cannot be configured with a password. If not configured, WebSocket is not enabled. It needs to be configured at the same time with the certificate.
websocket_cert	WebSocket certificate file path. If not configured, WebSocket is not enabled. It needs to be configured with the private key at the same time.
websocket_key_md5	Key ciphertext (32-bit MD5 encrypted hexadecimal). Used to judge whether the connection is trusted when JavaScript scripts are connected.
price_reminder_push	Whether to receive the price reminder. Option: 0: not received, 1: received (callback function set_handler needs to be set in the script). It will be pushed by default.
auto_hold_quote_right	Whether to automatically grab quote right after being kicked. Option: 0: No, 1: Yes (when this option is enabled, OpenD will automatically grab back quote right after being grabbed. If it is robbed again within 10 seconds, the other terminal will get the highest quote right, and OpenD will not grab it again). The permission will be robbed automatically by default.
future_trade_api_time_zone	Specify the futures Trade API time zone. When Trade API is called with futures accounts, the time involved is in accordance with this parameter. Also can be specified in configuration file.

Configuration Item	Description
login_account	Login account. Also can be specified in configuration file.
login_pwd	Plaintext of login password. Also can be specified in configuration file.
login_pwd_md5	Login password ciphertext (32-bit MD5 encrypted hexadecimal). When both ciphertext and plaintext exist, only ciphertext is used. Also can be specified in configuration file.
cfg_file	The absolute path of OpenD configuration file. If not set, use OpenD.xml in the directory where the program is located.
console	Whether to display the console. Option: 0: background operation 1: console operation Console operation by default.
lang	OpenD language Option: Simplified Chinese English
api_ip	API service listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards) the address of one of your network card
api_port	API listening port.
help	Output startup command line parameters and exit the program.
log_level	Log level of OpenD. Option: no (no log) debug (the most detailed) info (less detailed)
no_monitor	Whether to start the daemon. Option: 0: start 1: do not start Start with the daemon by default.
websocket_ip	WebSocket listening address. Option: 127.0.0.1 (for local connections) 0.0.0.0 (for connections from all network cards)
websocket_port	WebSocket service listening port.
websocket_private_key	WebSocket certificate private key file path. The private key cannot be configured with a password. If not configured, WebSocket is not enabled. It needs to be configured at the same time with the certificate.
websocket_cert	WebSocket certificate file path. If not configured, WebSocket is not enabled. It needs to be configured with the private key at the same time.
websocket_key_md5	Key ciphertext (32-bit MD5 encrypted hexadecimal). Used to judge whether the connection is trusted when JavaScript scripts are connected.
price_reminder_push	Whether to receive the price reminder. Option: 0: not received, 1: received (callback function set_handler needs to be set in the script). It will be pushed by default.
auto_hold_quote_right	Whether to automatically grab quote right after being kicked. Option: 0: No, 1: Yes (when this option is enabled, OpenD will automatically grab back quote right after being grabbed. If it is robbed again within 10 seconds, the other terminal will get the highest quote right, and OpenD will not grab it again). The permission will be robbed automatically by default.
future_trade_api_time_zone	Specify the futures Trade API time zone. When Trade API is called with futures accounts, the time involved is in accordance with this parameter. Also can be specified in configuration file.

:::