xtick-skill 0.1.4__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- xtick_skill-0.1.4/PKG-INFO +307 -0
- xtick_skill-0.1.4/README.md +282 -0
- xtick_skill-0.1.4/pyproject.toml +40 -0
- xtick_skill-0.1.4/setup.cfg +4 -0
- xtick_skill-0.1.4/xtick/SKILL.md +334 -0
- xtick_skill-0.1.4/xtick/references/apidoc.md +4299 -0
- xtick_skill-0.1.4/xtick/scripts/Config.py +3 -0
- xtick_skill-0.1.4/xtick/scripts/XTickStockApiClient.py +485 -0
- xtick_skill-0.1.4/xtick/scripts/api/XTickCoreApi.py +176 -0
- xtick_skill-0.1.4/xtick/scripts/api/XTickHotApi.py +237 -0
- xtick_skill-0.1.4/xtick/scripts/api/XTickIndicatorApi.py +4333 -0
- xtick_skill-0.1.4/xtick/scripts/api/XTickMarketApi.py +179 -0
- xtick_skill-0.1.4/xtick/scripts/api/XTickQuantApi.py +51 -0
- xtick_skill-0.1.4/xtick/scripts/api/XTickWatchApi.py +136 -0
- xtick_skill-0.1.4/xtick/scripts/util/DataConvert.py +29 -0
- xtick_skill-0.1.4/xtick/scripts/util/XTickUtil.py +67 -0
- xtick_skill-0.1.4/xtick_skill.egg-info/PKG-INFO +307 -0
- xtick_skill-0.1.4/xtick_skill.egg-info/SOURCES.txt +19 -0
- xtick_skill-0.1.4/xtick_skill.egg-info/dependency_links.txt +1 -0
- xtick_skill-0.1.4/xtick_skill.egg-info/requires.txt +2 -0
- xtick_skill-0.1.4/xtick_skill.egg-info/top_level.txt +1 -0
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: xtick-skill
|
|
3
|
+
Version: 0.1.4
|
|
4
|
+
Summary: XTick提供完整的金融市场数据解决方案,通过HTTP API接口获取实时行情数据,具有高效稳定的特点。
|
|
5
|
+
Project-URL: Documentation, https://github.com/xticktop/skills/blob/main/xtick/references/apidoc.md
|
|
6
|
+
Project-URL: Homepage, http://www.xtick.top
|
|
7
|
+
Project-URL: Repository, https://github.com/xticktop/skills
|
|
8
|
+
Project-URL: Issues, https://github.com/xticktop/skills/issues
|
|
9
|
+
Keywords: 股票实时数据API,实时Tick数据,买卖五档数据,股票高频数据,tick数据,一分钟数据,五分钟数据,实时数据,量比,换手率,市盈率,均价,涨速,资金流,逐笔数据
|
|
10
|
+
Classifier: Development Status :: 3 - Alpha
|
|
11
|
+
Classifier: Intended Audience :: Developers
|
|
12
|
+
Classifier: Operating System :: OS Independent
|
|
13
|
+
Classifier: Programming Language :: Python :: 3
|
|
14
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.8
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.9
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.10
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
20
|
+
Classifier: Topic :: Office/Business :: Financial :: Investment
|
|
21
|
+
Requires-Python: >=3.8
|
|
22
|
+
Description-Content-Type: text/markdown
|
|
23
|
+
Requires-Dist: requests>=2.28
|
|
24
|
+
Requires-Dist: websocket-client>=1.6
|
|
25
|
+
|
|
26
|
+
# XTick Skill - 股票实时数据API技能
|
|
27
|
+
|
|
28
|
+
[](LICENSE)
|
|
29
|
+
[](https://www.python.org/)
|
|
30
|
+
[](https://github.com/xticktop/skills/blob/main/xtick/references/apidoc.md)
|
|
31
|
+
|
|
32
|
+
## 📖 项目简介
|
|
33
|
+
|
|
34
|
+
XTick Skill是一个专业的股票实时数据API技能包,为AI助手(如Lingma、Claude Code、OpenCLAW等)提供自然语言交互获取金融数据的能力。
|
|
35
|
+
|
|
36
|
+
**核心特性**:
|
|
37
|
+
- ✅ **全面的数据覆盖**: 沪深京A股、ETF基金、主流指数、港股、可转债
|
|
38
|
+
- ✅ **丰富的数据类型**: 行情数据、财务数据、技术指标、热点数据、量化因子
|
|
39
|
+
- ✅ **90个API接口**: 涵盖股票分析的各个维度
|
|
40
|
+
- ✅ **易于集成**: 提供Python SDK,开箱即用
|
|
41
|
+
- ✅ **AI友好**: 专为智能体设计的Skill规范文档
|
|
42
|
+
|
|
43
|
+
## 🎯 适用场景
|
|
44
|
+
|
|
45
|
+
- 📊 **量化交易**: 获取实时行情和技术指标进行策略回测
|
|
46
|
+
- 💼 **投资分析**: 查看财务报表、股东变化等基本面数据
|
|
47
|
+
- 🔥 **短线交易**: 追踪资金流向、连板天梯、概念板块等热点
|
|
48
|
+
- 📰 **资讯监控**: 聚合主流财经媒体新闻
|
|
49
|
+
- 🤖 **AI应用**: 为智能投顾、聊天机器人提供数据支持
|
|
50
|
+
|
|
51
|
+
## 🚀 快速开始
|
|
52
|
+
|
|
53
|
+
### 前置要求
|
|
54
|
+
|
|
55
|
+
- Python 3.7+
|
|
56
|
+
- Node.js (可选,用于skills管理工具)
|
|
57
|
+
- XTick账号和Token ([免费注册](http://www.xtick.top/user/account))
|
|
58
|
+
|
|
59
|
+
### 安装方法
|
|
60
|
+
|
|
61
|
+
#### 方法1: 直接复制(推荐)
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
# 克隆或下载本项目
|
|
65
|
+
git clone https://github.com/xticktop/skills.git
|
|
66
|
+
# 将 xtick 目录复制到你的 skills 目录
|
|
67
|
+
cp -r skills/xtick /your/skills/directory/
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
#### 方法2: 使用 npx skills 命令
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# 从GitHub安装
|
|
74
|
+
npx skills add https://github.com/xticktop/skills.git --skill xtick
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
### 配置Token
|
|
80
|
+
|
|
81
|
+
编辑 `xtick/scripts/Config.py` 文件:
|
|
82
|
+
|
|
83
|
+
```python
|
|
84
|
+
class Config:
|
|
85
|
+
SERVER_URL = "http://api.xtick.top"
|
|
86
|
+
TOKEN = "your_token_here" # 替换为你的Token
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### 运行示例
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
# 进入项目目录
|
|
93
|
+
cd DemoXtickPythonSkill
|
|
94
|
+
|
|
95
|
+
# 安装依赖
|
|
96
|
+
pip install requests pandas
|
|
97
|
+
|
|
98
|
+
# 运行HTTP API完整示例
|
|
99
|
+
python xtick/scripts/XTickStockApiClient.py
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
## 📚 功能概览
|
|
103
|
+
|
|
104
|
+
XTick提供6大类共90个HTTP API接口:
|
|
105
|
+
|
|
106
|
+
### 1️⃣ 行情数据接口 (9个接口)
|
|
107
|
+
- 股票列表、交易日历
|
|
108
|
+
- K线数据(分钟/日线/周线/月线等)
|
|
109
|
+
- 财务数据(股东数、财务指标、十大股东等)
|
|
110
|
+
|
|
111
|
+
### 2️⃣ 盯盘数据接口 (7个接口)
|
|
112
|
+
- 实时日K线、分钟K线
|
|
113
|
+
- 深度行情(实时/历史)
|
|
114
|
+
- 成交统计、日K线复权
|
|
115
|
+
|
|
116
|
+
### 3️⃣ 核心数据接口 (9个接口)
|
|
117
|
+
- 竞价数据(实时/历史)
|
|
118
|
+
- 核心指标(涨速、换手率、市盈率等)
|
|
119
|
+
- 除权变更、停牌数据、ST数据
|
|
120
|
+
- 涨跌停价格、分笔数据、分价数据
|
|
121
|
+
|
|
122
|
+
### 4️⃣ 短线热点接口 (12个接口)
|
|
123
|
+
- 连板天梯(涨停/跌停/炸板)
|
|
124
|
+
- 市场情绪指标
|
|
125
|
+
- 资金流向分析(实时/历史)
|
|
126
|
+
- 新闻资讯聚合
|
|
127
|
+
- 日内分时数据
|
|
128
|
+
- 概念板块数据
|
|
129
|
+
- 增量更新接口
|
|
130
|
+
|
|
131
|
+
### 5️⃣ 量化因子接口 (2个接口)
|
|
132
|
+
- 实时量化因子(全市场推送)
|
|
133
|
+
- 历史量化因子数据
|
|
134
|
+
|
|
135
|
+
### 6️⃣ 金融指标接口 (51个接口)
|
|
136
|
+
- 趋势指标: MACD、ADX、AROON等
|
|
137
|
+
- 震荡指标: KDJ、RSI、CCI、WR等
|
|
138
|
+
- 成交量指标: OBV、AD、ADOSC等
|
|
139
|
+
- 波动率指标: ATR、BOLL等
|
|
140
|
+
- 移动平均线: SMA、EMA、WMA等
|
|
141
|
+
|
|
142
|
+
## 💡 使用示例
|
|
143
|
+
|
|
144
|
+
### 示例1: 获取股票K线数据
|
|
145
|
+
|
|
146
|
+
```python
|
|
147
|
+
from xtick.scripts.api import XTickMarketApi
|
|
148
|
+
|
|
149
|
+
token = "your_token"
|
|
150
|
+
# 获取平安银行最近30天的日K线
|
|
151
|
+
result = XTickMarketApi.getKlineMarket(
|
|
152
|
+
type=1, # 沪深京A股
|
|
153
|
+
code="000001", # 股票代码
|
|
154
|
+
fq="1", # 不复权
|
|
155
|
+
period="1d", # 日线
|
|
156
|
+
startDate="2025-12-01",
|
|
157
|
+
endDate="2025-12-31",
|
|
158
|
+
token=token
|
|
159
|
+
)
|
|
160
|
+
print(result)
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### 示例2: 计算技术指标
|
|
164
|
+
|
|
165
|
+
```python
|
|
166
|
+
from xtick.scripts.api import XTickIndicatorApi
|
|
167
|
+
|
|
168
|
+
# 计算MACD指标
|
|
169
|
+
result = XTickIndicatorApi.macd(
|
|
170
|
+
type=1, code="000001", period="1d", fq="front",
|
|
171
|
+
startDate="2025-01-01", endDate="2025-12-31",
|
|
172
|
+
inReal=2, # 使用收盘价
|
|
173
|
+
optInFastPeriod="12",
|
|
174
|
+
optInSlowPeriod="26",
|
|
175
|
+
optInSignalPeriod="9",
|
|
176
|
+
token=token
|
|
177
|
+
)
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
### 示例3: 获取市场热点
|
|
181
|
+
|
|
182
|
+
### 示例5: AI助手自然语言交互
|
|
183
|
+
|
|
184
|
+
当在支持Skills的AI助手中加载本技能后,可以直接用自然语言询问:
|
|
185
|
+
|
|
186
|
+
```
|
|
187
|
+
|
|
188
|
+
👤 用户: 帮我看看贵州茅台最近的股价走势
|
|
189
|
+
|
|
190
|
+
🤖 AI: [自动调用API获取数据并分析]
|
|
191
|
+
|
|
192
|
+
贵州茅台(600519)近30日股价表现:
|
|
193
|
+
|
|
194
|
+
- 最高价: XXX元
|
|
195
|
+
|
|
196
|
+
- 最低价: XXX元
|
|
197
|
+
|
|
198
|
+
- 涨跌幅: X.XX%
|
|
199
|
+
|
|
200
|
+
- 技术分析: MACD金叉...
|
|
201
|
+
|
|
202
|
+
```
|
|
203
|
+
|
|
204
|
+
## 🔑 权限等级
|
|
205
|
+
|
|
206
|
+
XTick采用分级权限制度:
|
|
207
|
+
|
|
208
|
+
| 等级 | 名称 | 可访问接口 | 适用人群 |
|
|
209
|
+
|------|------|-----------|---------|
|
|
210
|
+
| 1 | 青铜版 | 基础行情、财务数据、技术指标 | 个人投资者 |
|
|
211
|
+
| 2 | 白银版 | + 盯盘数据(深度行情) | 活跃交易者 |
|
|
212
|
+
| 3 | 黄金版 | + 核心数据(竞价、除权) | 专业投资者 |
|
|
213
|
+
| 4 | 至尊版 | + 热点数据(新闻、概念板块) | 短线高手 |
|
|
214
|
+
| 5 | 量化版 | + 量化因子(全市场推送) | 量化团队 |
|
|
215
|
+
|
|
216
|
+
> 💡 提示: 在官网注册后可免费试用,升级请[联系官方](http://www.xtick.top/)
|
|
217
|
+
|
|
218
|
+
## 📁 项目结构
|
|
219
|
+
|
|
220
|
+
```
|
|
221
|
+
DemoXtickPythonSkill/
|
|
222
|
+
├── xtick/
|
|
223
|
+
│ ├── SKILL.md # Skill技能文档(AI助手使用)
|
|
224
|
+
│ ├── references/
|
|
225
|
+
│ │ └── apidoc.md # 详细API接口文档
|
|
226
|
+
│ └── scripts/
|
|
227
|
+
│ ├── Config.py # 配置文件(Token设置)
|
|
228
|
+
│ ├── XTickStockApiClient.py # HTTP API完整调用示例
|
|
229
|
+
│ ├── api/
|
|
230
|
+
│ │ ├── XTickMarketApi.py # 行情数据API
|
|
231
|
+
│ │ ├── XTickWatchApi.py # 盯盘数据API
|
|
232
|
+
│ │ ├── XTickCoreApi.py # 核心数据API
|
|
233
|
+
│ │ ├── XTickHotApi.py # 热点数据API
|
|
234
|
+
│ │ ├── XTickQuantApi.py # 量化因子API
|
|
235
|
+
│ │ └── XTickIndicatorApi.py # 金融指标API
|
|
236
|
+
│ └── util/
|
|
237
|
+
│ ├── XTickUtil.py # 工具函数
|
|
238
|
+
│ └── DataConvert.py # 数据转换
|
|
239
|
+
├── README.md # 项目说明文档
|
|
240
|
+
└── requirements.txt # Python依赖
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
## 📖 文档说明
|
|
244
|
+
|
|
245
|
+
- **[SKILL.md](https://github.com/xticktop/skills/blob/main/xtick/SKILL.md)**: Skill技能文档,教AI助手如何使用XTick API
|
|
246
|
+
- **[apidoc.md](https://github.com/xticktop/skills/blob/main/xtick/references/apidoc.md)**: 详细的HTTP API接口文档,包含所有参数说明
|
|
247
|
+
- **[XTickStockApiClient.py](https://github.com/xticktop/skills/blob/main/xtick/scripts/XTickStockApiClient.py)**: HTTP API完整代码示例
|
|
248
|
+
|
|
249
|
+
## ⚠️ 注意事项
|
|
250
|
+
|
|
251
|
+
1. **Token安全**: 不要将Token提交到版本控制系统,建议使用环境变量
|
|
252
|
+
2. **频率限制**: 遵守API调用频率限制,避免被封禁
|
|
253
|
+
3. **数据时效性**: 实时数据仅在交易时段(9:30-15:00)更新
|
|
254
|
+
4. **批量查询**: 部分接口支持批量查询,最多100个股票代码
|
|
255
|
+
5. **时间跨度**: 分钟数据单次请求不超过31天
|
|
256
|
+
6. **错误处理**: 建议添加异常处理机制
|
|
257
|
+
|
|
258
|
+
## ❓ 常见问题
|
|
259
|
+
|
|
260
|
+
**Q: 如何获取Token?**
|
|
261
|
+
|
|
262
|
+
A: 访问 [XTick官网](http://www.xtick.top/user/account) 注册账号,登录后在个人中心获取。
|
|
263
|
+
|
|
264
|
+
**Q: 支持哪些编程语言?**
|
|
265
|
+
|
|
266
|
+
A: 目前提供Python SDK,其他语言可直接调用HTTP API。
|
|
267
|
+
|
|
268
|
+
**Q: 数据更新频率是多少?**
|
|
269
|
+
|
|
270
|
+
A:
|
|
271
|
+
- HTTP实时数据: 约2-3秒更新一次
|
|
272
|
+
- 财务数据: 盘后更新
|
|
273
|
+
|
|
274
|
+
**Q: 有调用次数限制吗?**
|
|
275
|
+
|
|
276
|
+
A: 不同权限等级有不同的调用限额,详见官网说明。
|
|
277
|
+
|
|
278
|
+
**Q: 可以用于商业用途吗?**
|
|
279
|
+
|
|
280
|
+
A: 请联系官方获取商业授权。
|
|
281
|
+
|
|
282
|
+
## 🛠️ 技术支持
|
|
283
|
+
|
|
284
|
+
- **官方网站**: http://www.xtick.top/
|
|
285
|
+
- **在线文档**: http://www.xtick.top/apidoc
|
|
286
|
+
- **问题反馈**: [GitHub Issues](https://github.com/xticktop/skills/issues)
|
|
287
|
+
- **邮箱联系**: support@xtick.top
|
|
288
|
+
|
|
289
|
+
## 🔗 相关资源
|
|
290
|
+
|
|
291
|
+
- [Python SDK源码](https://github.com/xticktop/xtick)
|
|
292
|
+
- [API在线文档](http://www.xtick.top/apidoc)
|
|
293
|
+
- [Skills管理工具](https://github.com/skills/skills)
|
|
294
|
+
|
|
295
|
+
## 📄 许可证
|
|
296
|
+
|
|
297
|
+
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
|
|
298
|
+
|
|
299
|
+
> ⚠️ **免责声明**: 本项目仅供学习和研究使用,不构成投资建议。股市有风险,投资需谨慎。
|
|
300
|
+
|
|
301
|
+
## 🙏 致谢
|
|
302
|
+
|
|
303
|
+
感谢所有为XTick项目做出贡献的开发者和用户!
|
|
304
|
+
|
|
305
|
+
---
|
|
306
|
+
|
|
307
|
+
**Made with ❤️ by XTick Team**
|
|
@@ -0,0 +1,282 @@
|
|
|
1
|
+
# XTick Skill - 股票实时数据API技能
|
|
2
|
+
|
|
3
|
+
[](LICENSE)
|
|
4
|
+
[](https://www.python.org/)
|
|
5
|
+
[](https://github.com/xticktop/skills/blob/main/xtick/references/apidoc.md)
|
|
6
|
+
|
|
7
|
+
## 📖 项目简介
|
|
8
|
+
|
|
9
|
+
XTick Skill是一个专业的股票实时数据API技能包,为AI助手(如Lingma、Claude Code、OpenCLAW等)提供自然语言交互获取金融数据的能力。
|
|
10
|
+
|
|
11
|
+
**核心特性**:
|
|
12
|
+
- ✅ **全面的数据覆盖**: 沪深京A股、ETF基金、主流指数、港股、可转债
|
|
13
|
+
- ✅ **丰富的数据类型**: 行情数据、财务数据、技术指标、热点数据、量化因子
|
|
14
|
+
- ✅ **90个API接口**: 涵盖股票分析的各个维度
|
|
15
|
+
- ✅ **易于集成**: 提供Python SDK,开箱即用
|
|
16
|
+
- ✅ **AI友好**: 专为智能体设计的Skill规范文档
|
|
17
|
+
|
|
18
|
+
## 🎯 适用场景
|
|
19
|
+
|
|
20
|
+
- 📊 **量化交易**: 获取实时行情和技术指标进行策略回测
|
|
21
|
+
- 💼 **投资分析**: 查看财务报表、股东变化等基本面数据
|
|
22
|
+
- 🔥 **短线交易**: 追踪资金流向、连板天梯、概念板块等热点
|
|
23
|
+
- 📰 **资讯监控**: 聚合主流财经媒体新闻
|
|
24
|
+
- 🤖 **AI应用**: 为智能投顾、聊天机器人提供数据支持
|
|
25
|
+
|
|
26
|
+
## 🚀 快速开始
|
|
27
|
+
|
|
28
|
+
### 前置要求
|
|
29
|
+
|
|
30
|
+
- Python 3.7+
|
|
31
|
+
- Node.js (可选,用于skills管理工具)
|
|
32
|
+
- XTick账号和Token ([免费注册](http://www.xtick.top/user/account))
|
|
33
|
+
|
|
34
|
+
### 安装方法
|
|
35
|
+
|
|
36
|
+
#### 方法1: 直接复制(推荐)
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
# 克隆或下载本项目
|
|
40
|
+
git clone https://github.com/xticktop/skills.git
|
|
41
|
+
# 将 xtick 目录复制到你的 skills 目录
|
|
42
|
+
cp -r skills/xtick /your/skills/directory/
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
#### 方法2: 使用 npx skills 命令
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
# 从GitHub安装
|
|
49
|
+
npx skills add https://github.com/xticktop/skills.git --skill xtick
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
### 配置Token
|
|
55
|
+
|
|
56
|
+
编辑 `xtick/scripts/Config.py` 文件:
|
|
57
|
+
|
|
58
|
+
```python
|
|
59
|
+
class Config:
|
|
60
|
+
SERVER_URL = "http://api.xtick.top"
|
|
61
|
+
TOKEN = "your_token_here" # 替换为你的Token
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### 运行示例
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
# 进入项目目录
|
|
68
|
+
cd DemoXtickPythonSkill
|
|
69
|
+
|
|
70
|
+
# 安装依赖
|
|
71
|
+
pip install requests pandas
|
|
72
|
+
|
|
73
|
+
# 运行HTTP API完整示例
|
|
74
|
+
python xtick/scripts/XTickStockApiClient.py
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## 📚 功能概览
|
|
78
|
+
|
|
79
|
+
XTick提供6大类共90个HTTP API接口:
|
|
80
|
+
|
|
81
|
+
### 1️⃣ 行情数据接口 (9个接口)
|
|
82
|
+
- 股票列表、交易日历
|
|
83
|
+
- K线数据(分钟/日线/周线/月线等)
|
|
84
|
+
- 财务数据(股东数、财务指标、十大股东等)
|
|
85
|
+
|
|
86
|
+
### 2️⃣ 盯盘数据接口 (7个接口)
|
|
87
|
+
- 实时日K线、分钟K线
|
|
88
|
+
- 深度行情(实时/历史)
|
|
89
|
+
- 成交统计、日K线复权
|
|
90
|
+
|
|
91
|
+
### 3️⃣ 核心数据接口 (9个接口)
|
|
92
|
+
- 竞价数据(实时/历史)
|
|
93
|
+
- 核心指标(涨速、换手率、市盈率等)
|
|
94
|
+
- 除权变更、停牌数据、ST数据
|
|
95
|
+
- 涨跌停价格、分笔数据、分价数据
|
|
96
|
+
|
|
97
|
+
### 4️⃣ 短线热点接口 (12个接口)
|
|
98
|
+
- 连板天梯(涨停/跌停/炸板)
|
|
99
|
+
- 市场情绪指标
|
|
100
|
+
- 资金流向分析(实时/历史)
|
|
101
|
+
- 新闻资讯聚合
|
|
102
|
+
- 日内分时数据
|
|
103
|
+
- 概念板块数据
|
|
104
|
+
- 增量更新接口
|
|
105
|
+
|
|
106
|
+
### 5️⃣ 量化因子接口 (2个接口)
|
|
107
|
+
- 实时量化因子(全市场推送)
|
|
108
|
+
- 历史量化因子数据
|
|
109
|
+
|
|
110
|
+
### 6️⃣ 金融指标接口 (51个接口)
|
|
111
|
+
- 趋势指标: MACD、ADX、AROON等
|
|
112
|
+
- 震荡指标: KDJ、RSI、CCI、WR等
|
|
113
|
+
- 成交量指标: OBV、AD、ADOSC等
|
|
114
|
+
- 波动率指标: ATR、BOLL等
|
|
115
|
+
- 移动平均线: SMA、EMA、WMA等
|
|
116
|
+
|
|
117
|
+
## 💡 使用示例
|
|
118
|
+
|
|
119
|
+
### 示例1: 获取股票K线数据
|
|
120
|
+
|
|
121
|
+
```python
|
|
122
|
+
from xtick.scripts.api import XTickMarketApi
|
|
123
|
+
|
|
124
|
+
token = "your_token"
|
|
125
|
+
# 获取平安银行最近30天的日K线
|
|
126
|
+
result = XTickMarketApi.getKlineMarket(
|
|
127
|
+
type=1, # 沪深京A股
|
|
128
|
+
code="000001", # 股票代码
|
|
129
|
+
fq="1", # 不复权
|
|
130
|
+
period="1d", # 日线
|
|
131
|
+
startDate="2025-12-01",
|
|
132
|
+
endDate="2025-12-31",
|
|
133
|
+
token=token
|
|
134
|
+
)
|
|
135
|
+
print(result)
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
### 示例2: 计算技术指标
|
|
139
|
+
|
|
140
|
+
```python
|
|
141
|
+
from xtick.scripts.api import XTickIndicatorApi
|
|
142
|
+
|
|
143
|
+
# 计算MACD指标
|
|
144
|
+
result = XTickIndicatorApi.macd(
|
|
145
|
+
type=1, code="000001", period="1d", fq="front",
|
|
146
|
+
startDate="2025-01-01", endDate="2025-12-31",
|
|
147
|
+
inReal=2, # 使用收盘价
|
|
148
|
+
optInFastPeriod="12",
|
|
149
|
+
optInSlowPeriod="26",
|
|
150
|
+
optInSignalPeriod="9",
|
|
151
|
+
token=token
|
|
152
|
+
)
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
### 示例3: 获取市场热点
|
|
156
|
+
|
|
157
|
+
### 示例5: AI助手自然语言交互
|
|
158
|
+
|
|
159
|
+
当在支持Skills的AI助手中加载本技能后,可以直接用自然语言询问:
|
|
160
|
+
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
👤 用户: 帮我看看贵州茅台最近的股价走势
|
|
164
|
+
|
|
165
|
+
🤖 AI: [自动调用API获取数据并分析]
|
|
166
|
+
|
|
167
|
+
贵州茅台(600519)近30日股价表现:
|
|
168
|
+
|
|
169
|
+
- 最高价: XXX元
|
|
170
|
+
|
|
171
|
+
- 最低价: XXX元
|
|
172
|
+
|
|
173
|
+
- 涨跌幅: X.XX%
|
|
174
|
+
|
|
175
|
+
- 技术分析: MACD金叉...
|
|
176
|
+
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
## 🔑 权限等级
|
|
180
|
+
|
|
181
|
+
XTick采用分级权限制度:
|
|
182
|
+
|
|
183
|
+
| 等级 | 名称 | 可访问接口 | 适用人群 |
|
|
184
|
+
|------|------|-----------|---------|
|
|
185
|
+
| 1 | 青铜版 | 基础行情、财务数据、技术指标 | 个人投资者 |
|
|
186
|
+
| 2 | 白银版 | + 盯盘数据(深度行情) | 活跃交易者 |
|
|
187
|
+
| 3 | 黄金版 | + 核心数据(竞价、除权) | 专业投资者 |
|
|
188
|
+
| 4 | 至尊版 | + 热点数据(新闻、概念板块) | 短线高手 |
|
|
189
|
+
| 5 | 量化版 | + 量化因子(全市场推送) | 量化团队 |
|
|
190
|
+
|
|
191
|
+
> 💡 提示: 在官网注册后可免费试用,升级请[联系官方](http://www.xtick.top/)
|
|
192
|
+
|
|
193
|
+
## 📁 项目结构
|
|
194
|
+
|
|
195
|
+
```
|
|
196
|
+
DemoXtickPythonSkill/
|
|
197
|
+
├── xtick/
|
|
198
|
+
│ ├── SKILL.md # Skill技能文档(AI助手使用)
|
|
199
|
+
│ ├── references/
|
|
200
|
+
│ │ └── apidoc.md # 详细API接口文档
|
|
201
|
+
│ └── scripts/
|
|
202
|
+
│ ├── Config.py # 配置文件(Token设置)
|
|
203
|
+
│ ├── XTickStockApiClient.py # HTTP API完整调用示例
|
|
204
|
+
│ ├── api/
|
|
205
|
+
│ │ ├── XTickMarketApi.py # 行情数据API
|
|
206
|
+
│ │ ├── XTickWatchApi.py # 盯盘数据API
|
|
207
|
+
│ │ ├── XTickCoreApi.py # 核心数据API
|
|
208
|
+
│ │ ├── XTickHotApi.py # 热点数据API
|
|
209
|
+
│ │ ├── XTickQuantApi.py # 量化因子API
|
|
210
|
+
│ │ └── XTickIndicatorApi.py # 金融指标API
|
|
211
|
+
│ └── util/
|
|
212
|
+
│ ├── XTickUtil.py # 工具函数
|
|
213
|
+
│ └── DataConvert.py # 数据转换
|
|
214
|
+
├── README.md # 项目说明文档
|
|
215
|
+
└── requirements.txt # Python依赖
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
## 📖 文档说明
|
|
219
|
+
|
|
220
|
+
- **[SKILL.md](https://github.com/xticktop/skills/blob/main/xtick/SKILL.md)**: Skill技能文档,教AI助手如何使用XTick API
|
|
221
|
+
- **[apidoc.md](https://github.com/xticktop/skills/blob/main/xtick/references/apidoc.md)**: 详细的HTTP API接口文档,包含所有参数说明
|
|
222
|
+
- **[XTickStockApiClient.py](https://github.com/xticktop/skills/blob/main/xtick/scripts/XTickStockApiClient.py)**: HTTP API完整代码示例
|
|
223
|
+
|
|
224
|
+
## ⚠️ 注意事项
|
|
225
|
+
|
|
226
|
+
1. **Token安全**: 不要将Token提交到版本控制系统,建议使用环境变量
|
|
227
|
+
2. **频率限制**: 遵守API调用频率限制,避免被封禁
|
|
228
|
+
3. **数据时效性**: 实时数据仅在交易时段(9:30-15:00)更新
|
|
229
|
+
4. **批量查询**: 部分接口支持批量查询,最多100个股票代码
|
|
230
|
+
5. **时间跨度**: 分钟数据单次请求不超过31天
|
|
231
|
+
6. **错误处理**: 建议添加异常处理机制
|
|
232
|
+
|
|
233
|
+
## ❓ 常见问题
|
|
234
|
+
|
|
235
|
+
**Q: 如何获取Token?**
|
|
236
|
+
|
|
237
|
+
A: 访问 [XTick官网](http://www.xtick.top/user/account) 注册账号,登录后在个人中心获取。
|
|
238
|
+
|
|
239
|
+
**Q: 支持哪些编程语言?**
|
|
240
|
+
|
|
241
|
+
A: 目前提供Python SDK,其他语言可直接调用HTTP API。
|
|
242
|
+
|
|
243
|
+
**Q: 数据更新频率是多少?**
|
|
244
|
+
|
|
245
|
+
A:
|
|
246
|
+
- HTTP实时数据: 约2-3秒更新一次
|
|
247
|
+
- 财务数据: 盘后更新
|
|
248
|
+
|
|
249
|
+
**Q: 有调用次数限制吗?**
|
|
250
|
+
|
|
251
|
+
A: 不同权限等级有不同的调用限额,详见官网说明。
|
|
252
|
+
|
|
253
|
+
**Q: 可以用于商业用途吗?**
|
|
254
|
+
|
|
255
|
+
A: 请联系官方获取商业授权。
|
|
256
|
+
|
|
257
|
+
## 🛠️ 技术支持
|
|
258
|
+
|
|
259
|
+
- **官方网站**: http://www.xtick.top/
|
|
260
|
+
- **在线文档**: http://www.xtick.top/apidoc
|
|
261
|
+
- **问题反馈**: [GitHub Issues](https://github.com/xticktop/skills/issues)
|
|
262
|
+
- **邮箱联系**: support@xtick.top
|
|
263
|
+
|
|
264
|
+
## 🔗 相关资源
|
|
265
|
+
|
|
266
|
+
- [Python SDK源码](https://github.com/xticktop/xtick)
|
|
267
|
+
- [API在线文档](http://www.xtick.top/apidoc)
|
|
268
|
+
- [Skills管理工具](https://github.com/skills/skills)
|
|
269
|
+
|
|
270
|
+
## 📄 许可证
|
|
271
|
+
|
|
272
|
+
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
|
|
273
|
+
|
|
274
|
+
> ⚠️ **免责声明**: 本项目仅供学习和研究使用,不构成投资建议。股市有风险,投资需谨慎。
|
|
275
|
+
|
|
276
|
+
## 🙏 致谢
|
|
277
|
+
|
|
278
|
+
感谢所有为XTick项目做出贡献的开发者和用户!
|
|
279
|
+
|
|
280
|
+
---
|
|
281
|
+
|
|
282
|
+
**Made with ❤️ by XTick Team**
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
[build-system]
|
|
2
|
+
requires = ["setuptools>=68", "wheel"]
|
|
3
|
+
build-backend = "setuptools.build_meta"
|
|
4
|
+
|
|
5
|
+
[project]
|
|
6
|
+
name = "xtick-skill"
|
|
7
|
+
version = "0.1.4"
|
|
8
|
+
description = "XTick提供完整的金融市场数据解决方案,通过HTTP API接口获取实时行情数据,具有高效稳定的特点。"
|
|
9
|
+
readme = "README.md"
|
|
10
|
+
requires-python = ">=3.8"
|
|
11
|
+
dependencies = [
|
|
12
|
+
"requests>=2.28",
|
|
13
|
+
"websocket-client>=1.6",
|
|
14
|
+
]
|
|
15
|
+
keywords = ["股票实时数据API", "实时Tick数据", "买卖五档数据", "股票高频数据", "tick数据", "一分钟数据", "五分钟数据", "实时数据", "量比", "换手率", "市盈率", "均价", "涨速", "资金流", "逐笔数据"]
|
|
16
|
+
classifiers = [
|
|
17
|
+
"Development Status :: 3 - Alpha",
|
|
18
|
+
"Intended Audience :: Developers",
|
|
19
|
+
"Operating System :: OS Independent",
|
|
20
|
+
"Programming Language :: Python :: 3",
|
|
21
|
+
"Programming Language :: Python :: 3 :: Only",
|
|
22
|
+
"Programming Language :: Python :: 3.8",
|
|
23
|
+
"Programming Language :: Python :: 3.9",
|
|
24
|
+
"Programming Language :: Python :: 3.10",
|
|
25
|
+
"Programming Language :: Python :: 3.11",
|
|
26
|
+
"Programming Language :: Python :: 3.12",
|
|
27
|
+
"Topic :: Office/Business :: Financial :: Investment",
|
|
28
|
+
]
|
|
29
|
+
|
|
30
|
+
[project.urls]
|
|
31
|
+
Documentation = "https://github.com/xticktop/skills/blob/main/xtick/references/apidoc.md"
|
|
32
|
+
Homepage = "http://www.xtick.top"
|
|
33
|
+
Repository = "https://github.com/xticktop/skills"
|
|
34
|
+
Issues = "https://github.com/xticktop/skills/issues"
|
|
35
|
+
|
|
36
|
+
[tool.setuptools.packages.find]
|
|
37
|
+
include = ["xtick*"]
|
|
38
|
+
|
|
39
|
+
[tool.setuptools.package-data]
|
|
40
|
+
xtick = ["SKILL.md", "references/*.md"]
|