Skip to content

历史行情查询接口文档

概述

本接口模块提供历史行情数据查询服务,涵盖股票、ETF、指数、期货等品种的日线/分钟行情,以及复权因子、指数权重、逐笔 Tick、集合竞价、概念行情、龙虎榜、涨停统计、资金流向、行业分类等数据查询。

  • 服务地址https://zhunData.cn
  • 基础路径/api/zhunzi_v1/hist-quotes
  • 请求方式:所有接口均为 POST
  • Content-Typeapplication/json
  • 鉴权方式:请求头携带 x-api-key,如 x-api-key: your_api_key
  • 限流策略:每 IP 每分钟 30 次请求

统一响应格式

json
{
  "code": "00000",
  "msg": "成功",
  "data": {}
}
字段类型说明
codestring业务状态码,00000 表示成功
msgstring提示信息
dataobject/array响应数据

常见错误码

错误码HTTP 状态码说明
00000200成功
A0301401缺少或无效的 API Key
A0400422参数校验失败
A0502429请求过于频繁(限流)
B0001500系统执行异常

股票类接口

股票日线行情查询

POST /api/zhunzi_v1/hist-quotes/stock/daily

请求参数

字段类型必填默认值说明
codestring[]-股票代码列表,最多 50 个
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
adjuststringnone复权方式:none-不复权 / pre-前复权 / post-后复权

补充说明

  • start_datecount 均未传时,默认 count=10
  • code 为空时,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
    }
  ]
}

股票日线数据字段说明

字段类型说明
datestring交易日期
codestring股票代码
display_namestring股票名称
is_ststring是否 ST 股
pausedstring是否停牌
pre_closefloat昨日收盘价
high_limitfloat涨停价
low_limitfloat跌停价
openfloat开盘价
highfloat最高价
lowfloat最低价
closefloat收盘价
volumeint成交量
amountfloat成交额
avgfloat成交均价
turnover_ratiofloat换手率
capitalizationfloat总股本(万股)
circulating_capfloat流通股本(万股)
market_capfloat总市值(亿元)
circulating_market_capfloat流通市值(亿元)
pe_ratiofloat市盈率(TTM)
pe_ratio_lyrfloat市盈率(LYR)
pb_ratiofloat市净率
ps_ratiofloat市销率
pcf_ratiofloat现金流市盈率

股票分钟行情查询

POST /api/zhunzi_v1/hist-quotes/stock/minute

请求参数

字段类型必填默认值说明
codestring-单个股票代码
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
frequencystring1m频率:1m / 5m / 15m / 30m / 60m
adjuststringnone复权方式: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
    }
  ]
}

股票分钟数据字段说明

字段类型说明
codestring股票代码
datestring交易日期
timestring分钟时间(如 1500 表示 15:00)
openfloat开盘价
highfloat最高价
lowfloat最低价
closefloat收盘价
volumeint成交量
moneyfloat成交额
pre_closefloat昨日收盘价
pre_avgfloat昨日成交均价

股票逐笔 Tick 查询

POST /api/zhunzi_v1/hist-quotes/stock-tick

查询指定日期的逐笔 Tick 数据,返回格式为列式存储(keys + data 二维数组)。

请求参数

字段类型必填默认值说明
codestring-单个股票代码
datestring-查询日期,格式 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 顺序对应。

字段类型说明
datestring交易日期
codestring股票代码
timestring成交时间
openfloat开盘价
currentfloat当前价
highfloat最高价
lowfloat最低价
total_volumefloat累计成交量
total_moneyfloat累计成交额
volumefloat本笔成交量
moneyfloat本笔成交额
a5_v ~ a1_vfloat卖五量 ~ 卖一量
a5_p ~ a1_pfloat卖五价 ~ 卖一价
b1_v ~ b5_vfloat买一量 ~ 买五量
b1_p ~ b5_pfloat买一价 ~ 买五价
b_sstring买卖方向(b-买 / s-卖 / e-均衡)

股票集合竞价过程查询

POST /api/zhunzi_v1/hist-quotes/bidding

查询指定日期的集合竞价过程数据,返回竞价过程中各时间点的买卖盘快照。

请求参数

字段类型必填默认值说明
codestring-单个股票代码
datestring-查询日期,格式 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
    }
  ]
}

竞价过程数据字段说明

