Futu Trading Bot

核心用法

本技能是一套基于富途OpenAPI的港股交易机器人封装层，提供自然语言交互接口。主要功能模块包括：

账户管理：查询账户信息、解锁/锁定交易权限，支持密码MD5或明文配置。

行情服务：支持股票基础信息查询、市场状态获取、实时快照（免订阅）、K线数据（当前及历史）、逐笔成交记录。订阅模式下可设置回调函数实现实时推送。

交易执行：封装下单、改单、撤单功能，支持限价/市价单，需显式指定账户ID（acc_id）和交易环境（SIMULATE或REAL）。

策略运行：提供策略状态管理、交易锁、交易时间窗口检查等辅助工具，但不内置进程管理——需通过系统工具（exec、kill等）以独立Python脚本形式后台运行策略。

显著优点

1. 自然语言交互：用户可用"买100股腾讯，限价350"等自然语言直接触发交易。

2. 连接生命周期优化：拉取式行情和交易函数自动关闭上下文，避免资源泄漏；订阅流需显式关闭。

3. 安全沙箱感知：文档明确提示受限沙箱环境（如OpenClaw/Codex exec）需使用host/elevated模式，并预检~/.com.futunn.FutuOpenD/Log目录访问权限。

4. 强制封装层：通过文档强调禁止直接调用`ctx.place_order`等原生SDK，确保参数校验、连接管理和错误处理生效。

潜在缺点与局限性

• 强本地依赖：必须运行富途OpenD本地服务（端口11111），且SDK导入阶段即访问用户目录日志文件，容器化部署受限。

• 无内置策略持久化：策略需用户自行实现进程管理、状态持久化和异常恢复。

• 港股限定：行情权限默认依赖HK市场授权，A股/美股支持取决于OpenD配置。

• 密码安全：支持明文密码配置（自动MD5转换），存在配置泄露风险；虽推荐MD5但非强制。

适合人群

• 已有富途账户且熟悉OpenD配置的港股投资者
• 需快速原型验证量化策略的开发者
• 熟悉Python和命令行工具的技术型交易员

常规风险

| 风险类别 | 说明 |

|---------|------|

| 资金风险 | 支持`REAL`实盘交易，误操作可能导致真实亏损；默认`SIMULATE`环境降低风险 |

| 连接失效 | OpenD服务中断或网络波动会导致行情/交易失败，需预检和重试机制 |

| 策略失控 | 后台策略进程需用户自行管理，异常退出或信号处理不当可能导致状态不一致 |

| 配置泄露 | `config.json`含账户信息和密码（或MD5），需限制文件权限 |

| 沙箱限制 | 部分运行时环境无法访问OpenD日志目录，需降级为host模式执行 |

核心用法

futu-trading-bot 是基于富途牛牛官方 OpenAPI 封装的交易机器人技能，提供自然语言驱动的港股交易能力。核心功能模块包括：

| 模块 | 关键函数 | 用途 |

|------|---------|------|

| 账户管理 | `get_account_info`, `unlock_trade`, `lock_trade` | 查询账户、解锁/锁定交易权限 |

| 行情服务 | `get_market_snapshot`, `get_cur_kline`, `request_history_kline` | 实时报价、K线数据、逐笔成交 |

| 订阅推送 | `subscribe`, `start_quote_stream` | 实时监控、回调驱动策略 |

| 交易执行 | `submit_order`, `modify_order`, `cancel_order` | 下单、改单、撤单 |

| 策略运行 | `run_strategy` + `StrategyState`, `TradeGuard` | 状态管理、交易窗口、冷却机制 |

标准工作流程：预检 → 获取账户 → 拉取行情 → 解锁交易（实盘）→ 执行订单 → 策略监控。

显著优点

1. 封装完善：屏蔽底层 SDK 复杂性，提供统一的错误处理和连接生命周期管理
2. 风险控制：默认 SIMULATE 环境、强制 acc_id 和 trd_env 参数、交易锁机制
3. 策略友好：内置 TradeGuard、交易窗口判断、冷却时间等量化交易常用工具
4. 背景执行：通过系统工具（exec/write/kill）支持长期运行策略，避免技能内部进程管理负担
5. 依赖可靠：仅依赖官方 futu-api 和知名开源库 pydantic，无供应链风险

潜在缺点与局限性

• 本地依赖：必须运行 Futu OpenD（端口 11111），受限沙箱需 host/elevated 模式
• 港股为主：设计以港股（HK.00700 等）为默认用例，其他市场支持待验证
• 进程外策略：背景策略需用户自行管理 PID 和日志，无内置 Web 界面或状态面板
• 敏感配置：交易密码存储在本地 JSON，需用户自行保护（建议 MD5 + 权限 600）

适合人群

• 量化交易开发者：需要快速搭建自动化港股策略
• 富途用户：已开通 OpenD 权限，熟悉富途生态
• 技术型投资者：具备 Python 基础，能接受命令行/脚本交互
• 不适合：无编程经验、未开通富途 API、追求完全托管云端策略的用户

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 资金风险 | 误配置 `trd_env="REAL"` 可能导致实盘误交易 | 双重确认机制、SIMULATE 默认、交易锁 |

| 密码泄露 | 配置文件中 `trade_password` 以明文/MD5存储 | `.gitignore` 保护、`chmod 600`、优先 MD5 |

| 连接失败 | OpenD 未运行或沙箱受限导致功能不可用 | 预检脚本 `preflight_check`、host 模式 |

| 策略异常 | 后台进程崩溃无自动重启 | 自行监控 PID、日志分析、信号处理 |