用途:通过本地 OpenD 网关接入富途/moomoo 账户,进行账户、持仓、订单、行情、历史数据查询以及下单、撤单操作,覆盖港股、美股、A股、新加坡股票。
主要能力:status 检查网关连通性并解析账户;account 查询账户;positions 查询持仓;orders 查询订单(可加 --executions);quote 查询行情;history 查询历史数据;place 下单(市价或限价);cancel 撤单。输出为 JSON,默认使用 paper(模拟)profile。
使用方式:富途不提供公开云 API,需先在本机下载并运行 OpenD,用富途账号登录(含手机/2FA),确认监听端口(默认 11111),并保持 OpenD 运行。首次运行需 pip install futu-api。配置 .env:FUTU_HOST(默认 127.0.0.1)、FUTU_PORT(默认 11111)、FUTU_TRD_MARKET(HK/US/CN/SG)、FUTU_SECURITY_FIRM(FUTUSECURITIES/FUTUINC/FUTUSG)、FUTU_ACC_ID(0 为自动解析)、FUTU_TRADE_PWD_MD5(仅实盘需要,为交易密码的 MD5)。命令示例:python skills/futu/scripts/futu_cli.py status;quote --symbol HK.00700;history --symbol US.AAPL --period 1d --limit 90;place --symbol HK.00700 --side buy --qty 100 --type limit --limit-price 350;cancel --order-id <id>。实盘需 --profile live --confirm-live 且配置 FUTU_TRADE_PWD_MD5。
适用场景:需要在本机或可访问 OpenD 的主机上查询富途账户与行情、执行模拟或实盘交易的用户。
限制:默认无法在 Starchild 容器内直接使用,因为 OpenD 运行在用户电脑上,容器内的 127.0.0.1 指向容器自身;需本地运行,或将 OpenD 部署到容器可访问的主机并设置 FUTU_HOST/FUTU_PORT(自行处理网络与安全,暴露 OpenD 有风险)。需已开通富途/moomoo 账户并启用 OpenAPI 权限;模拟交易需有 SIMULATE 子账户。下单数量必须为整股,不支持按金额下单;港股/A股有每手股数限制,零股可能被交易所拒绝。实盘下单需交易密码的 MD5,CLI 仅对实盘解锁交易上下文。若提示网关不可达,通常是 OpenD 未运行、未登录、位于其他机器或主机/端口配置错误。