xtick-skill 0.1.4__py3-none-any.whl
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.md +334 -0
- xtick/references/apidoc.md +4299 -0
- xtick/scripts/Config.py +3 -0
- xtick/scripts/XTickStockApiClient.py +485 -0
- xtick/scripts/api/XTickCoreApi.py +176 -0
- xtick/scripts/api/XTickHotApi.py +237 -0
- xtick/scripts/api/XTickIndicatorApi.py +4333 -0
- xtick/scripts/api/XTickMarketApi.py +179 -0
- xtick/scripts/api/XTickQuantApi.py +51 -0
- xtick/scripts/api/XTickWatchApi.py +136 -0
- xtick/scripts/util/DataConvert.py +29 -0
- xtick/scripts/util/XTickUtil.py +67 -0
- xtick_skill-0.1.4.dist-info/METADATA +307 -0
- xtick_skill-0.1.4.dist-info/RECORD +16 -0
- xtick_skill-0.1.4.dist-info/WHEEL +5 -0
- xtick_skill-0.1.4.dist-info/top_level.txt +1 -0
xtick/SKILL.md
ADDED
|
@@ -0,0 +1,334 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: xtick
|
|
3
|
+
description: XTick股票实时数据API技能,提供沪深京A股、ETF、指数、港股等金融数据的获取能力,包括行情数据、财务数据、技术指标、热点数据等90个接口
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# XTick 股票数据技能
|
|
7
|
+
|
|
8
|
+
## 📋 概述
|
|
9
|
+
|
|
10
|
+
XTick是一个专业的股票实时数据API平台,提供全面、准确、稳定的金融数据服务。本技能帮助AI助手通过自然语言交互获取股票数据。
|
|
11
|
+
|
|
12
|
+
**核心能力**:
|
|
13
|
+
- 📊 实时行情数据(K线、分钟线、深度行情)
|
|
14
|
+
- 💰 财务报表数据(资产负债表、利润表、现金流量表)
|
|
15
|
+
- 📈 技术指标计算(MACD、KDJ、RSI等100+指标)
|
|
16
|
+
- 🔥 市场热点追踪(资金流向、连板天梯、新闻资讯)
|
|
17
|
+
- 🎯 量化因子数据(涨速、换手率、市盈率等)
|
|
18
|
+
- 📰 新闻资讯聚合(主流财经媒体)
|
|
19
|
+
|
|
20
|
+
## 🚀 快速开始
|
|
21
|
+
|
|
22
|
+
### 1. 环境准备
|
|
23
|
+
|
|
24
|
+
```bash
|
|
25
|
+
# 安装Python环境(推荐3.7+)
|
|
26
|
+
# 安装依赖包
|
|
27
|
+
pip install requests pandas
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### 2. 获取Token
|
|
31
|
+
|
|
32
|
+
1. 访问 [XTick官网](http://www.xtick.top/user/account) 注册账号
|
|
33
|
+
2. 登录后在个人中心获取API Token
|
|
34
|
+
3. 将Token配置到代码中使用
|
|
35
|
+
|
|
36
|
+
### 3. Python HTTP API调用示例
|
|
37
|
+
|
|
38
|
+
```python
|
|
39
|
+
from xtick.scripts.api import XTickMarketApi
|
|
40
|
+
|
|
41
|
+
# 配置Token
|
|
42
|
+
token = "your_token_here"
|
|
43
|
+
# 获取平安银行日K线数据
|
|
44
|
+
result = XTickMarketApi.getKlineMarket(
|
|
45
|
+
type=1, # 沪深京A股
|
|
46
|
+
code="000001", # 股票代码
|
|
47
|
+
fq="1", # 不复权
|
|
48
|
+
period="1d", # 日线
|
|
49
|
+
startDate="2025-01-01",
|
|
50
|
+
endDate="2026-01-01",
|
|
51
|
+
token=token
|
|
52
|
+
)
|
|
53
|
+
print(result)
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## 🔑 权限等级说明
|
|
57
|
+
|
|
58
|
+
XTick采用分级权限制度,不同等级可访问的接口不同:
|
|
59
|
+
|
|
60
|
+
| 等级 | 名称 | 可访问接口 |
|
|
61
|
+
|------|------|-----------|
|
|
62
|
+
| 1 | 青铜版 | 基础行情数据、财务数据、技术指标 |
|
|
63
|
+
| 2 | 白银版 | + 盯盘数据(深度行情、成交统计) |
|
|
64
|
+
| 3 | 黄金版 | + 核心数据(竞价数据、除权停牌) |
|
|
65
|
+
| 4 | 至尊版 | + 热点数据(资金流向、新闻、概念板块) |
|
|
66
|
+
| 5 | 量化版 | + 量化因子(全市场实时推送) |
|
|
67
|
+
|
|
68
|
+
## 📝 参数格式规范
|
|
69
|
+
|
|
70
|
+
### 通用参数
|
|
71
|
+
|
|
72
|
+
- **token**: 必填,从官网获取的认证令牌
|
|
73
|
+
- **type**: 标的类型
|
|
74
|
+
- `1`: 沪深京A股
|
|
75
|
+
- `2`: 沪深指数
|
|
76
|
+
- `3`: 港股
|
|
77
|
+
- `4`: ETF基金
|
|
78
|
+
- `5`: 沪深可转债
|
|
79
|
+
- **code**: 股票代码,6位数字(如 `000001`),部分接口支持 `all` 获取全市场数据
|
|
80
|
+
- **日期格式**: `yyyy-MM-dd`(如 `2026-01-01`)
|
|
81
|
+
- **复权类型 (fq)**:
|
|
82
|
+
- `1`: 不复权
|
|
83
|
+
- `2`: 前复权
|
|
84
|
+
- `3`: 后复权
|
|
85
|
+
- `4`: 等比前复权
|
|
86
|
+
- `5`: 等比后复权
|
|
87
|
+
- **K线周期 (period)**:
|
|
88
|
+
- 分钟线: `1m`, `5m`, `15m`, `30m`, `1h`
|
|
89
|
+
- 日线及以上: `1d`, `1w`, `1mon`, `1q`, `1y`
|
|
90
|
+
|
|
91
|
+
## 📚 接口分类概览
|
|
92
|
+
|
|
93
|
+
### 1. 行情数据接口 (9个接口)
|
|
94
|
+
|
|
95
|
+
- **股票列表**: 按照股票池获取股票代码,包括沪深京A股、港股、沪深指数、ETF、可转债几类数据。... [青铜版、白银版、黄金版、至尊版]
|
|
96
|
+
- **交易日历**: 获取A股交易日历,包含交易所交易日历和个股交易日历。交易所是指上交所、深交所、北交所的交易日历。数据从2020年开始。... [青铜版、白银版、黄金版、至尊版]
|
|
97
|
+
- **分钟数据-实时接口**: 提供日内一分钟实时数据,这个分钟接口调取数据会更快。... [青铜版、白银版、黄金版、至尊版]
|
|
98
|
+
- **行情数据-通用接口**: 行情数据包括1分钟K线、5分钟K线、15分钟K线、30分钟K线、1小时K线、日K线、周K线、季度K线、年K线。支持复权数... [青铜版、白银版、黄金版、至尊版]
|
|
99
|
+
- **股东数**: 股东数,数据范围:2001年-至今... [青铜版、白银版、黄金版、至尊版]
|
|
100
|
+
- **财务指标**: 财务指标,数据范围:2007年-至今。... [青铜版、白银版、黄金版、至尊版]
|
|
101
|
+
- **十大股东**: 十大股东,数据范围:公司上市-至今... [青铜版、白银版、黄金版、至尊版]
|
|
102
|
+
- **十大流通股东**: 十大流通股东,数据范围:2004年-至今... [青铜版、白银版、黄金版、至尊版]
|
|
103
|
+
|
|
104
|
+
### 2. 盯盘数据接口 (7个接口)
|
|
105
|
+
|
|
106
|
+
- **日K线-实时数据**: 获取盘中实时日K线数据。支持批量参数,支持ALL参数。... [白银版、黄金版、至尊版]
|
|
107
|
+
- **分钟K线-实时数据**: 获取盘中分钟K线实时数据。支持批量参数,支持ALL参数。... [白银版、黄金版、至尊版]
|
|
108
|
+
- **深度行情-实时数据**: 获取盘中深度行情实时数据。... [白银版、黄金版、至尊版]
|
|
109
|
+
- **深度行情-历史数据**: 获取盘中深度行情历史数据,盘后更新数据。... [白银版、黄金版、至尊版]
|
|
110
|
+
- **成交统计-实时接口**: 按交易日,获取全市场成交额统计,包括科创板、创业板、北证、沪深两市等成交额统计。... [白银版、黄金版、至尊版]
|
|
111
|
+
- **日K线复权-更新接口**: 盘后获取当天全市场股票日线数据,包括前复权、不复权、后复权三种方式。... [白银版、黄金版、至尊版]
|
|
112
|
+
- **龙虎榜-历史数据**: 龙虎榜详情历史数据,盘后更新数据。... [白银版、黄金版、至尊版]
|
|
113
|
+
|
|
114
|
+
### 3. 核心数据接口 (9个接口)
|
|
115
|
+
|
|
116
|
+
- **竞价数据-实时接口**: 获取沪深京股票交易日盘中实时竞价数据,竞价时间段:9:15-9:25。每次调用接口返回最新竞价数据。... [黄金版、至尊版]
|
|
117
|
+
- **核心指标-实时接口**: 获取沪深京股票交易日盘中实时指标数据,包括涨速、换手率、市盈率、市净率、涨幅、均价、涨停板等数据。... [黄金版、至尊版]
|
|
118
|
+
- **除权变更数据**: 股票除权除息历史数据,可以获取有复权变化的股票数据。可以按单个股票获取个股除权除息历史记录,也可以使用all参数,获取全... [黄金版、至尊版]
|
|
119
|
+
- **停牌数据**: 停牌股票历史数据,盘后更新。... [黄金版、至尊版]
|
|
120
|
+
- **ST数据**: ST股票历史数据,数据从2022年3月开始,盘后更新。... [黄金版、至尊版]
|
|
121
|
+
- **涨跌停价格**: 获取股票涨跌停历史数据,盘后更新。如果需要盘中实时获取涨停板、跌停板、炸板数据,请参考[连板天梯-实时接口]... [黄金版、至尊版]
|
|
122
|
+
- **分笔数据**: 股票分时成交数据接口,盘后更新。... [黄金版、至尊版]
|
|
123
|
+
- **分价数据**: 股票分价成交数据接口,盘后更新。... [黄金版、至尊版]
|
|
124
|
+
- **K线行情**: 盘中实时获取日内K线数据,支持批量获取。... [黄金版、至尊版]
|
|
125
|
+
|
|
126
|
+
### 4. 短线热点接口 (12个接口)
|
|
127
|
+
|
|
128
|
+
- **连板天梯-实时接口**: 获取沪深京股票交易日盘中盘中涨停板、跌停板、炸板数据。梯队完整度是超短的重要指标。盘中实时更新。如果获取盘中实时数据,则... [至尊版]
|
|
129
|
+
- **市场情绪-实时接口**: 市场情绪,短线选手复盘必备工具。如果获取盘中实时数据,则tradeDate参数设置为当天交易日。... [至尊版]
|
|
130
|
+
- **资金流向-实时接口**: 获取沪深京股票交易日盘中资金流数据。盘中实时更新。... [至尊版]
|
|
131
|
+
- **资金流向-历史接口**: 获取沪深京股票交易日资金流历史数据,盘后更新。... [至尊版]
|
|
132
|
+
- **竞价数据-历史接口**: 竞价历史数据,该接口仅保留集合竞价期间的最后一条竞价数据和开盘数据。... [黄金版、至尊版]
|
|
133
|
+
- **竞价详情-实时接口**: 开盘集合竞价阶段,个股的所有竞价信息。当天竞价完成后,9:25更新完数据。请求一次,获取交易日当天全市场竞价详情数据,请... [黄金版、至尊版]
|
|
134
|
+
- **新闻资讯-实时接口**: 获取财联社、新浪财经、格隆汇、华尔街见闻、凤凰网、同花顺、东方财富、雪球等主流金融平台资讯信息,跟随市场热点、核心。盘中... [至尊版]
|
|
135
|
+
- **日内分时-实时接口**: 获取股票盘中日内分时数据,保留了价格在每个时间点的变化细节,股价全天的波动轨迹。盘中实时更新。... [至尊版]
|
|
136
|
+
- **概念板块成分股数据**: 获取概念板块、地域板块、行业板块数据,以及概念板块下对应的成分股数据。... [至尊版]
|
|
137
|
+
- **股票关联概念板块数据**: 获取个股关联的概念板块、地域板块、行业板块数据。... [至尊版]
|
|
138
|
+
- **增量更新**: 提供交易日当天全市场增量数据的更新,是收盘后的历史数据,是为了方便大家能快速的获取全市场数据,节省大家获取数据的时间,不... [黄金版、至尊版]
|
|
139
|
+
- **分笔快照-实时数据**: 股票分时成交数据接口,盘中实时更新。... [黄金版、至尊版]
|
|
140
|
+
|
|
141
|
+
### 8. 量化因子接口 (2个接口)
|
|
142
|
+
|
|
143
|
+
- **量化因子-实时接口**: 获取沪深京股票交易日盘中因子指标数据,实时推送,包括涨速、换手率、市盈率、市净率等。支持数据全推。... [量化版]
|
|
144
|
+
- **量化因子-历史接口**: 获取沪深京股票交易日盘中因子指标历史数据,盘后更新。... [量化版]
|
|
145
|
+
|
|
146
|
+
### 9. 金融指标接口 (51个接口)
|
|
147
|
+
|
|
148
|
+
- **ad指标**: AD指标(Accumulation/Distribution)是一种用于量化分析股票、期货或其他金融资产的技术指标。它主... [青铜版、白银版、黄金版、至尊版]
|
|
149
|
+
- **adosc指标**: ADOSC指标是一种技术分析指标,全称为累积/派发指标(Accumulation/Distribution Oscill... [青铜版、白银版、黄金版、至尊版]
|
|
150
|
+
- **adx指标**: ADX指标(Average Directional Movement Index)是一种技术分析指标,用于衡量市场趋势的... [青铜版、白银版、黄金版、至尊版]
|
|
151
|
+
- **adxr指标**: ADXR指标(Average Directional Movement Index Rating)是根据ADX指标(Av... [青铜版、白银版、黄金版、至尊版]
|
|
152
|
+
- **apo指标**: APO(Absolute Price Oscillator)指标是一种技术分析指标,用于衡量股票价格的变动幅度。它计算了... [青铜版、白银版、黄金版、至尊版]
|
|
153
|
+
- **aroon指标**: AROON指标的中文名称是“阿隆指标”,该指标是一种技术分析指标,用于衡量价格趋势的强度和趋势的方向。阿隆指标由两条线组... [青铜版、白银版、黄金版、至尊版]
|
|
154
|
+
- **aroonosc指标**: AroonOsc指标的名称是Aroon Oscillator(阿隆振荡器),它是Aroon指标的衍生指标。... [青铜版、白银版、黄金版、至尊版]
|
|
155
|
+
- **atr指标**: ATR称为真实波动幅度指标,英文名称为Average True Range。ATR指标是一种衡量市场波动性的技术指标,它... [青铜版、白银版、黄金版、至尊版]
|
|
156
|
+
- **bbands指标**: BBANDS称为布林带,英文名称为Bollinger Bands。布林带是一种基于统计学原理的技术分析指标,由约翰·布林... [青铜版、白银版、黄金版、至尊版]
|
|
157
|
+
- **bop指标**: BOP指标的名称是Balance of Power,也称为能量平衡指标。... [青铜版、白银版、黄金版、至尊版]
|
|
158
|
+
- **cci指标**: CCI指标的全称是“商品通道指数”(Commodity Channel Index),它是一种技术分析指标,用于评估商品... [青铜版、白银版、黄金版、至尊版]
|
|
159
|
+
- **cmo指标**: CMO指标的名称:Chande Momentum Oscillator(CMO,钱德动量振荡器)。... [青铜版、白银版、黄金版、至尊版]
|
|
160
|
+
- **dema指标**: DEMA指标是一种双指数移动平均线,全称为Double Exponential Moving Average。DEMA指... [青铜版、白银版、黄金版、至尊版]
|
|
161
|
+
- **dx指标**: 动向指标(DMI),英文名称是Directional Movement Index。动向指标(Dx)是一种技术分析指标,... [青铜版、白银版、黄金版、至尊版]
|
|
162
|
+
- **ema指标**: EMA指标是指数移动平均线,全称为Exponential Moving Average。它是一种常用的技术分析工具,用于... [青铜版、白银版、黄金版、至尊版]
|
|
163
|
+
- **httrendline指标**: HTTRENDLINE称为趋势线,英文名称为HTTRENDLINE。该指标是一种基于趋势线的技术分析工具。... [青铜版、白银版、黄金版、至尊版]
|
|
164
|
+
- **kama指标**: KAMA是考夫曼自适应移动平均线,全称为Kaufman Adaptive Moving Average。是由Perry ... [青铜版、白银版、黄金版、至尊版]
|
|
165
|
+
- **macd指标**: MACD指标的中文名称为移动平均线收敛/发散指标,英文名称为Moving Average Convergence Div... [青铜版、白银版、黄金版、至尊版]
|
|
166
|
+
- **macdext指标**: MACDEXT指标的中文名称是MACD扩展,英文名称是MACD Extended。MACD扩展是基于移动平均线收敛背离(... [青铜版、白银版、黄金版、至尊版]
|
|
167
|
+
- **macdfix指标**: MACDFIX指标的中文名称为移动平均收敛/背离指标,英文名称为Moving Average Convergence D... [青铜版、白银版、黄金版、至尊版]
|
|
168
|
+
- **mama指标**: MAMA是MESA自适应移动平均线,全称为MESA Adaptive Moving Average。它是根据价格的移动平... [青铜版、白银版、黄金版、至尊版]
|
|
169
|
+
- **mfi指标**: MFI指标的中文名称是资金流量指标,英文名称是Money Flow Index。MFI指标是一种衡量资金流入和流出的指标... [青铜版、白银版、黄金版、至尊版]
|
|
170
|
+
- **midpoint指标**: MIDPOINT是一种基于价格的技术指标,用于衡量价格趋势的中点。... [青铜版、白银版、黄金版、至尊版]
|
|
171
|
+
- **minusdi指标**: MINUSDI指标中文名称为负向动向指标,英文名称为Negative Directional Indicator。它是技... [青铜版、白银版、黄金版、至尊版]
|
|
172
|
+
- **minusdm指标**: MINUSDM指标的中文名称为负方向运动指标,英文名称为Minus Directional Movement Indic... [青铜版、白银版、黄金版、至尊版]
|
|
173
|
+
- **mom指标**: MOM金融指标的中文名称为动量指标,英文名称为Momentum Indicator。该指标是通过比较当前价格与一定期间前... [青铜版、白银版、黄金版、至尊版]
|
|
174
|
+
- **movingaverage指标**: MOVINGAVERAGE金融指标的中文名称为移动平均线,英文名称为Moving Average。该指标通过计算一段时间... [青铜版、白银版、黄金版、至尊版]
|
|
175
|
+
- **natr指标**: NATR称为归一化真实波动幅度,英文名称为Normalized Average True Range。该指标用于衡量市场... [青铜版、白银版、黄金版、至尊版]
|
|
176
|
+
- **obv指标**: OBV指标(On-Balance Volume)是一种量能指标,用于衡量成交量的变化趋势和预测价格趋势的强弱。OBV指标... [青铜版、白银版、黄金版、至尊版]
|
|
177
|
+
- **plusdi指标**: 正向移动方向指标,英文名称是Positive Directional Indicator。... [青铜版、白银版、黄金版、至尊版]
|
|
178
|
+
- **plusdm指标**: 正向动向变动指标,英文名称是Positive Directional Movement。... [青铜版、白银版、黄金版、至尊版]
|
|
179
|
+
- **ppo指标**: 价格振荡百分比指标,英文名称为Percentage Price Oscillator。... [青铜版、白银版、黄金版、至尊版]
|
|
180
|
+
- **roc指标**: ROC金融指标的中文名称是变动率,英文名称是Rate of Change,ROC指标是一种衡量价格变动速度的技。... [青铜版、白银版、黄金版、至尊版]
|
|
181
|
+
- **rocp指标**: ROCP指标的中文名称为变化率指标,英文名称为Rate of Change Percentage。... [青铜版、白银版、黄金版、至尊版]
|
|
182
|
+
- **rocr指标**: ROCR金融指标是指Rate of Change Ratio,其中文名称是变动率比率,英文名称是Rate of Chan... [青铜版、白银版、黄金版、至尊版]
|
|
183
|
+
- **rocr100指标**: ROCR100金融指标的中文名称为价格变动率,英文名称为Rate of Change Ratio 100,指标介绍为衡量... [青铜版、白银版、黄金版、至尊版]
|
|
184
|
+
- **rsi指标**: RSI指标是相对强弱指标,全称为Relative Strength Index。它是一种用于衡量市场超买超卖状态的技术指... [青铜版、白银版、黄金版、至尊版]
|
|
185
|
+
- **sar指标**: SAR称为抛物线指标,英文名称为Parabolic SAR (Stop and Reverse)。... [青铜版、白银版、黄金版、至尊版]
|
|
186
|
+
- **sarext指标**: SAREXT称为拓展停损点指标,英文名称为SAREXT (Extended Stop and Reverse Indic... [青铜版、白银版、黄金版、至尊版]
|
|
187
|
+
- **sma指标**: SMA指标是简单移动平均线,全称为Simple Moving Average。它是一种常用的技术分析指标,用于平滑价格数... [青铜版、白银版、黄金版、至尊版]
|
|
188
|
+
- **stoch指标**: STOCH是随机指标(KDJ指标),英文名称是Stochastic Oscillator。该指标是一种用来测量价格相对于... [青铜版、白银版、黄金版、至尊版]
|
|
189
|
+
- **stochf指标**: STOCHF是随机振荡指标(Stochastic Fast)。... [青铜版、白银版、黄金版、至尊版]
|
|
190
|
+
- **stochrsi指标**: 随机相对强弱指标,Stochastic Relative Strength Index (STOCHRSI)。... [青铜版、白银版、黄金版、至尊版]
|
|
191
|
+
- **t3指标**: T3是三重移动平均线,全称是Triple Exponential Moving Average。它是指数移动平均线(EM... [青铜版、白银版、黄金版、至尊版]
|
|
192
|
+
- **tema指标**: TEMA是三重指数移动平均线,全程为Triple Exponential Moving Average。它是一种技术分析... [青铜版、白银版、黄金版、至尊版]
|
|
193
|
+
- **trima指标**: TRIMA是三重指数平均线,全称为Triangular Moving Average。它是一种平滑的移动平均线,通过将价... [青铜版、白银版、黄金版、至尊版]
|
|
194
|
+
- **trix指标**: TRIX金融指标的中文名称是三重指数平滑平均线,英文名称是Triple Exponential Moving Avera... [青铜版、白银版、黄金版、至尊版]
|
|
195
|
+
- **truerange指标**: 称为真实波幅,英文名称为True Range。它是一种衡量价格波动性的指标。... [青铜版、白银版、黄金版、至尊版]
|
|
196
|
+
- **ultosc指标**: ULTOSC称为综合摆动指标,英文名称:Ultimate Oscillator (ULTOSC)。综合摆动指标是一种多周... [青铜版、白银版、黄金版、至尊版]
|
|
197
|
+
- **willr指标**: WILLR指标的中文名称为威廉指标(WR),英文名称为Williams' %R(W%R)。该指标通过测量价格在给定时间周... [青铜版、白银版、黄金版、至尊版]
|
|
198
|
+
- **wma指标**: WMA指标是一种移动平均线指标,全称为Weighted Moving Average。它是一种加权平均线指标,与简单移动... [青铜版、白银版、黄金版、至尊版]
|
|
199
|
+
|
|
200
|
+
**总计**: 90个API接口
|
|
201
|
+
|
|
202
|
+
## 💡 常用场景示例
|
|
203
|
+
|
|
204
|
+
### 场景1: 获取股票行情数据
|
|
205
|
+
|
|
206
|
+
```python
|
|
207
|
+
# 获取单个股票的日K线数据
|
|
208
|
+
result = XTickMarketApi.getKlineMarket(
|
|
209
|
+
type=1, code="000001", fq="1", period="1d",
|
|
210
|
+
startDate="2025-01-01", endDate="2026-01-01",
|
|
211
|
+
token=token
|
|
212
|
+
)
|
|
213
|
+
|
|
214
|
+
# 获取实时分钟数据
|
|
215
|
+
result = XTickMarketApi.getKlineMinute(
|
|
216
|
+
type=1, code="000001", fq="1", token=token
|
|
217
|
+
)
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
### 场景2: 获取财务数据
|
|
221
|
+
|
|
222
|
+
```python
|
|
223
|
+
# 获取财务指标
|
|
224
|
+
result = XTickMarketApi.getCoreIndicator(
|
|
225
|
+
code="000001",
|
|
226
|
+
startDate="2023-01-01", endDate="2024-12-31",
|
|
227
|
+
token=token
|
|
228
|
+
)
|
|
229
|
+
|
|
230
|
+
# 获取十大股东
|
|
231
|
+
result = XTickMarketApi.getTopHolder(
|
|
232
|
+
code="000001",
|
|
233
|
+
startDate="2023-01-01", endDate="2024-12-31",
|
|
234
|
+
token=token
|
|
235
|
+
)
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
### 场景3: 获取技术指标
|
|
239
|
+
|
|
240
|
+
```python
|
|
241
|
+
from xtick.scripts.api import XTickIndicatorApi
|
|
242
|
+
|
|
243
|
+
# 计算MACD指标
|
|
244
|
+
result = XTickIndicatorApi.macd(
|
|
245
|
+
type=1, code="000001", period="1d", fq="front",
|
|
246
|
+
startDate="2025-01-01", endDate="2026-01-01",
|
|
247
|
+
inReal=2, optInFastPeriod="12",
|
|
248
|
+
optInSlowPeriod="26", optInSignalPeriod="9",
|
|
249
|
+
token=token
|
|
250
|
+
)
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
### 场景4: 获取市场热点
|
|
254
|
+
|
|
255
|
+
```python
|
|
256
|
+
from xtick.scripts.api import XTickHotApi
|
|
257
|
+
|
|
258
|
+
# 获取资金流向
|
|
259
|
+
result = XTickHotApi.getMoneyFlow(
|
|
260
|
+
type=1, code="000001",
|
|
261
|
+
startDate="2026-01-01", endDate="2026-01-15",
|
|
262
|
+
token=token
|
|
263
|
+
)
|
|
264
|
+
```
|
|
265
|
+
|
|
266
|
+
### 场景5: 获取量化因子
|
|
267
|
+
|
|
268
|
+
```python
|
|
269
|
+
from xtick.scripts.api import XTickQuantApi
|
|
270
|
+
|
|
271
|
+
# 获取全市场量化因子(需要量化版权限)
|
|
272
|
+
result = XTickQuantApi.getQuantDataRealtime(
|
|
273
|
+
type=1, field="all", token=token
|
|
274
|
+
)
|
|
275
|
+
```
|
|
276
|
+
|
|
277
|
+
## 🛠️ Python API模块说明
|
|
278
|
+
|
|
279
|
+
XTick提供了以下Python API模块:
|
|
280
|
+
|
|
281
|
+
| 模块 | 说明 | 主要功能 |
|
|
282
|
+
|------|------|---------|
|
|
283
|
+
| `XTickMarketApi` | 行情数据接口 | 股票列表、交易日历、K线数据、财务数据 |
|
|
284
|
+
| `XTickWatchApi` | 盯盘数据接口 | 深度行情、成交统计、日K线复权 |
|
|
285
|
+
| `XTickCoreApi` | 核心数据接口 | 竞价数据、除权停牌、分笔分价 |
|
|
286
|
+
| `XTickHotApi` | 热点数据接口 | 资金流向、新闻资讯、概念板块 |
|
|
287
|
+
| `XTickQuantApi` | 量化因子接口 | 实时/历史量化因子数据 |
|
|
288
|
+
| `XTickIndicatorApi` | 金融指标接口 | MACD、KDJ、RSI等100+指标 |
|
|
289
|
+
|
|
290
|
+
## ⚠️ 注意事项
|
|
291
|
+
|
|
292
|
+
1. **Token安全**: 不要将Token硬编码在代码中,建议使用环境变量或配置文件
|
|
293
|
+
2. **频率限制**: 遵守API调用频率限制,避免频繁请求导致被封禁
|
|
294
|
+
3. **批量查询**: 部分接口支持批量查询(最多50个股票代码,用逗号分隔)
|
|
295
|
+
4. **时间跨度限制**: 分钟数据单次请求时间跨度不超过31天
|
|
296
|
+
5. **数据时效性**: 实时数据仅在交易时段更新,盘后数据为历史数据
|
|
297
|
+
6. **错误处理**: 建议添加异常处理,检查返回数据的有效性
|
|
298
|
+
|
|
299
|
+
## 📖 完整示例
|
|
300
|
+
|
|
301
|
+
完整的API调用示例请参考:
|
|
302
|
+
- [XTickStockApiClient.py](scripts/XTickStockApiClient.py) - 包含所有HTTP接口的调用示例
|
|
303
|
+
- [详细API文档](references/apidoc.md) - 完整的HTTP接口参数说明
|
|
304
|
+
|
|
305
|
+
## 🔗 相关链接
|
|
306
|
+
|
|
307
|
+
- **官方网站**: http://www.xtick.top/
|
|
308
|
+
- **在线文档**: http://www.xtick.top/apidoc
|
|
309
|
+
- **注册账号**: http://www.xtick.top/user/account
|
|
310
|
+
- **GitHub**: https://github.com/xticktop/skills
|
|
311
|
+
|
|
312
|
+
## 🤖 AI助手使用提示
|
|
313
|
+
|
|
314
|
+
当用户询问股票相关数据时:
|
|
315
|
+
|
|
316
|
+
1. **识别意图**: 确定用户需要什么类型的数据(行情、财务、技术指标等)
|
|
317
|
+
2. **选择接口**: 使用HTTP API获取数据
|
|
318
|
+
3. **确认参数**: 向用户确认必要的参数(股票代码、日期范围等)
|
|
319
|
+
4. **调用API**: 使用对应的Python API模块获取数据
|
|
320
|
+
5. **解释结果**: 用通俗易懂的语言解释返回的数据
|
|
321
|
+
|
|
322
|
+
**示例对话**:
|
|
323
|
+
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
用户: 帮我看看平安银行最近的股价走势
|
|
327
|
+
|
|
328
|
+
AI: 我将获取平安银行(000001)最近30天的日K线数据...
|
|
329
|
+
|
|
330
|
+
[调用 getKlineMarket 接口]
|
|
331
|
+
|
|
332
|
+
数据显示平安银行近期股价在X元到Y元之间波动...
|
|
333
|
+
|
|
334
|
+
```
|