富途API数据技能

🎯 概述

基于富途牛牛官方API的纯数据技能，提供股票行情数据获取和技术分析功能。无交易功能，专注于数据分析和市场监控。

🚀 快速开始

安装依赖

cd /Users/chengling/.openclaw/workspace/skills/futu-api
pip install -r requirements.txt

前置要求

1. 安装并运行 FutuOpenD 应用程序
2. 登录富途账户
3. 确保连接地址：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()