Futu Client

核心功能

Futu API Skill 是对富途证券官方 OpenAPI Python SDK (futu-api) 的二次封装，提供简化的股票交易与数据查询接口。该技能本质上是一个本地代理客户端，需配合 FutuOpenD 守护进程运行，后者负责与富途服务器建立加密连接。

显著优点

1. 多市场覆盖：完整支持港股（HK.前缀）、美股（US.前缀）、A股沪深（SH./SZ.前缀）三大市场
2. 交易功能完整：涵盖持仓查询、账户资产、下单/改单/撤单、今日成交/历史成交、最大可买卖数量等全链路交易能力
3. 双环境隔离：通过 TrdEnv.REAL 与 TrdEnv.SIMULATE 明确区分实盘与模拟交易，降低误操作风险
4. DataFrame 友好：所有查询接口默认返回 pandas DataFrame，便于后续数据分析
5. 自选股管理：支持获取用户自定义分组（"全部"/"港股"/"美股"/"沪深"等）的自选股列表

潜在局限与风险

| 维度 | 说明 |

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

| **本地依赖** | 必须预先安装并运行 FutuOpenD（默认 127.0.0.1:11111），无法在纯云端环境使用 |

| **认证门槛** | 实盘交易需解锁交易密码，且账户权限受券商端控制 |

| **网络延迟** | 行情与交易指令经本地→富途服务器→交易所链路，存在额外延迟 |

| **API 稳定性** | 依赖富途官方 SDK 版本，接口变更可能导致兼容性问题 |

| **资金安全** | 代码层无额外风控拦截，误操作 `TrdEnv.REAL` 可能直接产生真实成交 |

适合人群

• 已开通富途证券账户、有量化交易需求的个人投资者
• 需要自动化获取持仓/成交数据用于本地分析的用户
• 希望在模拟环境验证策略后再切实盘的交易策略开发者

常规风险提示

• 环境切换风险：TrdEnv 参数误设为 REAL 可能导致非预期实盘下单
• 本地服务依赖：FutuOpenD 未启动或端口冲突时所有接口均不可用
• 密码安全：解锁交易的密码可能在代码中以明文或变量形式存在，需注意代码保管
• 无内置风控：技能本身不包含止损、仓位限制等风控逻辑，需用户自行实现

核心用法

Futu Client Skill 是富途 OpenAPI 的 Python 客户端封装，为量化交易者和开发者提供简洁的证券交易接口。使用前需先在本地运行 FutuOpenD 服务（默认 127.0.0.1:11111），通过 pip install futu-api pandas 安装依赖后即可调用。

该 Skill 覆盖完整交易链路：持仓查询（get_positions）、账户信息（get_account_info）、委托下单（place_order）、订单管理（get_orders/modify_order）、成交明细（get_today_deals）、历史记录（get_history_orders）及行情报价（get_quote/get_market_snapshot）。同时支持自选股管理（get_watchlist），方便策略研发。

交易环境灵活切换：TrdEnv.SIMULATE 模拟盘用于策略验证，TrdEnv.REAL 实盘需交易密码解锁。支持港股（HK.00700）、美股（US.AAPL）、A股（SH.600000）三大市场，返回标准 DataFrame 便于数据分析。

显著优点

官方生态兼容：直接调用富途官方 futu-api SDK，非第三方破解，接口稳定性与合规性有保障。

本地化安全架构：仅与本地 FutuOpenD 进程通信，零外部网络暴露，杜绝 API 密钥云端泄露风险。代码无 eval/exec/system 危险函数，无硬编码敏感信息。

数据即拿即用：返回 pandas DataFrame 结构化数据，含持仓盈亏比、成本价、市价等字段，无缝对接量化分析流程。

轻量封装易扩展：源码 400 余行，结构清晰，开发者可快速二次开发自定义策略，对接回测框架。

潜在局限

环境依赖刚性：必须常驻 FutuOpenD，Windows/Mac 需保持富途牛牛客户端运行，Linux 需单独部署守护进程，云端服务器使用门槛较高。

功能边界明确：仅封装基础交易与查询，无高级算法订单（TWAP/VWAP）、无 Level2 逐笔行情、无组合保证金计算，复杂策略需自行扩展。

个人维护风险：由 GitHub 个人账号 xdl2003 维护，无企业级 SLA 保障，长期更新与 Issue 响应存在不确定性。

适合人群

• 量化交易爱好者：希望用 Python 快速验证港股、美股策略
• 个人投资者：需要程序化监控持仓、设置条件单提醒
• 金融科技学习者：了解真实证券交易 API 对接流程
• 中小私募技术团队：作为内部交易系统的原型验证工具

使用风险

资金安全层面：实盘交易直接关联证券账户，策略 bug 或网络延迟可能导致非预期成交，务必先用 SIMULATE 模式充分测试。

依赖安全风险：futu-api 与 pandas 需及时更新，建议使用 pip audit 定期扫描 CVE 漏洞。

本地服务风险：FutuOpenD 默认端口 11111 若被恶意程序占用，存在中间人攻击可能，建议在可信网络环境使用并监控端口占用状态。

合规风险提示：程序化交易需遵守交易所异常交易监管规则，高频委托可能触发券商风控限制。