跳转至

MCP 工具参考（全量自动生成）

auto-generated

本文件由 FutuOpenD-rs 自动生成工具产出, 跟随 daemon 每个 release 版本更新.

本索引覆盖 310 个公开工具。分组页面列出 scope / Python SDK 等价 / 参数 / alias 支持 / enum 双接（int OR string）/ deny_unknown_fields 行为 / runtime validate 规则 / JSON-RPC 调用示例。

约定

  • Scope: 决定该 tool 需要什么权限（qot:read / acc:read / trade:real | trade:simulate / trade:unlock）。MCP key 的 scopes 数组必须涵盖。缺失 → MCP CallToolResult.is_error=true + {"error": "unknown MCP tool …", "status": "error"} 或 unauthorized。
  • Python SDK 等价: 对应 py-futu-api 哪个接口——方便从 Python 迁移。
  • 必填列:
    • ✅ 表示字段必填
    • ✓ 默认 xxx 表示 serde 层有 #[serde(default = "xxx")] fallback
    • — 表示 Option<T> 可省略
  • Alias: 为兼容 py-futu-api / 旧 client 添加的同义字段名， deprecated — 新代码请用主字段名（表头第一列）。
  • 未知字段: 启用 deny_unknown_fields ——typo 字段名（如 stock vs 新路径 symbol）返 unknown field error 而不再 silent drop （防 silent-success 反模式）。
  • Enum 双接: market / sub_types / order_type / kl_type / op（price reminder）等字段同时接受整数 enum和字符串名。 具体接受值见每字段说明。
  • 返回: 所有 tool 返 JSON 文本；失败时 MCP 协议层 is_error=true + content 含 {"error": "...", "status": "error"}。

共通错误码

错误 典型来源
unknown MCP tool … tool 名拼错, 或 daemon 版本不支持该 tool (检查 futu-opend --version)
unauthorized API key 缺对应 scope
gateway connect failed: … futu-opend 未启动 / 端口不对
unknown field \"…\" deny_unknown_fields 命中（typo 字段名）
backend proto 错（ret_type != 0） 原始 JSON 结构 ret_msg 携带具体原因

快速跳转

工具名索引（字母顺序）