moomoo 交易

当用户需要通过moomoo/富途OpenAPI及本地OpenD网关获取市场数据或进行股票交易时，使用此技能。

请先阅读

• - 阅读 references/setup-guide.md 了解安装、包选择（futu-api 与 moomoo-api）、OpenD登录及故障排除。
• 当需要确切的函数名、返回结构或交易查询语义时，请阅读 references/api-reference.md。
• 所有捆绑脚本均采用延迟加载SDK的方式，因此即使尚未安装任何Python包，--help 也能正常工作。

安全规则

• - 默认使用模拟交易，除非用户明确要求实盘交易。
• 实盘下单、修改和撤单需要 --env real --confirm。
• scripts/trade.py 默认还需要通过 MOOMOOUNLOCKPASSWORD 提供实盘交易解锁密码，或通过 --unlock-password-env 传入其他环境变量名称。脚本会在执行请求的操作后解锁并重新锁定。
• 对于撤单/修改操作，请传递 --market，除非同时提供股票代码以便脚本推断正确的交易上下文。
• 请勿将原始交易密码直接放在命令行中。请使用环境变量。

脚本

设置检查

bash
python3 scripts/setup_check.py
python3 scripts/setup_check.py --market HK --account-index 1

检查行情连接，列出已发现的交易账户，并验证模拟账户访问权限。

行情与K线

bash
python3 scripts/quote.py US.AAPL HK.00700
python3 scripts/quote.py US.TSLA --snapshot
python3 scripts/quote.py US.NVDA --kline --ktype K_DAY --count 10
python3 scripts/quote.py US.NVDA --kline --start 2026-03-01 --end 2026-04-01 --extended-time

交易

bash
python3 scripts/trade.py --ticker US.AAPL --action buy --qty 10 --price 150 --type limit --env sim
python3 scripts/trade.py --ticker US.AAPL --action sell --qty 5 --type market --env sim
export MOOMOOUNLOCKPASSWORD=your-trading-password
python3 scripts/trade.py --ticker US.AAPL --action buy --qty 10 --type market --env real --confirm
python3 scripts/trade.py --cancel --order-id 12345 --market US --env sim
python3 scripts/trade.py --modify --order-id 12345 --market US --price 155 --qty 10 --env sim

实用附加选项：

• - --remark 添加订单备注。
• --account-id / --account-index 可指定特定交易账户。

投资组合、订单与成交

bash
python3 scripts/portfolio.py --env sim
python3 scripts/portfolio.py --env sim --account
python3 scripts/portfolio.py --env sim --orders
python3 scripts/portfolio.py --env real --history-orders --start 2026-04-01 --end 2026-04-02
python3 scripts/portfolio.py --env real --deals

--orders 显示未结订单。--history-orders 显示历史订单。--deals 显示今日成交，或与 --start / --end 配合使用时显示历史成交。

价格提醒

bash
python3 scripts/watchlist.py --tickers US.AAPL,US.TSLA --above 200 --below 150
python3 scripts/watchlist.py --tickers US.NVDA --above 950 --quit-on-alert
python3 scripts/watchlist.py --tickers HK.00700 --below 320 --once

默认情况下，每个阈值触发一次提醒。使用 --repeat-alerts 可在每个轮询周期重复触发提醒。