字段类型说明
datestring交易日期
codestring股票代码
timestring竞价时间点
currentint当前价格
a1_pfloat卖一价
a1_vint卖一量
b1_vint买一量
a2_vint卖二量
b2_vint买二量
volumeint成交量

股票集合竞价详情查询

POST /api/zhunzi_v1/hist-quotes/bid-detail

请求参数

字段类型必填默认值说明
codestring[]-股票代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring-结束时间,格式 YYYY-MM-DD
pageint1页码,≥ 1
page_sizeint1000每页行数(1-1000)

补充说明

  • code 为空时,必须指定 start_dateend_date,且两者必须相等
  • code 非空时,必须指定 start_dateend_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

请求参数

字段类型必填默认值说明
codestring[]-代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring-结束时间,格式 YYYY-MM-DD
pageint1页码,≥ 1
page_sizeint1000每页行数(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

请求参数

字段类型必填默认值说明
codestring[]-代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring-结束时间,格式 YYYY-MM-DD
pageint1页码,≥ 1
page_sizeint1000每页行数(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

请求参数

字段类型必填默认值说明
codestring[]-代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring-结束时间,格式 YYYY-MM-DD
pageint1页码,≥ 1
page_sizeint1000每页行数(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

请求参数

字段类型必填默认值说明
codestring[]-代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring-结束时间,格式 YYYY-MM-DD
pageint1页码,≥ 1
page_sizeint1000每页行数(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

请求参数

字段类型必填默认值说明
codestring[]-代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring-结束时间,格式 YYYY-MM-DD
first_industry_namestring-一级行业名称
second_industry_namestring-二级行业名称
third_industry_namestring-三级行业名称
pageint1页码,≥ 1
page_sizeint1000每页行数(1-1000)

补充说明

  • code 和行业名称均为空时,必须指定 start_dateend_date,且两者必须相等
  • code 或行业名称非空时,必须指定 start_dateend_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

请求参数

字段类型必填默认值说明
codestring[]-股票代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 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

请求参数

字段类型必填默认值说明
codestring[]-ETF 代码列表,最多 50 个
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
adjuststringnone复权方式: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 日线数据字段说明

字段类型说明
exchangestring交易所代码
codestringETF 代码
symbolstringETF 名称
datestring交易日期
prev_closefloat昨日收盘价
limit_upfloat涨停价
limit_downfloat跌停价
openfloat开盘价
highfloat最高价
lowfloat最低价
closefloat收盘价
volumeint成交量
total_turnoverfloat成交额
num_tradesint成交笔数
iopvfloat基金份额参考净值(IOPV)

ETF 分钟行情查询

POST /api/zhunzi_v1/hist-quotes/etf/minute

请求参数

字段类型必填默认值说明
codestring-单个 ETF 代码
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
frequencystring1m频率:1m / 5m / 15m / 30m / 60m
adjuststringnone复权方式: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 二维数组)。

请求参数

字段类型必填默认值说明
codestring-单个 ETF 代码
datestring-查询日期,格式 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 字段。

字段类型说明
datestring交易日期
codestringETF 代码
display_namestringETF 名称
timestring成交时间
openfloat开盘价
currentfloat当前价
highfloat最高价
lowfloat最低价
total_volumefloat累计成交量
total_moneyfloat累计成交额
volumefloat本笔成交量
moneyfloat本笔成交额
a5_v ~ a1_vfloat卖五量 ~ 卖一量
a5_p ~ a1_pfloat卖五价 ~ 卖一价
b1_v ~ b5_vfloat买一量 ~ 买五量
b1_p ~ b5_pfloat买一价 ~ 买五价
b_sstring买卖方向(b-买 / s-卖 / e-均衡)

ETF 复权因子查询

POST /api/zhunzi_v1/hist-quotes/etf-adjust-factor

请求参数

字段类型必填默认值说明
codestring[]-ETF 代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 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

请求参数

字段类型必填默认值说明
codestring[]-指数代码列表,最多 50 个
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD

补充说明

  • start_datecount 均未传时,默认 count=10
  • code 为空时,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
    }
  ]
}

指数日线数据字段说明

字段类型说明
exchangestring交易所代码
codestring指数代码
symbolstring指数名称
datestring交易日期
prev_closefloat昨日收盘价
openfloat开盘价
highfloat最高价
lowfloat最低价
closefloat收盘价
volumeint成交量
total_turnoverfloat成交额

指数分钟行情查询

POST /api/zhunzi_v1/hist-quotes/index/minute

请求参数

