黑狼数据 Skill (FXYZ)

专业的股票实时数据API服务平台，提供沪深京A股、ETF基金、指数等全面的金融行情数据。

官方网站: http://www.fxyz.size
API文档: references/apidoc.md

📊 功能特点

核心优势

  • ✅ 全面的数据覆盖 - 沪深京A股、ETF基金、主流指数
  • ✅ 实时行情数据 - 30+行情指标，每分钟更新
  • ✅ 特色监控数据 - 涨停板、跌停板、炸板、强势股实时追踪
  • ✅ 多周期K线 - 8种时间周期（5分钟至年线），支持复权
  • ✅ 深度盘口数据 - 买卖五档、竞价数据、逐笔交易
  • ✅ 资金流向分析 - 特大单、大单、中单、小单分类统计
  • ✅ 规范化日志 - 自动打印请求参数、返回记录数、示例数据

数据分类

分类 接口数量 主要功能
Basic Api 1 股票列表、市场分类
Board Api 6 实时行情、涨跌停板、强势股
Market Api 7 K线数据、盘口数据、资金流向

🚀 快速开始

1. 环境要求

  • Python 3.7+
  • requests 库

2. 安装依赖

pip install requests

3. 获取Token

  1. 访问黑狼数据官网：http://www.fxyz.size
  2. 注册账号并登录
  3. 在个人中心获取API Token
  4. Token激活参考：http://www.fxyz.site/#apply

4. 配置Token

编辑 fxyz/scripts/Config.py 文件：

class Config:
    SERVER_URL = "http://api.fxyz.site"  # API服务地址
    TOKEN = "your_token_here"  # 替换为您的Token

5. 运行测试

python -m fxyz.scripts.StockApiClient

💡 使用示例

基础用法

1. 获取股票列表
from fxyz.scripts.api.BaseApi import BaseApi

# 获取所有A股列表
result = BaseApi.getStockList(flag=0, token="your_token")

# 获取创业板股票
result = BaseApi.getStockList(flag=5, token="your_token")

# 获取ETF基金
result = BaseApi.getStockList(flag=7, token="your_token")
2. 获取实时行情
from fxyz.scripts.api.BoardApi import BoardApi

# 获取单个股票实时行情
result = BoardApi.getRealTimeQuote(
    symbol="stock",
    code="000001",
    token="your_token"
)

# 获取全市场实时行情（包年版）
result = BoardApi.getRealTimeQuote(
    symbol="stock",
    code="all",
    token="your_token"
)
3. 获取K线数据
from fxyz.scripts.api.MarketApi import MarketApi

# 获取日K线（不复权）
result = MarketApi.getKLine(
    symbol="stock",
    code="000001",
    period="1d",
    cq="1",
    startDate="2026-04-01",
    endDate="2026-04-14",
    token="your_token"
)

# 获取周K线（前复权）
result = MarketApi.getKLine(
    symbol="stock",
    code="000001",
    period="1w",
    cq="2",
    startDate="2026-01-01",
    endDate="2026-04-14",
    token="your_token"
)
4. 监控涨停板
from fxyz.scripts.api.BoardApi import BoardApi

# 获取今日涨停板股票
result = BoardApi.getZhangTingBan(
    tradeDate="2026-04-14",
    token="your_token"
)
5. 查看资金流向
from fxyz.scripts.api.MarketApi import MarketApi

# 获取主力资金流向
result = MarketApi.getMoneyFlow(
    code="000001",
    tradeDate="2026-04-14",
    token="your_token"
)

高级用法

批量获取数据
from fxyz.scripts.api.BoardApi import BoardApi
from fxyz.scripts.Config import Config

# 批量获取多只股票行情
stocks = ["000001", "600000", "000002"]
for code in stocks:
    result = BoardApi.getRealTimeQuote(
        symbol="stock",
        code=code,
        token=Config.TOKEN
    )
    # 处理数据...
数据处理与分析
import json
from fxyz.scripts.api.MarketApi import MarketApi

# 获取K线数据并转换为DataFrame
result = MarketApi.getKLine(
    symbol="stock",
    code="000001",
    period="1d",
    cq="1",
    startDate="2026-04-01",
    endDate="2026-04-14",
    token="your_token"
)

# 解析JSON数据
data = json.loads(result)
print(f"获取到 {len(data)} 条K线数据")

# 计算涨跌幅
if len(data) >= 2:
    first_close = data[0]['c']
    last_close = data[-1]['c']
    change_pct = (last_close - first_close) / first_close * 100
    print(f"期间涨跌幅: {change_pct:.2f}%")

📚 API接口总览

Basic Api - 基础接口

接口名称 方法 权限 说明
股票列表 BaseApi.getStockList() 获取各类股票列表

Board Api - 涨跌板接口

接口名称 方法 权限 说明
实时行情 BoardApi.getRealTimeQuote() 30+行情指标
涨停板 BoardApi.getZhangTingBan() 涨停板监控
跌停板 BoardApi.getDieTingBan() 跌停板监控
炸板 BoardApi.getZhaBan() 炸板监控
强势股 BoardApi.getQiangShiGu() 强势股筛选
次新股 BoardApi.getCiXinGu() 次新股数据

