Appearance
历史行情查询接口文档
概述
本接口模块提供历史行情数据查询服务,涵盖股票、ETF、指数、期货等品种的日线/分钟行情,以及复权因子、指数权重、逐笔 Tick、集合竞价、概念行情、龙虎榜、涨停统计、资金流向、行业分类等数据查询。
- 服务地址:
https://zhunData.cn - 基础路径:
/api/zhunzi_v1/hist-quotes - 请求方式:所有接口均为
POST - Content-Type:
application/json - 鉴权方式:请求头携带
x-api-key,如x-api-key: your_api_key - 限流策略:每 IP 每分钟 30 次请求
统一响应格式
json
{
"code": "00000",
"msg": "成功",
"data": {}
}| 字段 | 类型 | 说明 |
|---|---|---|
code | string | 业务状态码,00000 表示成功 |
msg | string | 提示信息 |
data | object/array | 响应数据 |
常见错误码
| 错误码 | HTTP 状态码 | 说明 |
|---|---|---|
00000 | 200 | 成功 |
A0301 | 401 | 缺少或无效的 API Key |
A0400 | 422 | 参数校验失败 |
A0502 | 429 | 请求过于频繁(限流) |
B0001 | 500 | 系统执行异常 |
股票类接口
股票日线行情查询
POST /api/zhunzi_v1/hist-quotes/stock/daily
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 股票代码列表,最多 50 个 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
adjust | string | 否 | none | 复权方式:none-不复权 / pre-前复权 / post-后复权 |
补充说明
start_date和count均未传时,默认count=10code为空时,start_date必须等于end_date
请求示例
json
{
"code": ["002041"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"date": "2026-08-24",
"code": "002041",
"display_name": "登海种业",
"is_st": "False",
"paused": "0.0",
"pre_close": 9.26,
"high_limit": 10.19,
"low_limit": 8.33,
"open": 9.3,
"high": 10.19,
"low": 9.17,
"close": 10.19,
"volume": 45380235,
"amount": 450444066.09,
"avg": 9.926,
"turnover_ratio": 5.1568,
"capitalization": 88000,
"circulating_cap": 88000,
"market_cap": 89.672,
"circulating_market_cap": 89.672,
"pe_ratio": 88.9663,
"pe_ratio_lyr": 97.8382,
"pb_ratio": 2.4272,
"ps_ratio": 7.4491,
"pcf_ratio": 972.1832
}
]
}股票日线数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
date | string | 交易日期 |
code | string | 股票代码 |
display_name | string | 股票名称 |
is_st | string | 是否 ST 股 |
paused | string | 是否停牌 |
pre_close | float | 昨日收盘价 |
high_limit | float | 涨停价 |
low_limit | float | 跌停价 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
volume | int | 成交量 |
amount | float | 成交额 |
avg | float | 成交均价 |
turnover_ratio | float | 换手率 |
capitalization | float | 总股本(万股) |
circulating_cap | float | 流通股本(万股) |
market_cap | float | 总市值(亿元) |
circulating_market_cap | float | 流通市值(亿元) |
pe_ratio | float | 市盈率(TTM) |
pe_ratio_lyr | float | 市盈率(LYR) |
pb_ratio | float | 市净率 |
ps_ratio | float | 市销率 |
pcf_ratio | float | 现金流市盈率 |
股票分钟行情查询
POST /api/zhunzi_v1/hist-quotes/stock/minute
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个股票代码 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
frequency | string | 否 | 1m | 频率:1m / 5m / 15m / 30m / 60m |
adjust | string | 否 | none | 复权方式:none-不复权 / pre-前复权 / post-后复权 |
请求示例
json
{
"code": "002041",
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"frequency": "1m"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"code": "002041",
"date": "2026-08-24",
"time": "1500",
"open": 10.19,
"high": 10.19,
"low": 10.19,
"close": 10.19,
"volume": 61900,
"money": 630761,
"pre_close": 9.26,
"pre_avg": 9.28
},
{
"code": "002041",
"date": "2026-08-24",
"time": "1459",
"open": 10.19,
"high": 10.19,
"low": 10.19,
"close": 10.19,
"volume": 0,
"money": 0,
"pre_close": 9.26,
"pre_avg": 9.28
}
]
}股票分钟数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
code | string | 股票代码 |
date | string | 交易日期 |
time | string | 分钟时间(如 1500 表示 15:00) |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
volume | int | 成交量 |
money | float | 成交额 |
pre_close | float | 昨日收盘价 |
pre_avg | float | 昨日成交均价 |
股票逐笔 Tick 查询
POST /api/zhunzi_v1/hist-quotes/stock-tick
查询指定日期的逐笔 Tick 数据,返回格式为列式存储(keys + data 二维数组)。
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个股票代码 |
date | string | 是 | - | 查询日期,格式 YYYY-MM-DD |
请求示例
json
{
"code": "002041",
"date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"keys": ["date", "code", "time", "open", "current", "high", "low", "total_volume", "total_money", "volume", "money", "a5_v", "a5_p", "a4_v", "a4_p", "a3_v", "a3_p", "a2_v", "a2_p", "a1_v", "a1_p", "b1_v", "b1_p", "b2_v", "b2_p", "b3_v", "b3_p", "b4_v", "b4_p", "b5_v", "b5_p", "b_s"],
"data": [
["2026-08-24", "002041", "20260824091500", 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10100, 0, 13100, 9.26, 13100, 9.26, 0, 0, 0, 0, 0, 0, 0, 0, "e"],
["2026-08-24", "002041", "20260824091509", 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 79900, 9.2, 79900, 9.2, 4900, 0, 0, 0, 0, 0, 0, 0, "e"]
]
}
}股票 Tick 数据字段说明
响应采用列式存储:keys 为字段名列表,data 为按行排列的值数组。每行数据按 keys 顺序对应。
| 字段 | 类型 | 说明 |
|---|---|---|
date | string | 交易日期 |
code | string | 股票代码 |
time | string | 成交时间 |
open | float | 开盘价 |
current | float | 当前价 |
high | float | 最高价 |
low | float | 最低价 |
total_volume | float | 累计成交量 |
total_money | float | 累计成交额 |
volume | float | 本笔成交量 |
money | float | 本笔成交额 |
a5_v ~ a1_v | float | 卖五量 ~ 卖一量 |
a5_p ~ a1_p | float | 卖五价 ~ 卖一价 |
b1_v ~ b5_v | float | 买一量 ~ 买五量 |
b1_p ~ b5_p | float | 买一价 ~ 买五价 |
b_s | string | 买卖方向(b-买 / s-卖 / e-均衡) |
股票集合竞价过程查询
POST /api/zhunzi_v1/hist-quotes/bidding
查询指定日期的集合竞价过程数据,返回竞价过程中各时间点的买卖盘快照。
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个股票代码 |
date | string | 是 | - | 查询日期,格式 YYYY-MM-DD |
请求示例
json
{
"code": "002041",
"date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"date": "2026-08-24",
"code": "002041",
"time": "20260824091500",
"current": 0,
"a1_p": 9.26,
"a1_v": 13100,
"b1_v": 13100,
"a2_v": 10100,
"b2_v": 0,
"volume": 0
},
{
"date": "2026-08-24",
"code": "002041",
"time": "20260824091509",
"current": 0,
"a1_p": 9.2,
"a1_v": 79900,
"b1_v": 79900,
"a2_v": 0,
"b2_v": 4900,
"volume": 0
}
]
}竞价过程数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
date | string | 交易日期 |
code | string | 股票代码 |
time | string | 竞价时间点 |
current | int | 当前价格 |
a1_p | float | 卖一价 |
a1_v | int | 卖一量 |
b1_v | int | 买一量 |
a2_v | int | 卖二量 |
b2_v | int | 买二量 |
volume | int | 成交量 |
股票集合竞价详情查询
POST /api/zhunzi_v1/hist-quotes/bid-detail
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 股票代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | - | 结束时间,格式 YYYY-MM-DD |
page | int | 否 | 1 | 页码,≥ 1 |
page_size | int | 否 | 1000 | 每页行数(1-1000) |
补充说明
code为空时,必须指定start_date和end_date,且两者必须相等code非空时,必须指定start_date和end_date,跨度不能超过 1 年
请求示例
json
{
"code": ["002041"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"total": 1,
"page": 1,
"page_size": 1000,
"data": [
{
"code": "002041",
"date": "2026-08-24",
"股票代码": "002041.SZ",
"股票简称": "登海种业",
"分时量比": 2.2285,
"竞价量": 573300,
"竞价匹配价": 9.3,
"竞价涨幅": 0.432,
"竞价异动类型": "竞价抢筹",
"竞价异动说明": "单笔放量10%以上抢筹",
"集合竞价评级": "看多",
"竞价金额": 5331690,
"竞价未匹配金额": 41850,
"分时成交额": 5331690,
"竞价未匹配量": 4500,
"分时成交量": 573300
}
]
}
}股票概念查询
POST /api/zhunzi_v1/hist-quotes/concept
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | - | 结束时间,格式 YYYY-MM-DD |
page | int | 否 | 1 | 页码,≥ 1 |
page_size | int | 否 | 1000 | 每页行数(1-1000) |
校验规则
同集合竞价详情查询。
请求示例
json
{
"code": [],
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"page": 1,
"page_size": 2
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"total": 1500,
"page": 1,
"page_size": 2,
"data": [
{
"date": "2026-08-24",
"exchange": "深交所",
"code": "000010",
"name": "*ST美丽",
"concept": "ST板块,新型城镇化,PPP概念,水利,煤炭概念,抽水蓄能,东数西算(算力)"
},
{
"date": "2026-08-24",
"exchange": "深交所",
"code": "000014",
"name": "沙河股份",
"concept": "物业管理,深圳国企改革,国企改革,粤港澳大湾区,智能家居,股权转让(并购重组)"
}
]
}
}龙虎榜查询
POST /api/zhunzi_v1/hist-quotes/dragon
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | - | 结束时间,格式 YYYY-MM-DD |
page | int | 否 | 1 | 页码,≥ 1 |
page_size | int | 否 | 1000 | 每页行数(1-1000) |
校验规则
同集合竞价详情查询。
请求示例
json
{
"code": [],
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"page": 1,
"page_size": 1
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"total": 693,
"page": 1,
"page_size": 1,
"data": [
{
"date": "2026-08-24",
"code": "000065",
"name": "北方国际",
"direction": "ALL",
"rank": "0",
"reason": "涨幅偏离值达7%的证券",
"sales_depart_name": "None",
"buy_value": 184880119,
"buy_rate": 22.3881,
"sell_value": 157987969,
"sell_rate": 19.1316,
"total_value": 342868088,
"net_value": 26892150,
"open": 9.98,
"high": 9.98,
"low": 9.75,
"close": 9.98,
"volume": 83080105,
"amount": 825797033,
"turnover_ratio": 7.8008,
"high_limit": 9.98,
"low_limit": 8.16,
"avg": 9.94,
"pre_close": 9.07,
"market_cap": 115.9119,
"circulating_market_cap": 106.2889
}
]
}
}涨停统计查询
POST /api/zhunzi_v1/hist-quotes/limit-up
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | - | 结束时间,格式 YYYY-MM-DD |
page | int | 否 | 1 | 页码,≥ 1 |
page_size | int | 否 | 1000 | 每页行数(1-1000) |
校验规则
同集合竞价详情查询。
请求示例
json
{
"code": [],
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"page": 1,
"page_size": 1
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"total": 48,
"page": 1,
"page_size": 1,
"data": [
{
"code": "000017",
"date": "2026-08-24",
"股票代码": "000017.SZ",
"股票简称": "深中华A",
"涨停价": 7.82,
"最高价_不复权": 7.82,
"开盘价_不复权": 7.82,
"最低价_不复权": 7.82,
"收盘价_不复权": 7.82,
"首次涨停时间": " 09:25:00",
"最终涨停时间": " 09:25:00",
"连续涨停天数": "3",
"涨停原因类别": "黄金珠宝+黄金涨价+年报增长",
"几天几板": "3天3板",
"涨停类型": "一字涨停||缩量涨停||逆势涨停",
"涨停开板次数": "0",
"实际换手率": 3.69,
"自由流通市值": 1872704024.76,
"涨停封单额": 180589590.36,
"涨停封单量占成交量比": 261.27,
"涨停封单量占流通a股比": 5.24,
"a股市值_不含限售股": 3447227700,
"涨停明细数据": "[{\"code\":\"000017.SZ\",\"time\":1787534700000,\"openTime\":null,\"duration\":14502000,\"updatedTime\":1787554800000,\"firstVol\":3.7755298E7,\"highestVol\":3.7936098E7,\"firstVolDivLTGB\":0.08564749989049433,\"firstVolDivVol\":19.268786,\"highestVolDivLTGB\":0.08605764280554169,\"highestVolDivVol\":9.937414}]",
"自由流通股": 239476218,
"涨停封单量": 23093298
}
]
}
}资金流向查询
POST /api/zhunzi_v1/hist-quotes/money-flow
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | - | 结束时间,格式 YYYY-MM-DD |
page | int | 否 | 1 | 页码,≥ 1 |
page_size | int | 否 | 1000 | 每页行数(1-1000) |
校验规则
同集合竞价详情查询。
请求示例
json
{
"code": ["002041"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"total": 1,
"page": 1,
"page_size": 1000,
"data": [
{
"date": "2026-08-24",
"code": "002041",
"display_name": "登海种业",
"change_pct": 10.04,
"net_amount_main": 15800.6153,
"net_pct_main": 35.08,
"net_amount_xl": 12255.8782,
"net_pct_xl": 27.21,
"net_amount_l": 3544.7371,
"net_pct_l": 7.87,
"net_amount_m": -6952.791,
"net_pct_m": -15.44,
"net_amount_s": -8847.8243,
"net_pct_s": -19.64
}
]
}
}行业分类查询
POST /api/zhunzi_v1/hist-quotes/industry
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | - | 结束时间,格式 YYYY-MM-DD |
first_industry_name | string | 否 | - | 一级行业名称 |
second_industry_name | string | 否 | - | 二级行业名称 |
third_industry_name | string | 否 | - | 三级行业名称 |
page | int | 否 | 1 | 页码,≥ 1 |
page_size | int | 否 | 1000 | 每页行数(1-1000) |
补充说明
code和行业名称均为空时,必须指定start_date和end_date,且两者必须相等code或行业名称非空时,必须指定start_date和end_date,跨度不能超过 1 年
请求示例
json
{
"code": [],
"first_industry_name": "银行",
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"page": 1,
"page_size": 2
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"total": 42,
"page": 1,
"page_size": 2,
"data": [
{
"date": "2026-08-24",
"first_industry_name": "银行",
"second_industry_name": "全国性股份制银行Ⅱ",
"third_industry_name": "全国性股份制银行Ⅲ",
"code": "000001",
"symbol": "平安银行"
},
{
"date": "2026-08-24",
"first_industry_name": "银行",
"second_industry_name": "区域性银行",
"third_industry_name": "城商行",
"code": "001227",
"symbol": "兰州银行"
}
]
}
}股票复权因子查询
POST /api/zhunzi_v1/hist-quotes/stock-adjust-factor
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 股票代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
补充说明
code为空时,start_date默认为一年前,查询跨度不能超过 1 年code非空时,start_date不能大于end_date
请求示例
json
{
"code": ["002041"]
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"code": "002041",
"symbol": "登海种业",
"ex_date": "2025-05-29T00:00:00",
"ex_factor": 1.0029484065435603,
"ex_cum_factor": 13.7087,
"announcement_date": "2025-05-28T00:00:00",
"ex_end_date": null
},
{
"code": "002041",
"symbol": "登海种业",
"ex_date": "2024-05-29T00:00:00",
"ex_factor": 1.0038410411204384,
"ex_cum_factor": 13.6684,
"announcement_date": "2024-05-28T00:00:00",
"ex_end_date": "2025-05-28T00:00:00"
}
]
}ETF 类接口
ETF 日线行情查询
POST /api/zhunzi_v1/hist-quotes/etf/daily
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | ETF 代码列表,最多 50 个 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
adjust | string | 否 | none | 复权方式:none-不复权 / pre-前复权 / post-后复权 |
补充说明
- 校验规则同股票日线行情查询
请求示例
json
{
"code": ["510050"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"exchange": "XSHG",
"code": "510050",
"symbol": "华夏上证50ETF",
"date": "2026-08-24",
"prev_close": 2.993,
"limit_up": 3.292,
"limit_down": 2.694,
"open": 2.991,
"high": 2.997,
"low": 2.966,
"close": 2.979,
"volume": 694511000,
"total_turnover": 2070626243,
"num_trades": 28540,
"iopv": 2.9794
}
]
}ETF 日线数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
exchange | string | 交易所代码 |
code | string | ETF 代码 |
symbol | string | ETF 名称 |
date | string | 交易日期 |
prev_close | float | 昨日收盘价 |
limit_up | float | 涨停价 |
limit_down | float | 跌停价 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
volume | int | 成交量 |
total_turnover | float | 成交额 |
num_trades | int | 成交笔数 |
iopv | float | 基金份额参考净值(IOPV) |
ETF 分钟行情查询
POST /api/zhunzi_v1/hist-quotes/etf/minute
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个 ETF 代码 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
frequency | string | 否 | 1m | 频率:1m / 5m / 15m / 30m / 60m |
adjust | string | 否 | none | 复权方式:none-不复权 / pre-前复权 / post-后复权 |
请求示例
json
{
"code": "159919",
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"frequency": "1m"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"code": "159919",
"symbol": "嘉实沪深300ETF",
"date": "2026-08-24",
"time": "0930",
"prev_close": "4.888",
"limit_up": "5.377",
"limit_down": "4.399",
"open": "4.886",
"high": "4.886",
"low": "4.886",
"close": "4.886",
"volume": "62300.0",
"money": "304397.0",
"num_trades": "nan",
"iopv": "nan"
},
{
"code": "159919",
"symbol": "嘉实沪深300ETF",
"date": "2026-08-24",
"time": "0931",
"prev_close": "4.888",
"limit_up": "5.377",
"limit_down": "4.399",
"open": "4.886",
"high": "4.889",
"low": "4.88",
"close": "4.887",
"volume": "729100.0",
"money": "3561085.0",
"num_trades": "126.0",
"iopv": "4.8841"
}
]
}ETF 逐笔 Tick 查询
POST /api/zhunzi_v1/hist-quotes/etf-tick
查询指定日期的 ETF 逐笔 Tick 数据,返回格式为列式存储(keys + data 二维数组)。
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个 ETF 代码 |
date | string | 是 | - | 查询日期,格式 YYYY-MM-DD |
请求示例
json
{
"code": "159919",
"date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"keys": ["date", "code", "display_name", "time", "open", "current", "high", "low", "total_volume", "total_money", "volume", "money", "a5_v", "a5_p", "a4_v", "a4_p", "a3_v", "a3_p", "a2_v", "a2_p", "a1_v", "a1_p", "b1_v", "b1_p", "b2_v", "b2_p", "b3_v", "b3_p", "b4_v", "b4_p", "b5_v", "b5_p", "b_s"],
"data": [
["2026-08-24", "159919", "沪深300ETF嘉实", "20260824091500", 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 31300, 0, 4800, 4.888, 4800, 4.888, 0, 0, 0, 0, 0, 0, 0, 0, "e"],
["2026-08-24", "159919", "沪深300ETF嘉实", "20260824091509", 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 31200, 0, 4900, 4.888, 4900, 4.888, 0, 0, 0, 0, 0, 0, 0, 0, "e"]
]
}
}ETF Tick 数据字段说明
响应采用列式存储格式,keys 与股票 Tick 基本一致,额外包含 display_name 字段。
| 字段 | 类型 | 说明 |
|---|---|---|
date | string | 交易日期 |
code | string | ETF 代码 |
display_name | string | ETF 名称 |
time | string | 成交时间 |
open | float | 开盘价 |
current | float | 当前价 |
high | float | 最高价 |
low | float | 最低价 |
total_volume | float | 累计成交量 |
total_money | float | 累计成交额 |
volume | float | 本笔成交量 |
money | float | 本笔成交额 |
a5_v ~ a1_v | float | 卖五量 ~ 卖一量 |
a5_p ~ a1_p | float | 卖五价 ~ 卖一价 |
b1_v ~ b5_v | float | 买一量 ~ 买五量 |
b1_p ~ b5_p | float | 买一价 ~ 买五价 |
b_s | string | 买卖方向(b-买 / s-卖 / e-均衡) |
ETF 复权因子查询
POST /api/zhunzi_v1/hist-quotes/etf-adjust-factor
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | ETF 代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
校验规则
同股票复权因子查询。
请求示例
json
{
"code": ["510050"]
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"code": "510050",
"symbol": "华夏上证50ETF",
"ex_date": "2025-12-17T00:00:00",
"ex_factor": 1.026465198174566,
"ex_cum_factor": 1.71393,
"announcement_date": "2025-12-16T00:00:00",
"ex_end_date": null
},
{
"code": "510050",
"symbol": "华夏上证50ETF",
"ex_date": "2024-12-02T00:00:00",
"ex_factor": 1.0205423774394455,
"ex_cum_factor": 1.66974,
"announcement_date": "2024-11-29T00:00:00",
"ex_end_date": "2025-12-16T00:00:00"
}
]
}指数类接口
指数日线行情查询
POST /api/zhunzi_v1/hist-quotes/index/daily
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 指数代码列表,最多 50 个 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
补充说明
start_date和count均未传时,默认count=10code为空时,start_date必须等于end_date
请求示例
json
{
"code": ["000300"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"exchange": "XSHG",
"code": "000300",
"symbol": "沪深300",
"date": "2026-08-24",
"prev_close": 4618.8952,
"open": 4620.9489,
"high": 4621.3893,
"low": 4527.4871,
"close": 4563.1266,
"volume": 20661687200,
"total_turnover": 590425593776.3
}
]
}指数日线数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
exchange | string | 交易所代码 |
code | string | 指数代码 |
symbol | string | 指数名称 |
date | string | 交易日期 |
prev_close | float | 昨日收盘价 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
volume | int | 成交量 |
total_turnover | float | 成交额 |
指数分钟行情查询
POST /api/zhunzi_v1/hist-quotes/index/minute
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个指数代码 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
frequency | string | 否 | 1m | 频率:1m / 5m / 15m / 30m / 60m |
请求示例
json
{
"code": "000300",
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"frequency": "1m"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"exchange": "XSHG",
"code": "000300",
"symbol": "沪深300",
"date": "2026-08-24",
"time": "0930",
"open": "4620.9489",
"high": "4620.9489",
"low": "4620.9489",
"close": "4620.9489",
"volume": "154055900.0",
"money": "4419017043.0",
"prev_close": "4618.8952"
},
{
"exchange": "XSHG",
"code": "000300",
"symbol": "沪深300",
"date": "2026-08-24",
"time": "0931",
"open": "4620.9489",
"high": "4621.3893",
"low": "4613.9782",
"close": "4616.6553",
"volume": "510705600.0",
"money": "15582756489.400002",
"prev_close": "4618.8952"
}
]
}指数逐笔 Tick 查询
POST /api/zhunzi_v1/hist-quotes/index-tick
查询指定日期的指数逐笔 Tick 数据,返回格式为列式存储(keys + data 二维数组)。
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个指数代码 |
date | string | 是 | - | 查询日期,格式 YYYY-MM-DD |
请求示例
json
{
"code": "000300",
"date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"keys": ["code", "name", "time", "open", "current", "high", "low", "total_volume", "total_money", "volume", "money", "b/s"],
"data": [
["000300", "沪深300", "20260824091500", "0.0", "4618.7739", "0.0", "0.0", "0.0", "0.0", "0", "0.0", "e"],
["000300", "沪深300", "20260824091503", "0.0", "4618.7739", "0.0", "0.0", "0.0", "0.0", "0", "0.0", "e"]
]
}
}指数 Tick 数据字段说明
响应采用列式存储格式。指数无买卖盘数据,字段较股票/ETF 更少。
| 字段 | 类型 | 说明 |
|---|---|---|
code | string | 指数代码 |
name | string | 指数名称 |
time | string | 成交时间 |
open | float | 开盘价 |
current | float | 当前价 |
high | float | 最高价 |
low | float | 最低价 |
total_volume | float | 累计成交量 |
total_money | float | 累计成交额 |
volume | float | 本笔成交量 |
money | float | 本笔成交额 |
b/s | string | 买卖方向(b-买 / s-卖 / e-均衡) |
POST /api/zhunzi_v1/hist-quotes/index-weights
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
index_code | string[] | 是 | - | 指数代码列表,最多 50 个 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
period | string | 是 | - | 周期:daily / month |
page | int | 否 | 1 | 页码,≥ 1 |
page_size | int | 否 | 1000 | 每页行数(1-1000) |
补充说明
index_code为空时,start_date默认为当天,查询跨度不能超过 1 个月(31 天)index_code非空时,查询跨度不能超过HIST_QUOTES_MAX_DATE_RANGE_DAYS(默认 365 天)
请求示例
json
{
"index_code": ["000300"],
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"period": "daily",
"page": 1,
"page_size": 2
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"total": 300,
"page": 1,
"page_size": 2,
"data": [
{
"date": "2026-08-24",
"index_code": "000300",
"index_name": "沪深300",
"stock_code": "000001",
"stock_name": "平安银行",
"weights": 0.00433
},
{
"date": "2026-08-24",
"index_code": "000300",
"index_name": "沪深300",
"stock_code": "000002",
"stock_name": "万科A",
"weights": 0.00087
}
]
}
}期货类接口
期货主力日线行情查询
POST /api/zhunzi_v1/hist-quotes/future/daily
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 期货主力合约代码列表(如 A88、IF88),最多 50 个 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
补充说明
start_date和count均未传时,默认count=10code为空时,start_date必须等于end_date
请求示例
json
{
"code": ["A88"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"exchange": "DCE",
"date": "2026-08-24",
"code": "A88",
"symbol": "豆一主力连续",
"open": 5035,
"high": 5093,
"low": 5018,
"close": 5031,
"prev_close": 5022,
"limit_up": 5369,
"limit_down": 4763,
"total_turnover": 16690393100,
"volume": 330539,
"settlement": 5049,
"prev_settlement": 5066,
"open_interest": 381012,
"day_session_open": 5038,
"dominant_id": "A2611"
}
]
}期货日线数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
exchange | string | 交易所代码 |
date | string | 交易日期 |
code | string | 合约代码 |
symbol | string | 合约名称 |
open | float | 开盘价 |
high | float | 最高价 |
low | float | 最低价 |
close | float | 收盘价 |
prev_close | float | 昨日收盘价 |
limit_up | float | 涨停价 |
limit_down | float | 跌停价 |
total_turnover | float | 成交额 |
volume | int | 成交量 |
settlement | float | 结算价 |
prev_settlement | float | 昨日结算价 |
open_interest | int | 持仓量 |
day_session_open | float | 日盘开盘价 |
dominant_id | string | 主力合约标识 |
期货主力分钟行情查询
POST /api/zhunzi_v1/hist-quotes/future/minute
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个期货主力合约代码 |
count | int | 否 | 10 | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
frequency | string | 否 | 1m | 频率:1m / 5m / 15m / 30m / 60m |
请求示例
json
{
"code": "A88",
"start_date": "2026-08-24",
"end_date": "2026-08-24",
"frequency": "1m"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"exchange": "DCE",
"code": "A88",
"symbol": "豆一主力连续",
"trading_date": "2026-08-24",
"datetime": "2026-08-21 21:01:00",
"pre_close": "5022.0",
"open": "5035.0",
"high": "5036.0",
"low": "5030.0",
"close": "5031.0",
"volume": "6027.0",
"total_turnover": "303332220.0",
"open_interest": "390298.0"
},
{
"exchange": "DCE",
"code": "A88",
"symbol": "豆一主力连续",
"trading_date": "2026-08-24",
"datetime": "2026-08-21 21:02:00",
"pre_close": "5022.0",
"open": "5031.0",
"high": "5032.0",
"low": "5024.0",
"close": "5024.0",
"volume": "2956.0",
"total_turnover": "148629400.0",
"open_interest": "389762.0"
}
]
}期货分钟数据字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
exchange | string | 交易所代码 |
code | string | 合约代码 |
symbol | string | 合约名称 |
trading_date | string | 交易日 |
datetime | string | 数据时刻 |
pre_close | string | 昨日收盘价 |
open | string | 开盘价 |
high | string | 最高价 |
low | string | 最低价 |
close | string | 收盘价 |
volume | string | 成交量 |
total_turnover | string | 成交额 |
open_interest | string | 持仓量 |
期货逐笔 Tick 查询
POST /api/zhunzi_v1/hist-quotes/future-tick
查询指定日期的期货逐笔 Tick 数据,返回格式为列式存储(keys + data 二维数组)。
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string | 是 | - | 单个期货合约代码(如 A2609.XDCE) |
date | string | 是 | - | 查询日期,格式 YYYY-MM-DD |
请求示例
json
{
"code": "A2609.XDCE",
"date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": {
"keys": ["symbol", "code", "name", "time", "open", "current", "high", "low", "volume", "money", "position", "a1_v", "a1_p", "b1_v", "b1_p"],
"data": [
["A2609.XDCE", "a2609", "豆一2609", "20260821210000", "4962.0", "4983.0", "4987.0", "4962.0", "21.0", "1045000.0", "50666.0", "7.0", "4983.0", "13.0", "4964.0"],
["A2609.XDCE", "a2609", "豆一2609", "20260821210000", "4962.0", "4986.0", "4987.0", "4962.0", "46.0", "2290940.0", "50684.0", "3.0", "4987.0", "60.0", "4984.0"]
]
}
}期货 Tick 数据字段说明
响应采用列式存储格式。期货仅有买卖一档盘口,字段较股票/ETF 更少。
| 字段 | 类型 | 说明 |
|---|---|---|
symbol | string | 合约符号 |
code | string | 合约代码 |
name | string | 合约名称 |
time | string | 成交时间 |
open | float | 开盘价 |
current | float | 当前价 |
high | float | 最高价 |
low | float | 最低价 |
volume | float | 本笔成交量 |
money | float | 本笔成交额 |
position | float | 持仓量 |
a1_v | float | 卖一量 |
a1_p | float | 卖一价 |
b1_v | float | 买一量 |
b1_p | float | 买一价 |
期货合约日线行情查询
POST /api/zhunzi_v1/hist-quotes/future-contract/daily
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 合约代码列表(如 IF2609),最多 50 个 |
count | int | 否 | - | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
frequency | string | 否 | 1m | 频率:1d / day / 1m / 5m / 15m / 30m / 60m |
补充说明
- 日线频率下
start_date和count均未传时,默认count=10 - 非日线频率下
code不能为空列表 - 日线查询
code为空时,start_date必须等于end_date
请求示例
json
{
"code": ["IF2609"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}响应示例
json
{
"code": "00000",
"msg": "成功",
"data": [
{
"exchange": "CFFEX",
"date": "2026-08-24",
"code": "IF2609",
"symbol": "股指2609",
"open": 4607.4,
"high": 4607.4,
"low": 4486.4,
"close": 4526.4,
"prev_close": 4576,
"limit_up": 5035.2,
"limit_down": 4120,
"total_turnover": 100897495860,
"volume": 74259,
"settlement": 4512.6,
"prev_settlement": 4577.6,
"open_interest": 158088,
"day_session_open": 4607.4
}
]
}期货合约分钟行情查询
POST /api/zhunzi_v1/hist-quotes/future-contract/minute
请求参数
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
code | string[] | 是 | - | 合约代码列表,最多 50 个 |
count | int | 否 | - | 返回行数(1-1000),与 start_date 二选一 |
start_date | string | 否 | - | 开始时间,格式 YYYY-MM-DD |
end_date | string | 否 | 当天 | 结束时间,格式 YYYY-MM-DD |
frequency | string | 否 | 1m | 频率:1d / day / 1m / 5m / 15m / 30m / 60m |
补充说明
同期货合约日线行情查询。
响应压缩
- 响应体 ≥ 500 字节时,自动压缩为 gzip 格式,响应头包含
Content-Encoding: gzip、Vary: Accept-Encoding,Content-Length为压缩后大小 - 响应体 < 500 字节时,不压缩,原样返回
- 客户端无需发送
Accept-Encoding请求头,服务端无条件压缩
Python 请求示例
python
import requests
url = "https://zhunData.cn/api/zhunzi_v1/hist-quotes/stock/daily"
headers = {"x-api-key": "your_api_key"}
resp = requests.post(url, json={
"code": ["002041"],
"start_date": "2026-08-24",
"end_date": "2026-08-24"
}, headers=headers)
# requests 自动解压 gzip 响应
data = resp.json()
print(data)Java 请求示例
java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://zhunData.cn/api/zhunzi_v1/hist-quotes/stock/daily"))
.header("Content-Type", "application/json")
.header("x-api-key", "your_api_key")
.POST(HttpRequest.BodyPublishers.ofString("""
{"code":["002041"],"start_date":"2026-08-24","end_date":"2026-08-24"}
"""))
.build();
// HttpClient 自动解压 gzip 响应
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());接口速查表
股票类
| 接口 | 路径 | 说明 |
|---|---|---|
| 股票日线行情 | /api/zhunzi_v1/hist-quotes/stock/daily | 日线行情,支持复权 |
| 股票分钟行情 | /api/zhunzi_v1/hist-quotes/stock/minute | 分钟行情,支持复权 |
| 股票逐笔 Tick | /api/zhunzi_v1/hist-quotes/stock-tick | 逐笔 Tick 数据 |
| 集合竞价过程 | /api/zhunzi_v1/hist-quotes/bidding | 竞价过程快照 |
| 集合竞价详情 | /api/zhunzi_v1/hist-quotes/bid-detail | 竞价明细数据 |
| 概念行情 | /api/zhunzi_v1/hist-quotes/concept | 概念板块行情 |
| 龙虎榜 | /api/zhunzi_v1/hist-quotes/dragon | 龙虎榜数据 |
| 涨停统计 | /api/zhunzi_v1/hist-quotes/limit-up | 涨停板统计 |
| 资金流向 | /api/zhunzi_v1/hist-quotes/money-flow | 个股/板块资金流向 |
| 行业分类 | /api/zhunzi_v1/hist-quotes/industry | 三级行业分类数据 |
| 股票复权因子 | /api/zhunzi_v1/hist-quotes/stock-adjust-factor | 前后复权因子 |
ETF 类
| 接口 | 路径 | 说明 |
|---|---|---|
| ETF 日线行情 | /api/zhunzi_v1/hist-quotes/etf/daily | 日线行情,支持复权 |
| ETF 分钟行情 | /api/zhunzi_v1/hist-quotes/etf/minute | 分钟行情,支持复权 |
| ETF 逐笔 Tick | /api/zhunzi_v1/hist-quotes/etf-tick | 逐笔 Tick 数据 |
| ETF 复权因子 | /api/zhunzi_v1/hist-quotes/etf-adjust-factor | 前后复权因子 |
指数类
| 接口 | 路径 | 说明 |
|---|---|---|
| 指数日线行情 | /api/zhunzi_v1/hist-quotes/index/daily | 日线行情 |
| 指数分钟行情 | /api/zhunzi_v1/hist-quotes/index/minute | 分钟行情 |
| 指数逐笔 Tick | /api/zhunzi_v1/hist-quotes/index-tick | 逐笔 Tick 数据 |
| 指数权重 | /api/zhunzi_v1/hist-quotes/index-weights | 按日/月查询成分权重 |
期货类
| 接口 | 路径 | 说明 |
|---|---|---|
| 期货主力日线行情 | /api/zhunzi_v1/hist-quotes/future/daily | 日线行情 |
| 期货主力分钟行情 | /api/zhunzi_v1/hist-quotes/future/minute | 分钟行情 |
| 期货逐笔 Tick | /api/zhunzi_v1/hist-quotes/future-tick | 逐笔 Tick 数据 |
| 期货合约日线行情 | /api/zhunzi_v1/hist-quotes/future-contract/daily | 合约日线行情 |
| 期货合约分钟行情 | /api/zhunzi_v1/hist-quotes/future-contract/minute | 合约分钟行情 |
配置项
| 配置项 | 默认值 | 说明 |
|---|---|---|
HIST_QUOTES_ENDPOINT_RATE_LIMIT | 30 | 每 IP 每分钟请求限制 |
HIST_QUOTES_MAX_DATE_RANGE_DAYS | 365 | 最大查询日期跨度(天) |
HIST_QUOTES_MAX_RESULT_ROWS | 1000 | 单次查询最大返回行数 |
HIST_QUOTES_QUERY_TIMEOUT_SEC | 30 | 查询超时时间(秒) |
RATE_LIMIT_ENABLED | true | 是否启用限流 |