跳到主要内容

A股指数批量历史K线

信息

工具名:get_a_share_index_prices_historical_batch

对应 REST 端点:GET /api/a-share-index/prices/historical-batch

工具描述​

在同一时间窗口比较交易所指数、同花顺概念或行业指数。单次最多 10 个代码,仅支持日线 1d;查询范围为近 5 个自然年,下界以本次查询日(Asia/Shanghai)向前滚动 5 年的当地零点计算。例如查询日为 2026-11-03,下界为 2021-11-03 零点;并非任意两个历史日期间的 5 年跨度。 原生批量查询,所有代码共用查询条件;代码规范化后去重并保留首次出现顺序,上限按去重前代码项数检查。

参数​

参数类型必填默认说明
thscodesstring是—英文逗号分隔的完整代码,如 000001.SH,399001.SZ;最多 10 个,按去重前数量计数。
intervalstring是—K 线周期,当前仅支持 1d(日线)。
startlong是-起始时间,毫秒 Unix 时间戳;须为非负毫秒时间戳。
endlong是-结束时间,毫秒 Unix 时间戳;必须不早于 start,且查询区间需落在近 5 年的数据范围内;须为非负毫秒时间戳。

调用示例​

工具:get_a_share_index_prices_historical_batch
参数:
- thscodes: "000001.SH,399001.SZ"
- interval: "1d"
- start: 1735660800000
- end: 1767196800000

返回​

返回 { interval, adjust, item: [{ thscode, timestamp, item[] }] }。 有效标的按规范化代码首次出现顺序返回;未知或资产类型不匹配的代码省略其组,保留有效目标组并返回外层 code=0。有效标的无记录时保留 {thscode,timestamp:null,item:[]}。去重后仅一个目标且类型不支持返回 3004;其它全部无有效目标返回 3001。参数、整体上游或协议错误返回普通非零信封,data=null;目录不可用或身份歧义按整体错误处理。

详细字段与错误处理见指数批量历史 K 线。