用途
本技能用于通过本地富途 futu CLI 进行模拟(纸上)交易,覆盖模拟账户、资金、持仓、模拟委托查询、历史委托分页、最大买入/卖出数量等操作。它面向模拟账户,不执行真实证券交易;真实交易、加密货币交易和行情查询分别使用 futu-trading、futu-crypto 和 futu-quote。
主要能力
- 查询模拟账户列表,识别目标模拟账户。
- 查询模拟账户资金与持仓。
- 查询模拟委托,以及按分页读取历史模拟委托。
- 查询最大买入/卖出数量。
- 以 JSON 输出结构化结果,便于程序解析。
- 支持市场代码格式如
HK.00700、US.AAPL。
使用方式
运行前需先探测 futu CLI 是否可用并检查登录状态。macOS/Linux 安装路径为 $HOME/.futu/bin/futu,Windows 为 %LOCALAPPDATA%\FutuCLI\bin\futu.exe。若探测输出 __FUTU_CLI_MISSING__,需先征得用户同意再安装:
macOS / Linux:
curl -fsSL https://raw.githubusercontent.com/FutunnOpen/futu-cli/main/scripts/install.sh | sh
Windows PowerShell:
iwr -UseBasicParsing https://raw.githubusercontent.com/FutunnOpen/futu-cli/main/scripts/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1
安装后运行 futu version 验证。若登录状态为未登录,提示用户运行 futu auth login 后再继续。生成命令时使用最小参数集;优先运行 futu sim account list --format json 识别模拟账户,再在后续命令中显式传入 --account。历史委托使用 --next-key 分页,时间参数 --start、--end 使用微秒时间戳。模拟委托不影真实账户,但会改变模拟账户状态,因此目标账户、代码、买卖方向、数量、价格或订单 ID 不明确时,应先查询或询问用户。调用时在 Bash 命令末尾追加内部标记 --source skill,且不向用户展示该内部标记。
适用场景
适合以自然语言方式查询富途模拟账户资产、持仓和委托记录,进行模拟下单操作,以及需要分页拉取历史模拟委托的场景。
限制
仅作用于模拟账户,不涉及真实资金;需要本地安装官方 futu CLI 并完成登录;权限拒绝(PERMISSION_DENIED)属于服务端权限问题;不读取或打印 token 文件内容;Windows 官方安装器仅支持 amd64,遇到不支持的架构需停止并转达提示。