CLI 参数¶
完整 flag 列表。也可以跑 --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 文件或目录 (v1.4.87+ dir 0700 / file 0600 on Unix) |
--tz <IANA> |
— | v1.4.87+：时区覆盖 (如 Asia/Hong_Kong / America/New_York)，影响 hours_window 限额检查 |
--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¶
CLI vs REST/MCP 参数命名对照（v1.4.84 加）¶
CLI 的 9 个命令原本用位置参数（<OWNER> / <SYMBOLS> / <GROUP> 等），
和 REST/MCP 的命名参数习惯（--code / --owner / --acc-id）不一致。
v1.4.84 起 CLI 加了 REST/MCP 风格 alias，位置参数依旧 work（向后兼容）。
| 命令 | 位置参数 | v1.4.84+ alias | 示例 |
|---|---|---|---|
option-chain |
<OWNER> |
--owner / --code |
futucli option-chain --owner US.AAPL --begin 2026-05-15 --end 2026-06-20 |
option-expiration-date |
<OWNER> |
--owner |
futucli option-expiration-date --owner HK.800000 |
suspend |
<SYMBOLS> |
--code / --symbols |
futucli suspend --code HK.00700 --begin 2026-04-01 --end 2026-04-15 |
margin-ratio |
<SYMBOLS> |
--code / --symbols |
futucli margin-ratio --code HK.00700 --market HK --acc-id <acc> |
user-security |
<GROUP> |
--group |
futucli user-security --group MyList |
plate-stocks |
<PLATE> |
--plate |
futucli plate-stocks --plate HK.BK1001 |
acc-cash-flow |
<ACC_ID> |
--acc-id |
futucli acc-cash-flow --acc-id <acc> --date 2026-04-15 |
plate-list |
--set <SET> |
--plate-type |
futucli plate-list -m HK --plate-type industry |
daemon-status |
--rest-url <URL> |
--rest-port <PORT> |
futucli daemon-status --rest-port 22222 |
两种风格可任选。位置参数适合 shell 速查，--owner/--code 适合脚本 / 从
REST/MCP API 文档复制命名。
全局¶
| Flag | 默认 | 说明 |
|---|---|---|
-g, --gateway <addr> / env FUTU_GATEWAY |
127.0.0.1:11111 |
网关地址 |
-o, --output <format> |
table |
table / json / jsonl（jsonl 每行一个 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-list <market> |
板块集合列表 |
plate-stocks <plate-id> |
列出板块内股票 |
sub <symbols...> -t <types> |
订阅（types: basic/orderbook/ticker/broker/rt/kline） |
account |
账户列表 |
funds <acc-id> --market HK |
资金 |
position <acc-id> --market HK |
持仓 |
order <acc-id> --market HK |
当日订单 |
deal <acc-id> --market HK |
当日成交 |
unlock-trade --env real [--otp <code>] [--security-firm <FIRM>] [--acc-ids <CSV>] |
解锁交易（提示输入密码）；v1.4.31+ --otp 传令牌动态密码，账户开启 2FA 时用；v1.4.33+ --security-firm 只解锁该券商（可填 1-7 数字、官方名 FutuHK/FutuUS/FutuSG/FutuAU/FutuCA/FutuMY/FutuJP、或短别名 hk/us/sg/au/ca/my/jp），不传 = 解锁所有 broker；v1.4.34+ --acc-ids 逗号分隔 acc_id 列表只解锁指定账户（和 --security-firm 取交集，解决影子子账户问题） |
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（共享长连接 + 推送实时显示） |
history-orders / history-deals |
v1.4.25+：历史订单 / 成交查询 |
max-qtys |
v1.4.25+：下单前算最大可买卖量 |
place-order / modify-order / cancel-order |
v1.4.25+：下单 / 改单 / 撤单（real 必须 --confirm，默认 env=simulate） |
capital-flow <symbol> |
v1.4.26+：资金流时间序列 |
capital-distribution <symbol> |
v1.4.26+：资金分布（超大/大/中/小单流入流出） |
market-state <symbols> |
v1.4.26+：市场状态（开盘/休市/午休/盘后） |
owner-plate <symbols> |
v1.4.26+：股票所属板块 |
option-chain <owner> --begin --end [--delta-min/--iv-max/...] |
v1.4.26+：期权链（按到期日 call/put 列表；支持 Greek server-side filter） |
trading-days --market --begin --end |
v1.4.30+：交易日列表 |
rehab <symbol> |
v1.4.30+：复权因子（长期 K 线对齐 / 回测必用） |
suspend <symbols> --begin --end |
v1.4.30+：停牌日查询 |
user-security <group> |
v1.4.30+：自选股分组下的股票 |
user-security-groups [--group-type] |
v1.4.30+：自选股分组列表 |
warrant [--owner] [--num] |
v1.4.30+：涡轮列表（按成交量降序） |
ipo-list --market <HK/US/CN> |
v1.4.30+：新股 IPO |
future-info <symbols> |
v1.4.30+：期货合约资料 |
stock-filter --market [--begin --num] |
v1.4.30+：条件选股最小版（高级过滤走 REST） |
cancel-all-order <acc-id> [--market] [--confirm] |
v1.4.30+：全部撤单（real 必须 --confirm） |
global-state |
v1.4.30+：网关全局状态（市场开闭/服务器版本/登录状态） |
user-info |
v1.4.30+：用户信息（昵称/权限/配额） |
delay-statistics |
v1.4.30+：延迟统计概要 |
query-subscription [--all-conn] |
v1.4.30+：查询当前订阅状态 |
used-quota |
v1.4.110+：查询当前已用订阅额度和历史 K 线额度 |
unsubscribe [--symbols --sub-types] [--all] |
v1.4.30+：反订阅行情数据 |
history-kl-quota [--detail] |
v1.4.30+：历史 K 线下载配额 |
holding-change <symbol> --category |
v1.4.30+：持股变动（高管 / 机构 / 基金） |
modify-user-security <group> --op <symbols> |
v1.4.30+：修改自选股分组 |
code-change <symbols> |
v1.4.30+：股票代码变更 / 临时代码（目前港股） |
set-price-reminder <symbol> --op |
v1.4.30+：设置到价提醒 |
price-reminder [--symbol/--market] |
v1.4.30+：查询到价提醒 |
option-expiration-date <owner> |
v1.4.30+：期权到期日列表 |
sub-acc-push <acc-ids> |
v1.4.30+：订阅账户推送（订单 / 成交变更） |
acc-cash-flow <acc-id> --date / --date-range |
v1.4.30+：账户资金流水（v1.4.32+ 支持日期范围，31 天硬上限，自动跳周末） |
daemon-status [--rest-url --api-key] |
v1.4.32+：daemon 健康快照（登录 / broker 通道 / cipher 就绪度） |
daemon-reload [--rest-url --api-key] |
v1.4.32+：清 cipher 缓存 + v1.4.47 刷新磁盘凭据（remember-login） |
daemon-shutdown [--rest-url --api-key] |
v1.4.32+：优雅退出 daemon（1 秒内），systemd / Docker 决定是否重启 |