XTick Skill - 股票实时数据API技能

📖 项目简介

XTick Skill是一个专业的股票实时数据API技能包，为AI助手（如Lingma、Claude Code、OpenCLAW等）提供自然语言交互获取金融数据的能力。

核心特性:

• ✅ 全面的数据覆盖: 沪深京A股、ETF基金、主流指数、港股、可转债
• ✅ 丰富的数据类型: 行情数据、财务数据、技术指标、热点数据、量化因子
• ✅ 193+ API接口: 涵盖股票分析的各个维度
• ✅ 易于集成: 提供Python SDK，开箱即用
• ✅ AI友好: 专为智能体设计的Skill规范文档

🎯 适用场景

• 📊 量化交易: 获取实时行情和技术指标进行策略回测
• 💼 投资分析: 查看财务报表、股东变化等基本面数据
• 🔥 短线交易: 追踪资金流向、连板天梯、概念板块等热点
• 📰 资讯监控: 聚合主流财经媒体新闻
• 🤖 AI应用: 为智能投顾、聊天机器人提供数据支持

🚀 快速开始

前置要求

• Python 3.7+
• Node.js (可选，用于skills管理工具)
• XTick账号和Token (免费注册)

安装方法

方法1: 直接复制（推荐）

# 克隆或下载本项目
git clone https://github.com/xticktop/skills.git
# 将 xtick 目录复制到你的 skills 目录
cp -r skills/xtick /your/skills/directory/

方法2: 使用 npx skills 命令

# 从GitHub安装
npx skills add https://github.com/xticktop/skills.git --skill xtick

# 从Gitee安装（国内加速）
npx skills add https://gitee.com/xtick/skills.git --skill xtick

配置Token

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

class Config:
    SERVER_URL = "http://api.xtick.top"
    TOKEN = "your_token_here"  # 替换为你的Token

运行示例

# 进入项目目录
cd DemoXtickPythonSkill

# 安装依赖
pip install requests pandas

# 运行HTTP API完整示例
python xtick/scripts/XTickStockApiClient.py

📚 功能概览

XTick提供6大类共193+个HTTP API接口：

1️⃣ 行情数据接口 (8个)

• 股票列表、交易日历
• K线数据（分钟/日线/周线/月线等）
• 财务数据（股东数、财务指标、十大股东等）

2️⃣ 盯盘数据接口 (6个)

• 实时日K线、分钟K线
• 深度行情（实时/历史）
• 成交统计、日K线复权

3️⃣ 核心数据接口 (8个)

• 竞价数据（实时/历史）
• 核心指标（涨速、换手率、市盈率等）
• 除权变更、停牌数据、ST数据
• 涨跌停价格、分笔数据、分价数据

4️⃣ 短线热点接口 (11个)

• 连板天梯（涨停/跌停/炸板）
• 市场情绪指标
• 资金流向分析（实时/历史）
• 新闻资讯聚合
• 日内分时数据
• 概念板块数据
• 增量更新接口

5️⃣ 量化因子接口 (2个)

• 实时量化因子（全市场推送）
• 历史量化因子数据

6️⃣ 金融指标接口 (157个)

• 趋势指标: MACD、ADX、AROON等
• 震荡指标: KDJ、RSI、CCI、WR等
• 成交量指标: OBV、AD、ADOSC等
• 波动率指标: ATR、BOLL等
• 移动平均线: SMA、EMA、WMA等
• K线形态识别: 61种蜡烛图形态
• 数学运算与统计函数

💡 使用示例

示例1: 获取股票K线数据

from xtick.scripts.api import XTickMarketApi

token = "your_token"
# 获取平安银行最近30天的日K线
result = XTickMarketApi.getKlineMarket(
    type=1,              # 沪深京A股
    code="000001",       # 股票代码
    fq="1",              # 不复权
    period="1d",         # 日线
    startDate="2025-12-01",
    endDate="2025-12-31",
    token=token
)
print(result)

示例2: 计算技术指标

from xtick.scripts.api import XTickIndicatorApi

# 计算MACD指标
result = XTickIndicatorApi.macd(
    type=1, code="000001", period="1d", fq="front",
    startDate="2025-01-01", endDate="2025-12-31",
    inReal=2,  # 使用收盘价
    optInFastPeriod="12",
    optInSlowPeriod="26",
    optInSignalPeriod="9",
    token=token
)

示例3: 获取市场热点

示例5: AI助手自然语言交互

当在支持Skills的AI助手中加载本技能后，可以直接用自然语言询问：

👤 用户: 帮我看看贵州茅台最近的股价走势

🤖 AI: [自动调用API获取数据并分析]

   贵州茅台(600519)近30日股价表现:

   - 最高价: XXX元

   - 最低价: XXX元

   - 涨跌幅: X.XX%

   - 技术分析: MACD金叉...

🔑 权限等级

XTick采用分级权限制度：

💡 提示: 在官网注册后可免费试用，升级请联系官方

📁 项目结构

DemoXtickPythonSkill/
├── xtick/
│   ├── SKILL.md                    # Skill技能文档（AI助手使用）
│   ├── references/
│   │   └── apidoc.md               # 详细API接口文档
│   └── scripts/
│       ├── Config.py               # 配置文件（Token设置）
│       ├── XTickStockApiClient.py  # HTTP API完整调用示例
│       ├── api/
│       │   ├── XTickMarketApi.py   # 行情数据API
│       │   ├── XTickWatchApi.py    # 盯盘数据API
│       │   ├── XTickCoreApi.py     # 核心数据API
│       │   ├── XTickHotApi.py      # 热点数据API
│       │   ├── XTickQuantApi.py    # 量化因子API
│       │   └── XTickIndicatorApi.py # 金融指标API
│       └── util/
│           ├── XTickUtil.py        # 工具函数
│           └── DataConvert.py      # 数据转换
├── README.md                       # 项目说明文档
└── requirements.txt                # Python依赖

📖 文档说明

• SKILL.md: Skill技能文档，教AI助手如何使用XTick API
• apidoc.md: 详细的HTTP API接口文档，包含所有参数说明
• XTickStockApiClient.py: HTTP API完整代码示例

⚠️ 注意事项

1. Token安全: 不要将Token提交到版本控制系统，建议使用环境变量
2. 频率限制: 遵守API调用频率限制，避免被封禁
3. 数据时效性: 实时数据仅在交易时段（9:30-15:00）更新
4. 批量查询: 部分接口支持批量查询，最多50个股票代码
5. 时间跨度: 分钟数据单次请求不超过31天
6. 错误处理: 建议添加异常处理机制

❓ 常见问题

Q: 如何获取Token？

A: 访问 XTick官网 注册账号，登录后在个人中心获取。

Q: 支持哪些编程语言？

A: 目前提供Python SDK，其他语言可直接调用HTTP API。

Q: 数据更新频率是多少？

A:

• HTTP实时数据: 约2-3秒更新一次
• 财务数据: 盘后更新

Q: 有调用次数限制吗？

A: 不同权限等级有不同的调用限额，详见官网说明。

Q: 可以用于商业用途吗？

A: 请联系官方获取商业授权。

🛠️ 技术支持

• 官方网站: http://www.xtick.top/
• 在线文档: http://www.xtick.top/apidoc
• 问题反馈: GitHub Issues
• 邮箱联系: [email protected]

🔗 相关资源

• Python SDK源码
• API在线文档
• Skills管理工具

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

⚠️ 免责声明: 本项目仅供学习和研究使用，不构成投资建议。股市有风险，投资需谨慎。

🙏 致谢

感谢所有为XTick项目做出贡献的开发者和用户！

---

Made with ❤️ by XTick Team