SuperAPI AI 工具集

futu-sim-trading

办公与效率

查看项目

更新于 11-06 06:47

技能介绍

用途

本技能用于通过本地富途 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,遇到不支持的架构需停止并转达提示。