A 股指数分时行情数据
GET
https://api.gugudata.com/stock/cn/index_perminutes
按指数、周期和时间区间查询分时行情
period 必填，没有运行默认值，可选 1、5、15、30、60。起止时间支持 yyyyMMdd HH:mm:ss，历史 yyyyMMdd 表达分别补 09:00:00 和 15:00:00，最大间隔 366 天。结果按原时间顺序返回；1 分钟与聚合周期可用指标不同，未提供的周期指标沿用原有零值表达，不代表已经核实该项为真实零值。1 分钟来源开盘值为 0 时保留该值，不替换为收盘值。日期与参数必须对应实际返回记录，不保证任意历史区间都有来源数据。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| appkey | string | 是 | 无 | 已开通本商品的 APPKEY；也可使用既有 Header 或 Bearer 鉴权，不同时要求多个载体。 |
| symbol | string | 是 | 无 | 单个有效指数代码，保留现有代码归一化规则。 |
| period | int | 是 | 无 | 分时周期，取值 1、5、15、30、60；不能省略，也没有默认 5。 |
| begindate | string | 是 | 无 | 起始时刻，yyyyMMdd HH:mm:ss；兼容 yyyyMMdd 并补 09:00:00。 |
| enddate | string | 是 | 无 | 结束时刻，yyyyMMdd HH:mm:ss；兼容 yyyyMMdd 并补 15:00:00，最大间隔 366 天。 |
请求示例（与默认值独立）：
{
"symbol": "000016",
"period": 5,
"begindate": "20261030 09:00:00",
"enddate": "20261030 15:00:00"
}
业务说明
- 按单个 A 股指数查询分时行情。
- 支持 1 分钟周期，便于展示细粒度点位变化。
- 支持 5、15、30、60 分钟周期，便于按不同周期观察。
- 使用起止时刻限制查询区间，适合分时图资料整理。
- 兼容既有八位日期输入，便于延续历史调用。
- 返回对应记录时间，便于将点位与交易时段关联。
- 返回开盘、收盘、最高和最低点位等周期资料。
- 返回分时成交量，便于观察区间交易规模。
- 返回分时成交额，便于制作成交规模图表。
- 聚合周期可返回涨跌幅与涨跌额，便于比较周期变化。
- 聚合周期可返回振幅和换手率资料，便于整理行情指标。
返回字段
| 字段 | 类型 | 必返 | 可为 null | 说明 |
|---|---|---|---|---|
| DataStatus.RequestParameter | string | 是 | 否 | 本次真实、可读的业务请求参数，不含凭据；Demo 与实际示例输入对应。 |
| DataStatus.StatusCode | integer | 是 | 否 | 100 成功；501 参数错误对应 HTTP 400；901 处理或依赖失败对应 HTTP 503，公共鉴权和限流规则保持。 |
| DataStatus.StatusDescription | string | 是 | 否 | 业务处理结果说明。 |
| DataStatus.ResponseDateTime | string | 是 | 否 | 响应生成时间，不代表资料公布、行情交易或净值日期。 |
| DataStatus.DataTotalCount | integer | 是 | 否 | 本次实际返回记录数量；技术资讯为本页文章数，未命中归属资料时为 0。 |
| Data | array | 是 | 否 | 按原时间顺序返回的分时行情对象数组；来源确认没有区间记录时为空数组。 |
| Data[].Symbol | string | 是 | 否 | 查询指数代码，保持原公开表达。 |
| Data[].TimeKey | string | 是 | 否 | 记录时间，yyyy-MM-dd HH:mm:ss。 |
| Data[].Open | number | 是 | 否 | 周期开盘点位；1 分钟来源合法的 0 保留。 |
| Data[].Close | number | 是 | 否 | 周期收盘点位。 |
| Data[].High | number | 是 | 否 | 周期最高点位。 |
| Data[].Low | number | 是 | 否 | 周期最低点位。 |
| Data[].ChangePercent | number | 是 | 否 | 周期涨跌幅，沿用来源单位；1 分钟缺省时保留原有 0。 |
| Data[].ChangeAmount | number | 是 | 否 | 周期涨跌额；1 分钟缺省时保留原有 0。 |
| Data[].TradingVolume | integer | 是 | 否 | 周期成交量，沿用原单位及整数类型。 |
| Data[].TradingAmount | number | 是 | 否 | 周期成交额，沿用原金额单位及精度。 |
| Data[].Swing | number | 是 | 否 | 周期振幅，沿用来源单位；1 分钟缺省时保留原有 0。 |
| Data[].TurnoverRate | number | 是 | 否 | 周期换手率，沿用来源单位；1 分钟缺省时保留原有 0。 |
业务状态与 HTTP 状态
| 业务码 | 含义 | HTTP 与处理说明 |
|---|---|---|
| 100 | 请求成功 | HTTP 200；请同时检查业务状态与返回数据。 |
| 501 | 参数错误 | HTTP 400；参数缺失、类型错误或参数冲突。 |
| 502 | 请求频率限制 | HTTP 429，沿用公共限流契约。 |
| 503 | 权益过期 | HTTP 403，沿用公共权益契约。 |
| 504 | 凭据或权限错误 | 结合 HTTP 状态区分凭据缺失、无效、无商品权限或鉴权服务不可用。 |
| 505 | 调用额度不足 | HTTP 403，沿用公共额度契约。 |
| 901 | 处理或依赖失败 | HTTP 503；包含目标处理失败、依赖失败和超时。 |
响应来源
X-GuGuData-Data-Source：fresh、cache、last-good。本次结果来源；备用资料可能较早，不改变响应数据字段。
接口详情：https://www.gugudata.com/api/details/stockcnindexperminutes
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-12 11:33:14