CLI 参数
完整 flag 列表。也可以跑 --help 查看：
futu-opend --help
futu-mcp --help
futucli --help
futu-opend
| Flag |
默认 |
说明 |
--login-account <id> |
— |
牛牛号（必填之一） |
--login-pwd <pwd> |
— |
登录密码明文（v1.4.18+ 会打 deprecation WARN，推荐走 keychain） |
--login-pwd-md5 <hex> |
— |
登录密码 MD5（同样 argv 暴露，会 WARN） |
--login-pwd-file <path> |
— |
v1.4.18+：从文件读密码（Docker secrets / systemd LoadCredential 友好） |
--login-region <gz/sh/hk> |
— |
后端连接区域（v1.4+） |
--config <path> |
— |
TOML 配置文件（v1.4.2+），字段和 CLI 参数一致，CLI 覆盖 |
--cfg-file <path> |
— |
XML 配置文件，兼容 C++ FutuOpenD.xml 格式 |
--ip <addr> |
0.0.0.0 |
监听 IP |
--port <n> |
11111 |
FTAPI TCP 端口 |
--rest-port <n> |
— |
REST 端口（含 /ws） |
--rest-keys-file <path> |
— |
REST Bearer Token keys.json |
--grpc-port <n> |
— |
gRPC 端口 |
--grpc-keys-file <path> |
— |
gRPC Bearer Token keys.json |
--websocket-port <n> |
— |
核心 WS 端口（Futu SDK） |
--ws-keys-file <path> |
— |
核心 WS 握手鉴权 keys.json（v1.0+） |
--telnet-port <n> |
— |
管理 telnet |
--lang <chs/cht/en> |
chs |
界面语言 |
--log-level <level> |
info |
trace/debug/info/warn/error |
--json-log |
false |
stdout JSON 日志 |
--audit-log <path> |
— |
审计 JSONL 文件或目录 |
--rsa-private-key <path> |
— |
RSA 私钥 PEM（给客户端用 RSA 加密） |
--platform <futunn/moomoo> |
futunn |
账号平台（v1.4.14+）。futunn=牛牛（CN/HK），moomoo（US/SG/AU/JP/CA） |
--auth-server <url> |
根据 --platform 推导 |
自定义认证服务器 URL，覆盖 --platform |
--device-id <hex> |
自动派生 |
设备 ID（16 位 hex，v1.4.16+）。显式指定并更新 ~/.futu-opend-rs/device-<hash>.dat |
--reset-device |
false |
v1.4.17+：启动前清空 device + credentials 文件，下次 login 走完整首登（SMS） |
--setup-only |
false |
v1.4.17+：只完成首登 + 凭据缓存就退出，不启动 server（systemd/Docker 场景） |
futu-mcp
| Flag |
默认 |
说明 |
--gateway <addr> |
127.0.0.1:11111 |
网关 TCP 地址 |
--keys-file <path> |
— |
keys.json（scope 模式） |
--api-key <plaintext> / env FUTU_MCP_API_KEY |
— |
启动时绑定的 key 明文 |
--enable-trading |
false |
(legacy) 允许交易写工具；配 keys-file 时忽略 |
--allow-real-trading |
false |
(legacy) 允许 real 环境；配 keys-file 时忽略 |
--audit-log <path> |
— |
审计 JSONL |
--http-listen <addr> |
— |
HTTP transport（v1.0+），不传则 stdio |
-v, --verbose |
false |
debug 日志 |
futucli
全局
| Flag |
默认 |
说明 |
-g, --gateway <addr> / env FUTU_GATEWAY |
127.0.0.1:11111 |
网关地址 |
-o, --output <format> |
table |
table / json |
-v, --verbose |
false |
debug 日志 |
--audit-log <path> |
— |
审计 JSONL（v1.2+） |
子命令
| 子命令 |
说明 |
ping |
ping 网关 |
quote <symbols...> |
实时报价 |
snapshot <symbols...> |
快照 |
kline <symbol> [--type day] [--count 100] |
K 线 |
orderbook <symbol> [--depth 10] |
买卖盘 |
ticker <symbol> [--count 100] |
逐笔 |
rt <symbol> |
分时 |
static <symbols...> |
静态信息 |
broker <symbol> |
经纪商队列 |
plate <market> |
板块列表 |
sub <symbols...> -t <types> |
订阅（types: basic/orderbook/ticker/broker/rt/kline） |
accounts |
账户列表 |
funds <acc-id> --market HK |
资金 |
positions <acc-id> --market HK |
持仓 |
orders <acc-id> --market HK |
订单 |
deals <acc-id> --market HK |
成交 |
unlock-trade --env real |
解锁交易（提示输入密码） |
set-trade-pwd |
把交易密码写入 OS keychain（供 futu-mcp 的 futu_unlock_trade 工具读；v1.4+） |
clear-trade-pwd |
从 OS keychain 删除交易密码（v1.4+） |
set-login-pwd --account <id> |
v1.4.18+：把某账号的登录密码存 OS keychain（opend 启动免 --login-pwd） |
clear-login-pwd --account <id> |
v1.4.18+：删除 keychain 里某账号的登录密码 |
gen-key --id <n> --scopes <list> |
生成 key |
list-keys |
列所有 key |
revoke-key <id> |
吊销 |
bind-key <id> --this-machine / --replace / --clear / --freeze |
就地改机器绑定 |
machine-id [--for-key <id>] |
查本机机器指纹 |
repl |
交互式 REPL（共享长连接 + 推送实时显示） |