核心用法
本 Skill 通过 MCP 协议接入富途 OpenAPI,支持港股、美股、A 股三大市场的实时数据获取。用户需先部署 Futu OpenD 后台服务,配置 FUTU_HOST 和 FUTU_PORT 环境变量后即可调用。
主要功能模块:
- 实时行情:
get_stock_quote、get_market_snapshot获取即时报价与买卖盘快照 - K 线数据:
get_history_kline查询历史日线/分钟线,get_cur_kline获取实时 K 线(需先订阅) - 期权工具:
get_option_chain查询期权链,支持蝶式/鹰式策略组合 - 账户信息:
get_funds、get_positions、get_max_power等交易账户数据 - 智能筛选:
get_stock_filter支持无代码条件下的多维度股票筛选(价格、涨跌幅、成交量等)
调用流程:明确股票代码(如 HK.00700)时直接查询;仅给条件(如「港股 10-50 元」)时用筛选工具;需实时推送数据时先执行 subscribe。
显著优点
1. 官方数据背书:直接对接富途证券 OpenAPI,行情数据与交易终端同源,延迟低、可靠性高
2. 市场覆盖全面:同时支持港股主板/创业板、美股纳斯达克/纽交所、A 股沪深主板,一站式解决跨市场数据需求
3. 功能深度完整:不仅覆盖基础报价,还提供 Level-2 级买卖盘、逐笔成交、经纪队列等专业数据
4. 筛选能力强大:get_stock_filter 支持 250+ 筛选条件组合,适合量化初筛与策略研究
5. 开源透明:MCP Server 源码公开(GitHub),可自行审计与二次开发
潜在缺点与局限性
1. 部署门槛较高:必须独立安装并维护 OpenD 服务,对非技术用户不够友好;Windows/Linux/macOS 配置差异大
2. 订阅机制复杂:实时 K 线、逐笔成交等高级数据需先订阅才能查询,增加调用链路复杂度
3. 限频严格:筛选接口 30 秒限 10 次,历史 K 线 30 天内限 30 只股票,高频量化场景受限
4. 账户功能依赖实盘:资金、持仓、交易力等接口需真实富途账户登录,模拟环境支持不完善
5. 代码格式强制:必须使用 {市场}.{代码} 格式(如 US.AAPL),不支持纯代码或简称直接查询
适合人群
- 个人量化投资者:需要程序化获取富途行情数据进行策略回测或信号监控
- 跨市场交易者:同时操作港股、美股、A 股,希望统一数据接口
- 期权策略研究者:需要快速查询期权链及组合策略盈亏分析
- 有一定技术基础的用户:能独立完成 Python 环境配置、OpenD 部署及故障排查
常规风险
1. 连接稳定性风险:OpenD 进程可能异常退出,需自行实现保活与重连机制
2. 数据订阅遗漏:忘记 subscribe 直接查询会导致空数据或报错,需严格遵循调用顺序
3. 限频触发:高频调用筛选或 K 线接口可能被临时限制,建议本地缓存结果
4. 账户安全风险:配置文件中需存储富途账号密码,存在本地泄露风险;建议配合密码管理工具或环境变量注入
5. 合规边界:获取的实时行情数据仅限个人研究使用,商业化分发或搭建对外服务可能违反富途用户协议