核心功能
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 未启动或端口冲突时所有接口均不可用
- 密码安全:解锁交易的密码可能在代码中以明文或变量形式存在,需注意代码保管
- 无内置风控:技能本身不包含止损、仓位限制等风控逻辑,需用户自行实现