Market Api - 行情接口

接口名称 方法 权限 说明
实时K线 MarketApi.getKLine() 8种周期K线
日线快照 MarketApi.getDaySnapshot() 日线快照
买卖五档 MarketApi.getFiveLevel() 盘口数据
竞价数据 MarketApi.getBidData() 集合竞价
逐笔交易 MarketApi.getDealData() 成交明细
分价数据 MarketApi.getPriceData() 分价统计
资金流向 MarketApi.getMoneyFlow() 资金分析

权限说明:

  • L1/L2/L3: Level 1/2/3 权限均可访问
  • L3: 仅Level 3（包年版）可访问

🏗️ 项目结构

DemoFxyzythonSkill/
├── fxyz/
│   ├── references/              # 参考文档
│   │   └── apidoc.md           # 📄 API接口文档（1112行）
│   ├── scripts/                 # 源代码
│   │   ├── api/                # API模块
│   │   │   ├── BaseApi.py      # Basic Api实现
│   │   │   ├── BoardApi.py     # Board Api实现
│   │   │   └── MarketApi.py    # Market Api实现
│   │   ├── util/               # 工具类
│   │   │   ├── DataUtil.py     # HTTP请求工具
│   │   │   └── DataConvert.py  # 数据转换工具
│   │   ├── Config.py           # 配置文件
│   │   └── StockApiClient.py   # 客户端示例（含测试）
│   └── SKILL.md                # Skill说明文档
├── README.md                    # 本文件
└── requirements.txt             # 依赖清单

📝 日志规范

所有API调用都会自动输出格式化日志：

============================================================
[BoardApi.getRealTimeQuote] API调用成功
  请求参数:
    - symbol: stock
    - code: 000001
  返回数据:
    - 记录数: 1
    - 第一条数据: {
        "code": "000001",
        "name": "平安银行",
        "zxj": 11.07,
        ...
      }
============================================================

日志内容包括:

  • ✅ 请求参数详情
  • ✅ 返回数据记录数
  • ✅ 第一条数据示例（JSON格式）

⚠️ 注意事项

1. Token管理

  • 🔐 安全性: 请勿将Token泄露或提交到公开代码仓库
  • 🔄 有效期: Token长期有效，如遇问题请联系客服重置
  • 🌐 多环境: 建议开发和生产环境使用不同Token

2. 请求限制

  • ⏱️ 频率控制: 避免短时间内大量请求
  • 🔢 并发限制: 单IP并发请求数建议不超过10个
  • 🚫 违规处理: 频繁违规可能导致IP被封禁

3. 数据时效性

数据类型 更新时机 说明
实时行情 交易时段每分钟 9:30-11:30, 13:00-15:00
涨跌停板 交易时段每分钟 收盘后15:30更新最终数据
K线数据 实时/盘后 交易中实时更新，收盘后15:30更新
历史数据 盘后 收盘后18:00完成全部更新
资金流向 盘后 收盘后18:00更新

4. 最佳实践

  1. 缓存策略: 对不频繁变化的数据进行本地缓存
  2. 错误处理: 实现完善的异常处理机制
  3. 重试机制: 对于临时性失败，实现指数退避重试
  4. 日志记录: 记录API调用日志，便于问题排查
  5. 数据验证: 对返回数据进行有效性验证

❓ 常见问题

Q: 如何获取Token？
A: 访问 http://www.fxyz.size 注册账号，登录后在个人中心获取。

Q: 返回数据为空怎么办？
A: 检查以下几点：

  1. Token是否正确且已激活
  2. 交易日期是否为交易日
  3. 股票代码是否存在
  4. 是否具有相应权限等级

Q: 全市场数据为什么无法获取？
A: code=all参数需要包年版权限，请确认您的账户等级。

Q: 数据更新延迟怎么办？
A: 实时数据在交易时段每分钟更新，如遇延迟请稍后重试。历史数据在收盘后统一更新。

Q: 如何判断API调用是否成功？
A: 查看日志输出中的"API调用成功"提示，以及返回数据的记录数。

📖 相关文档

🤝 技术支持

  • 官方网站: http://www.fxyz.size
  • API文档: references/apidoc.md
  • Token申请: http://www.fxyz.site/#apply
  • 问题反馈: 请通过官网联系客服

📄 许可证

本项目仅供学习和研究使用，请勿用于商业用途。使用时请遵守黑狼数据的使用条款。

版权所有: © 2026 黑狼数据

最后更新: 2026-04-14
文档版本: v2.0

# 前端
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

Agent沙箱实战：Shell工具调用的路径白名单与零信任逃逸审计

avatar 龙虾开发者社区
cover

HiClaw网关的审批流设计：如何避免工具调用中的误操作灾难？

avatar 龙虾开发者社区
cover

Agent 网关密钥管理：为什么你的硬件绑定总在 session 失效时翻车

avatar 龙虾开发者社区