字段类型必填默认值说明
codestring-单个指数代码
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
frequencystring1m频率: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 二维数组)。

请求参数

字段类型必填默认值说明
codestring-单个指数代码
datestring-查询日期,格式 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 更少。

字段类型说明
codestring指数代码
namestring指数名称
timestring成交时间
openfloat开盘价
currentfloat当前价
highfloat最高价
lowfloat最低价
total_volumefloat累计成交量
total_moneyfloat累计成交额
volumefloat本笔成交量
moneyfloat本笔成交额
b/sstring买卖方向(b-买 / s-卖 / e-均衡)

POST /api/zhunzi_v1/hist-quotes/index-weights

请求参数

字段类型必填默认值说明
index_codestring[]-指数代码列表,最多 50 个
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
periodstring-周期:daily / month
pageint1页码,≥ 1
page_sizeint1000每页行数(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

请求参数

字段类型必填默认值说明
codestring[]-期货主力合约代码列表(如 A88IF88),最多 50 个
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD

补充说明

  • start_datecount 均未传时,默认 count=10
  • code 为空时,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"
    }
  ]
}

期货日线数据字段说明

字段类型说明
exchangestring交易所代码
datestring交易日期
codestring合约代码
symbolstring合约名称
openfloat开盘价
highfloat最高价
lowfloat最低价
closefloat收盘价
prev_closefloat昨日收盘价
limit_upfloat涨停价
limit_downfloat跌停价
total_turnoverfloat成交额
volumeint成交量
settlementfloat结算价
prev_settlementfloat昨日结算价
open_interestint持仓量
day_session_openfloat日盘开盘价
dominant_idstring主力合约标识

期货主力分钟行情查询

POST /api/zhunzi_v1/hist-quotes/future/minute

请求参数

字段类型必填默认值说明
codestring-单个期货主力合约代码
countint10返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
frequencystring1m频率: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"
    }
  ]
}

期货分钟数据字段说明

字段类型说明
exchangestring交易所代码
codestring合约代码
symbolstring合约名称
trading_datestring交易日
datetimestring数据时刻
pre_closestring昨日收盘价
openstring开盘价
highstring最高价
lowstring最低价
closestring收盘价
volumestring成交量
total_turnoverstring成交额
open_intereststring持仓量

期货逐笔 Tick 查询

POST /api/zhunzi_v1/hist-quotes/future-tick

查询指定日期的期货逐笔 Tick 数据,返回格式为列式存储(keys + data 二维数组)。

请求参数

字段类型必填默认值说明
codestring-单个期货合约代码(如 A2609.XDCE
datestring-查询日期,格式 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 更少。

字段类型说明
symbolstring合约符号
codestring合约代码
namestring合约名称
timestring成交时间
openfloat开盘价
currentfloat当前价
highfloat最高价
lowfloat最低价
volumefloat本笔成交量
moneyfloat本笔成交额
positionfloat持仓量
a1_vfloat卖一量
a1_pfloat卖一价
b1_vfloat买一量
b1_pfloat买一价

期货合约日线行情查询

POST /api/zhunzi_v1/hist-quotes/future-contract/daily

请求参数

字段类型必填默认值说明
codestring[]-合约代码列表(如 IF2609),最多 50 个
countint-返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
frequencystring1m频率:1d / day / 1m / 5m / 15m / 30m / 60m

补充说明

  • 日线频率下 start_datecount 均未传时,默认 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

请求参数

字段类型必填默认值说明
codestring[]-合约代码列表,最多 50 个
countint-返回行数(1-1000),与 start_date 二选一
start_datestring-开始时间,格式 YYYY-MM-DD
end_datestring当天结束时间,格式 YYYY-MM-DD
frequencystring1m频率:1d / day / 1m / 5m / 15m / 30m / 60m

补充说明

同期货合约日线行情查询。


响应压缩

  • 响应体 ≥ 500 字节时,自动压缩为 gzip 格式,响应头包含 Content-Encoding: gzipVary: Accept-EncodingContent-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_LIMIT30每 IP 每分钟请求限制
HIST_QUOTES_MAX_DATE_RANGE_DAYS365最大查询日期跨度(天)
HIST_QUOTES_MAX_RESULT_ROWS1000单次查询最大返回行数
HIST_QUOTES_QUERY_TIMEOUT_SEC30查询超时时间(秒)
RATE_LIMIT_ENABLEDtrue是否启用限流