专业金融行情数据API服务平台
XTick是一个专业的金融行情数据API服务平台，为量化交易、投资分析、金融研究提供强大的数据支撑。平台提供沪深京A股、港股、指数、ETF、可转债等全市场的实时和历史行情数据。
- 🚀 实时行情：盘中实时推送分钟级、Tick级行情数据
- 📊 历史数据：覆盖多年的K线、财务、股东等历史数据
- 🔢 量化因子：提供丰富的量化因子和技术指标计算
- 📈 短线热点：连板天梯、市场情绪、资金流向等短线交易数据
- 🌐 多语言支持：提供Java、Python等多语言SDK
- ⚡ 高性能：支持批量查询和全市场数据推送
- 🔒 安全可靠：Token认证机制，保障数据安全
| 数据类别 | 数据细分 | 更新方式 | 历史数据范围 |
|---|---|---|---|
| Tick数据 | Tick实时数据 | 实时更新 | A股、ETF：2025年2月至今 |
| Tick历史数据 | 盘后更新 | 指数和北证：2025年10月至今 | |
| 竞价数据 | 竞价实时数据 | 实时更新 | 竞价历史：2025年7月至今 |
| 竞价历史数据 | 9:25分更新 | 竞价详情：2025年2月至今 | |
| 分钟数据 | 1分钟实时数据 | 实时更新 | 2024年4月至今 |
| 其它周期K线 | 按分钟频率更新 | 支持复权 | |
| 日线数据 | 日线实时数据 | 实时更新 | 公司上市至今 |
| 日线历史数据 | 15:05更新 | 支持复权 | |
| 量化数据 | 量化因子实时 | 实时更新 | 2008年1月至今 |
| 量化因子历史 | 15:05更新 | - | |
| 财务数据 | 财务报表 | 盘后更新 | 2008年1月至今 |
| 技术指标 | 分钟级指标 | 实时更新 | 2024年4月至今 |
| 日线级指标 | 15:05更新 | 公司上市至今 |
XTick平台提供七大类API接口，共计88+个接口。
| 接口分类 | 接口数量 | 主要功能 |
|---|---|---|
| 行情数据接口 | 8个 | 股票列表、交易日历、K线数据、财务数据等 |
| 盯盘数据接口 | 7个 | 龙虎榜、日K线、分钟K线、买卖五档、成交统计等 |
| 核心数据接口 | 8个 | 竞价数据、核心指标、除权、停牌、ST、分笔分价等 |
| 短线热点接口 | 10个 | 连板天梯、市场情绪、资金流向、新闻、概念板块等 |
| 量化因子接口 | 2个 | 实时和历史量化因子数据 |
| 金融指标接口 | 51+个 | MACD、RSI、KDJ等技术指标计算 |
| WebSocket接口 | 2个 | 订阅查询、取消订阅 |
- 请求方式：所有HTTP API均支持GET和POST方法
- 认证方式：所有接口都需要Token认证
- 返回格式：JSON格式
- 日期格式：
YYYY-MM-DD，如2024-01-01 - 标的类型(type)：
1- 沪深京A股2- 沪深指数3- 港股4- ETF基金5- 沪深可转债
- 复权类型(fq)：
1- 不复权2- 前复权3- 后复权4- 等比前复权5- 等比后复权
接口地址：/doc/stockinfo
功能描述：获取股票列表，包括沪深京A股、港股、指数、ETF、可转债等。
请求示例：
GET http://api.xtick.top/doc/stockinfo?symbol=all&token=YOUR_TOKEN请求参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| symbol | String | 是 | all-全部, sz-深交所, sh-上交所, bj-北交所, hk-港交所, index-指数, bond-可转债, cyb-创业板, kcb-科创板, etf-ETF, st-ST股票, ts-退市股票 |
| token | String | 是 | API Token |
返回字段：type(标的类别), code(股票代码), name(股票名称)
接口地址：/doc/calendar
功能描述：获取A股交易日历，包含交易所和个股交易日历（2020年至今）。
请求参数：code(股票代码/all/ssb), startDate, endDate, token
返回字段：code, time(交易日期), status(1-正常交易, 2-休市), preTime(上一交易日)
接口地址：/doc/kline/minute
功能描述：获取日内一分钟实时数据。
请求参数：type, code(单个股票), fq, token
返回字段：type, code, time, open, close, high, low, volume, amount, preClose
接口地址：/doc/kline/market
功能描述：获取多周期K线数据（1m/5m/15m/30m/1h/1d/1w/1mon/1q/1y），支持复权。
请求参数：type, code(单个股票), fq, period, startDate, endDate, token
注意事项：
- 分钟数据单次请求时间跨度不超过31天
- 支持code=all获取全市场数据（仅最近一个月）
接口地址：/doc/holdernum
功能描述：获取股东户数数据（2001年至今）。
请求参数：code(单个股票), startDate, endDate, token
接口地址：/doc/core
功能描述：获取财务指标数据（2007年至今）。
返回字段：ocfps(每股经营现金流), bps(每股净资产), eps(每股收益), roe(净资产收益率)等22个字段
接口地址：/doc/topholder
功能描述：获取十大股东数据（公司上市至今）。
接口地址：/doc/topflowholder
功能描述：获取十大流通股东数据（2004年至今）。
接口地址：/doc/order/longhubang
功能描述：获取龙虎榜详情历史数据，盘后更新。
请求参数：tradeDate, token
返回字段：code, time, explanation(上榜原因), name, close, zdf(涨跌幅), netamt(净买额), buyamt, sellamt等
接口地址：/doc/order/day
功能描述：获取盘中实时日K线数据，支持批量和全推。
请求参数：type, code(支持单个/批量最多50个/all), token
接口地址：/doc/order/minute
功能描述：获取盘中分钟K线实时数据，支持批量和全推。
接口地址：/doc/order/five
功能描述：获取盘中买卖五档盘口实时数据（Tick数据）。
返回字段：lastPrice, open, high, low, bp1-bp5(买一至买五价), bv1-bv5(买量), sp1-sp5(卖价), sv1-sv5(卖量)等
接口地址：/doc/order/history
功能描述：获取盘中买卖五档历史数据，盘后更新。
请求参数：type, code(单个股票), tradeDate, token
接口地址：/doc/order/amount
功能描述：按交易日获取全市场成交额统计。
接口地址：/doc/core/bidtime
功能描述：获取交易日盘中实时竞价数据（9:15-9:25）。
请求参数：type, code(支持单个/批量/all), token
接口地址：/doc/core/time
功能描述：获取盘中实时指标数据（涨速、换手率、市盈率、市净率等）。
请求参数：type, code(单个股票), field(多个字段用逗号分隔，最多10个), token
接口地址：/doc/core/chuquan
功能描述：获取股票除权除息历史数据，盘后更新。
请求参数：type, code(单个/all), startDate, endDate, token
接口地址：/doc/core/tingpai
功能描述：获取停牌股票历史数据，盘后更新。
接口地址：/doc/core/st
功能描述：获取ST股票历史数据（2022年3月至今），盘后更新。
接口地址：/doc/core/price
功能描述：获取股票涨跌停历史数据，盘后更新。
请求参数：type, code, fq(复权类型), startDate, endDate, token
接口地址：/doc/core/fenbi
功能描述：获取股票分时成交数据。
请求参数：type, code(单个股票), tradeDate, token
接口地址：/doc/core/fenjia
功能描述：获取股票分价成交数据，盘后更新。
接口地址：/doc/hot/board
功能描述：获取涨停板、跌停板、炸板数据。
请求参数：type, flag(1-涨停, 2-跌停, 3-炸板), tradeDate, token
接口地址：/doc/hot/emotion
功能描述：获取市场情绪数据，短线选手复盘必备工具。
接口地址：/doc/hot/money
功能描述：获取资金流数据，盘中实时更新。
请求参数：type, code(单个/all), startDate, endDate, token
接口地址：/doc/hot/bidhistory
功能描述：获取竞价历史数据，仅保留集合竞价最后一条数据和开盘数据。
请求参数：type, code, seq(0-9:25数据, 1-倒数第二条), startDate, endDate, token
接口地址：/doc/hot/biddetail
功能描述：获取开盘集合竞价阶段个股的所有竞价信息，9:25更新。
接口地址：/doc/hot/news
功能描述：获取财联社、新浪财经、格隆汇、华尔街见闻等主流金融平台资讯。
请求参数：minutes(>0获取最近分钟数, =0按tradeDate获取历史), tradeDate, token
接口地址：/doc/hot/timekline
功能描述：获取股票盘中日内分时数据。
接口地址：/doc/hot/bk
功能描述：获取概念板块、地域板块、行业板块及成分股数据。
请求参数：symbol(sw1/sw2/sw3申万行业, zjh1/zjh2证监会行业, bdy1/bdy2地域, ahy行业, afg风格, agn/bgn/cgn概念), token
接口地址：/doc/hot/gainian
功能描述：获取个股关联的概念板块、地域板块、行业板块数据。
接口地址：/doc/hot/dayupdate
功能描述：提供交易日当天全市场增量数据（收盘后历史数据）。
请求参数：dataType(bid-竞价详情, 1m-1分钟数据), symbol(index/etf/cyb/kcb/bj/szm/shm), tradeDate, token
注意：该接口数据量大，严格限流，请勿频繁调用。
接口地址：/doc/quant/data
功能描述：获取盘中实时因子指标数据，支持全推。
请求参数：type, field(all或指定字段，最多10个), token
常用字段：
- x001-x005: 昨收价、最新价、开盘价、最高价、最低价
- x006-x007: 成交量、成交额
- x015: 涨速, x016-x020: 1-5分钟涨速
- x021-x023: 静态/动态/TTM市盈率
- x024-x025: 总市值、流通市值
- x026-x028: 市净率、换手率、实际换手率
- x033-x038: 5/10/20/30/60/120日均线
- x039-x041: MACD-DIF/DEA/MACD
- x042-x044: KDJ-K/D/J
- x045-x047: RSI、WR、CCI
接口地址：/doc/quant/history
功能描述：获取盘中因子指标历史数据，盘后更新。
请求参数：tradeDate, token
提供51+技术指标计算，每个指标对应独立API端点。
主要指标：
- 趋势指标：AD(累积/分布线), MACD(平滑异同移动平均线), SMA(简单移动平均), EMA(指数移动平均)
- 震荡指标：RSI(相对强弱指数), KDJ(随机指标), WR(威廉指标), CCI(顺势指标)
- 成交量指标：OBV(能量潮), MFI(资金流量指标)
- 波动指标：ATR(真实波幅), BOLL(布林带)
- 其他指标：WMA(加权移动平均), SAR(抛物线转向)等
通用参数：type, code, period, fq, startDate, endDate, inReal, optInFastPeriod, optInSlowPeriod, optInSignalPeriod, token
详细文档：http://www.xtick.top/indicator
接口地址：/doc/querysubscribe
功能描述：查询当前订阅状态。
请求参数：token
接口地址：/doc/unsubscribe
功能描述：取消数据订阅。
请求参数：token
WebSocket订阅说明：
- 支持按交易所订阅（上交所、深交所、北交所、港交所）
- 支持按个股订阅（最多50个）
- 数据实时推送，建议异步处理
- 参考GitHub上的XTickWebSocketClient实现
本项目提供了完整的Python API调用示例，位于 xtick/code/api/ 目录。
xtick/code/
├── api/
│ ├── XTickBaseApi.py # 基础数据接口（8个接口）
│ ├── XTickMarketApi.py # 行情数据接口（8个接口）
│ ├── XTickWatchApi.py # 盯盘数据接口（7个接口）
│ ├── XTickCoreApi.py # 核心数据接口（8个接口）
│ ├── XTickHotApi.py # 短线热点接口（10个接口）
│ ├── XTickQuantApi.py # 量化因子接口（2个接口）
│ ├── XTickIndicatorApi.py # 金融指标接口（51+个指标）
│ └── XTickWebSocketApi.py # WebSocket接口（2个接口）
├── XTickStockApiClient.py # 完整测试客户端
├── Config.py # 配置文件
└── util/
├── XTickUtil.py # 工具类
└── DataConvert.py # 数据转换
pip install -r requirements.txt编辑 xtick/code/Config.py：
TOKEN = "your_token_here" # 从 http://www.xtick.top/ 获取
SERVER_URL = "http://api.xtick.top"from xtick.code.api.XTickMarketApi import getKlineMarket
from xtick.code.Config import Config
import json
# 获取平安银行日K线数据
result = getKlineMarket(
type=1, # 沪深京A股
code="000001", # 股票代码
fq=1, # 不复权
period="1d", # 日线
startDate="2024-01-01",
endDate="2024-12-31",
token=Config.TOKEN
)
data = json.loads(result)
print(f"获取到 {len(data)} 条K线数据")# 运行所有接口测试
python xtick/code/XTickStockApiClient.py
# 或单独测试某个模块
python -c "from xtick.code.XTickStockApiClient import XTickStockApiClient; \
client = XTickStockApiClient(); \
client.demoForMarketApi()"XTickStockApiClient.py 提供了所有接口的完整测试用例：
from xtick.code.XTickStockApiClient import XTickStockApiClient
client = XTickStockApiClient()
# 按需选择要测试的接口
client.demoForMarketApi() # 行情数据接口（8个）
client.demoForWatchApi() # 盯盘数据接口（7个）
client.demoForCoreApi() # 核心数据接口（8个）
client.demoForHotApi() # 短线热点接口（10个）
client.demoForQuantApi() # 量化因子接口（2个）
client.demoForIndicatorApi() # 金融指标接口（示例）
client.demoForWebSocketApi() # WebSocket接口（2个）
# 或运行所有测试（注意：会调用大量API）
client.allDemo()# 获取股票列表
curl "http://api.xtick.top/doc/stockinfo?symbol=index&token=YOUR_TOKEN"
# 获取K线数据
curl "http://api.xtick.top/doc/kline/market?type=1&code=000001&fq=1&period=1d&startDate=2024-01-01&endDate=2024-12-31&token=YOUR_TOKEN"
# 获取实时买卖五档
curl "http://api.xtick.top/doc/order/five?type=1&code=000001&token=YOUR_TOKEN"import requests
import json
import pandas as pd
TOKEN = "YOUR_TOKEN"
BASE_URL = "http://api.xtick.top"
def get_kline_data(code, period="1d", start_date="2024-01-01", end_date="2024-12-31"):
"""获取K线数据"""
url = f"{BASE_URL}/doc/kline/market"
params = {
"type": 1,
"code": code,
"fq": 1,
"period": period,
"startDate": start_date,
"endDate": end_date,
"token": TOKEN
}
response = requests.get(url, params=params)
data = json.loads(response.text)
return pd.DataFrame(data)
# 使用示例
df = get_kline_data("000001")
print(df.head())
print(f"数据条数: {len(df)}")更多示例请参考 xtick/code/XTickStockApiClient.py
- 频率限制：请合理控制API调用频率，避免频繁请求
- 批量限制：批量查询时单次最多50个股票代码
- 时间跨度：分钟数据单次请求时间跨度不超过31天
- 全推数据：使用
code=all参数时请注意数据量较大 - 增量更新接口：严格限流，请勿频繁调用
- 实时数据可能存在秒级延迟
- 财务数据以公司公告为准
- 复权数据仅供参考，实际交易请以券商数据为准
- 请勿将Token泄露给他人
- 建议定期更换Token
- 不要在公开代码中硬编码Token
- 官方网站：http://www.xtick.top/
- API文档：飞书文档
- 金融指标API：http://www.xtick.top/indicator
- GitHub：https://github.com/xticktop/xtick
- Gitee：https://gitee.com/xtick/xtick
- Skills项目：https://github.com/xticktop/skills
欢迎加入QQ群进行交流（加群备注：XTick）
- 邮箱：xticktop@163.com
- 问题反馈：通过GitHub Issues提交
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
感谢所有为本项目做出贡献的开发者和用户！
您的支持是我们继续维护项目的动力，欢迎Star和Fork！
免责声明：本项目仅供学习和研究使用，请勿用于商业用途。平台提供的数据仅供参考，不构成投资建议。投资有风险，入市需谨慎。