modbender 富途API数据技能
🎯 概述
基于富途牛牛官方API的纯数据技能，提供股票行情数据获取和技术分析功能。无交易功能，专注于数据分析和市场监控。
🚀 快速开始
安装依赖
cd /Users/chengling/.openclaw/workspace/skills/futu-api
pip install -r requirements.txt
前置要求
- 安装并运行 FutuOpenD 应用程序
- 登录富途账户
- 确保连接地址：
127.0.0.1:11111
基本使用
# 查询实时行情
python futu_api.py quote 00700 --market HK
# 获取K线数据
python futu_api.py kline 00700 --market HK --type 5m --count 100
# 计算技术指标
python futu_api.py indicators 00700 --market HK --type day --count 30
# 查看板块列表
python futu_api.py plates --market HK
# 获取逐笔成交
python futu_api.py ticker 00700 --market HK --count 10
# 查看资金流向
python futu_api.py capital 00700 --market HK
# 查看市场状态
python futu_api.py market --market HK
# 查看股票信息
python futu_api.py info 00700 --market HK
📊 核心功能
1. 实时行情查询
python futu_api.py quote 00700 --market HK
输出示例：
symbol : 00700
market : HK
price : 518.0000
change : +6.0000
change_percent: +1.17%
volume : 32,229,030
time : 16:08:06
2. K线数据分析
支持多种周期：
1m- 1分钟线5m- 5分钟线15m- 15分钟线30m- 30分钟线60m- 60分钟线day- 日线week- 周线month- 月线
# 获取5分钟K线
python futu_api.py kline 00700 --market HK --type 5m --count 20
# JSON格式输出
python futu_api.py kline 00700 --market HK --type day --count 10 --format json
3. 技术指标计算
python futu_api.py indicators 00700 --market HK --type day --count 30
计算指标：
ma5,ma10,ma20- 移动平均线rsi- 相对强弱指数bb_upper,bb_middle,bb_lower- 布林带current,high,low- 价格统计
4. 板块数据
# 查看板块列表
python futu_api.py plates --market HK
# 查看前20个板块
5. 逐笔成交
# 获取最近成交
python futu_api.py ticker 00700 --market HK --count 10
6. 资金流向分析
# 查看资金流向
python futu_api.py capital 00700 --market HK
# 输出示例：
# 主力净流入: +1.2亿
# 散户净流出: -0.8亿
# 资金情绪: 积极
7. 市场状态监控
# 查看市场状态
python futu_api.py market --market HK
# 输出示例：
# 市场状态: 收市
# 是否开市: 否
8. 股票基础信息
# 查看股票信息
python futu_api.py info 00700 --market HK
# 输出示例：
# 股票名称: TENCENT
# 每手股数: 100
# 上市日期: 2004-06-16
📁 文件结构
futu-api/
├── futu_api.py # 主程序 (核心代码)
├── requirements.txt # 依赖文件
├── SKILL.md # 技能文档
└── README.md # 使用说明
🔧 核心类说明
FutuAPI 类
class FutuAPI:
def connect(self): # 连接API
def get_quote(symbol, market): # 获取行情
def get_kline(symbol, market, ktype, count): # 获取K线
def get_indicators(kline_data): # 计算技术指标
def get_plates(market): # 获取板块
def get_ticker(symbol, market, count): # 获取逐笔
🎯 使用示例
简单监控脚本
from futu_api import FutuAPI
api = FutuAPI()
api.connect()
# 获取腾讯行情
quote = api.get_quote('00700', 'HK')
if quote:
print(f"腾讯: {quote['price']} ({quote['change_percent']:+.2f}%)")
api.disconnect()
技术分析示例
from futu_api import FutuAPI
api = FutuAPI()
api.connect()
# 获取K线并计算指标
kline = api.get_kline('00700', 'HK', 'day', 30)
indicators = api.get_indicators(kline)
if indicators:
print(f"MA5: {indicators.get('ma5', 'N/A')}")
print(f"RSI: {indicators.get('rsi', 'N/A')}")
# RSI超卖/超买判断
rsi = indicators.get('rsi')
if rsi:
if rsi < 30:
print("🟢 RSI超卖，可能反弹")
elif rsi > 70:
print("🔴 RSI超买，可能回调")
api.disconnect()
⚙️ 配置说明
连接配置
默认连接地址：127.0.0.1:11111
如需修改，可在代码中调整：
api = FutuAPI(host="127.0.0.1", port=11111)
环境检查
# 检查FutuOpenD是否运行
ps aux | grep FutuOpenD
# 检查端口
netstat -an | grep 11111
# 测试连接
telnet 127.0.0.1 11111
🔒 注意事项
数据使用
- ✅ 只读数据：仅获取行情数据，无交易操作
- ✅ 合规使用：遵守富途API使用条款
- ✅ 频率限制：避免高频调用API
前置要求
- 必须安装FutuOpenD：从富途官网下载
- 必须登录账户：在FutuOpenD中登录
- 保持连接：FutuOpenD需要保持运行状态
🚨 故障排除
常见问题
1. 连接失败
# 检查FutuOpenD是否运行
ps aux | grep FutuOpenD
# 重启FutuOpenD并重新登录
2. 数据获取失败
# 检查股票代码格式
python futu_api.py quote 00700 --market HK
# 检查市场类型
python futu_api.py quote AAPL --market US
3. 性能优化
# 减少数据量
python futu_api.py kline 00700 --count 10
# 增加查询间隔
# 避免连续高频查询
📚 相关资源
版本: 1.0.0
最后更新: 2026-02-27
技能类型: 纯数据获取
适用市场: 港股、美股