SuperAPI AI 工具集

futu-quote

数据与分析

查看项目

更新于 11-06 06:47

技能介绍

富途行情(futu-quote)是一个行情数据技能,需依赖本地安装的官方 futu CLI,适合在智能体环境中回答证券行情查询类问题。

用途与范围 该技能用于查询股票、期权、期货等品种的行情信息,涵盖报价、K 线、快照、逐笔成交(tickers)、盘中数据、买卖盘口(order book)、排行榜与资金流向等。它定位为行情数据工具,不承担交易功能:真实证券交易应使用 futu-trading,模拟交易使用 futu-sim-trading,加密资产交易使用 futu-crypto。

运行环境与安装 使用前须具备官方 futu CLI。macOS 与 Linux 安装至 $HOME/.futu/bin/futu,Windows 安装 futu.exe 至 %LOCALAPPDATA%\FutuCLI\bin。技能要求先做运行时探测:

  • macOS / Linux:先检查 PATH 中的 futu,再检查 $HOME/.futu/bin/futu,均不可用则输出 FUTU_CLI_MISSING。
  • Windows(含 Git Bash):不要使用 install.sh,改用 PowerShell 检查 futu 命令或 %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 下载并执行 install.ps1(官方 Windows 安装器支持 amd64,若提示架构不支持应停止并转达)。安装或登录后若当前 shell 仍找不到命令,可直接调用上述绝对路径。已安装的 CLI 可用 futu update --check 检查更新,经用户同意后执行 futu update。

认证与调用约定 探测成功后,应执行 futu auth status --format json 检查登录状态;若未登录,提示用户运行 futu auth login,登录完成后再继续。CLI 会自动附带 OAuth Bearer token,不应读取或打印 token 文件内容;PERMISSION_DENIED 通常表示服务端权限或行情权限不足,不应解释为缺少 token。通过 Bash 调用时需在命令末尾追加隐藏内部标记 --source skill;自动识别失败且确认支持时,可追加 --agent codex 或 --agent claude_code;这些内部标记不应展示给用户。生成命令时使用最小参数集,CLI 已有默认值且用户未指定时不要显式传参;仅在需要程序化解析时加 --format json,供用户复制执行的命令可用默认表格输出。

标的与分页 行情代码必须为 MARKET.CODE 形式,如 HK.00700、US.AAPL、CC.BTCUSD。用户给出裸代码或旧格式时,仅在能确定市场时补全,否则先询问。用户提到旧 REST 端点名称时,应映射到当前聚合命令与选择器参数,不调用未注册的旧命令名。当前行情 CLI 不自动分页,需要“更多”“下一页”或完整列表时,用 --format json 读取响应游标,并按分页参考继续。

自选股与实时推送 watchlist --action add/delete/move-out 会修改用户自选股,除非用户已明确要求变更,否则须先确认目标分组与标的。实时推送(订阅、推送报价/盘口/逐笔/K 线、实时经纪队列)不能由 CLI 替代 OpenD,应引导用户使用 Open API Quote Push WebSocket(wss://webapi-quote.futunn.com/ws):先认证再订阅,经纪队列以 BROKER_QUEUE 消息到达;不应使用 OpenD 或已移除的 futuapi 订阅脚本。

参考文档 构建具体行情命令、选择选择器或核对必填/默认/分页参数时,查阅 CLI 参数参考;解释市场、证券类型、K 线类型、复权类型、交易时段、板块类型、期权筛选等枚举时,查阅行情命名字典;处理分页或 next_key、next_time、limit、count 时,查阅分页参考;需要实时推送或经纪队列时,查阅 WebSocket 推送参考。