SuperAPI AI 工具集

futu-trading

办公与效率

查看项目

更新于 11-06 06:47

技能介绍

用途 futu-trading 是基于本地 futu CLI 的证券交易技能,覆盖 OAuth 状态查询、证券账户与资金信息、持仓、现金流水、订单费用、保证金比例,以及订单下单、修改、撤销等交易操作。用户提问时默认使用用户语言回答,命令、参数、JSON 字段、错误码、代码保持原样。

运行环境 该技能依赖官方 futu CLI。macOS 与 Linux 安装到 $HOME/.futu/bin/futu,Windows 安装 futu.exe 到 %LOCALAPPDATA%\FutuCLI\bin。任何业务命令前应先探测 futu:macOS/Linux 可使用 command -v futu 或检查 $HOME/.futu/bin/futu;Windows(含 Git Bash)不要使用 bash 探测块或 install.sh,改用 PowerShell 检查 futu 命令或 %LOCALAPPDATA%\FutuCLI\bin\futu.exe。探测输出 FUTU_CLI_MISSING 表示需停止,先询问用户是否安装,获同意后才可执行官方安装脚本;Windows 安装器支持 amd64,若报告不支持架构应停止并转达信息。不得在未获明确同意时运行安装器。安装后可运行 futu version;已安装可用 futu update --check 检查更新,获同意后执行 futu update。

登录与调用 探测成功后,业务输出为 futu auth status --format json;若返回未登录,应告知用户运行 futu auth login,登录后再继续。从 Bash 调用时在命令末尾附加隐藏内部标记 --source skill,使 CLI 自动识别 Codex、Claude Code 等主机并报告 agent_name;仅在自动识别失败且确认支持时追加 --agent codex 或 --agent claude_code。这些内部标记不应展示给用户。不要读取或打印 token 文件内容,CLI 会自动附加 OAuth Bearer token;PERMISSION_DENIED 表示服务端权限拒绝,不应解释为缺少 token。

参数与分页 生成命令时使用最小参数集,CLI 已有默认值且用户未指定时不要显式传该参数。不要假定已配置默认账户:仅当本轮已通过 futu auth status 或 config 确认默认账户时才省略 --account,否则列出账户或请用户选择并显式传 --account。需要解析输出、提取账户/订单/成交字段或后续动作依赖结果时加 --format json;仅供用户复制运行的命令可用默认表格输出。证券订单与成交列表由 CLI 分页合并,不要手动传 page_flag,仅在需要时调整 --page-size。account cash-logs 每次返回一页,应使用 --format json 读取 page_flag 与 completed,并用 --page-flag 再次调用直到 completed 为 true 或用户已获得足够数据。order fees 需要具体 order_id(来自订单列表、历史或详情),Open API 暂不支持外汇订单费用。margin-ratio 需要 --security-firm 与 --codes(最多 10 个代码),优先使用 account list --format json 中该用户的 security_firm。

交易确认与限制 改变真实资产的命令(order buy、order sell、order place、order modify、order cancel)需要用户明确确认。不要代为猜测二次确认:若 CLI 因 API 返回 need_order_confirm=true 或 confirm_id 而报告券商确认,应原样转达并等待用户明确同意后再输入 y。构建具体命令、检查必填/默认/可选参数、处理分页或映射字段时参考 CLI 参数文档;选择或解释市场、买卖方向、订单类型、状态、账户市场字典与响应字段时参考字典文档。加密货币交易应使用 futu-crypto。

适用场景 适合在本地已安装并登录 futu CLI 的环境中,通过 AI 助手查询富途证券账户信息、资金与持仓、现金流水、订单费用和保证金比例,以及在用户明确确认后执行交易操作。限制包括:必须本地安装官方 CLI;Windows 安装器仅支持 amd64;Open API 暂不支持外汇订单费用;真实资产操作必须用户确认。