A 股指数历史行情数据

股指历史数据

GET /stock/cn/index/history

业务说明

支持所有指数数据查询；

支持全量指数历史数据查询；

多维度的统计时间以及数据结果；

秒级查询性能；

围绕“A 股股票指数历史数据”提供标准化能力，便于快速接入现有业务；

适合将“A 股股票指数历史数据”结果接入业务系统、后台工具和自动化流程；

适合行情看板、投研系统和自动化数据任务接入；

可与股票代码、交易日历、资金流和财务数据接口组合；

鉴权：需要 AppKey，使用本操作声明的鉴权位置。

请求参数

参数	位置	类型	必填	真实默认值	说明
appkey	query	string	否	无	付费后获取的 APPKEY
symbol	query	string	是	无	传递上面获取的指数编码，如: 000001。可通过前置接口或参见 A 股指数代码参数枚举页面
period	query	string	是	无	统计周期，参数可选值为 DAILY \| WEEKLY \| MONTHLY
begindate	query	string	是	无	历史数据开始时间，格式为 20200101
enddate	query	string	是	无	历史数据结束时间，格式为 20200101，获取全量数据请分批获取，数据量较大，请保持合理的请求频率

独立请求示例

{
  "symbol": "000128",
  "period": "daily",
  "begindate": "20261026",
  "enddate": "20261030"
}

返回契约

HTTP 200：业务码 100 成功。
application/json

{
  "type": "object",
  "required": [
    "DataStatus",
    "Data"
  ],
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算"
        }
      }
    },
    "Data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "TimeKey": {
            "type": "string",
            "description": "交易时间"
          },
          "Symbol": {
            "type": "string",
            "description": "股票代码"
          },
          "Open": {
            "type": "number",
            "description": "开盘价，单位：元"
          },
          "Close": {
            "type": "number",
            "description": "收盘价，单位：元"
          },
          "High": {
            "type": "number",
            "description": "最高，单位：元"
          },
          "Low": {
            "type": "number",
            "description": "最低，单位：元"
          },
          "TradingVolume": {
            "type": "integer",
            "format": "int64",
            "description": "成交量，单位：股"
          },
          "TradingAmount": {
            "type": "number",
            "description": "成交额，单位：元"
          },
          "Swing": {
            "type": "number",
            "description": "振幅，单位：%"
          },
          "ChangePercent": {
            "type": "number",
            "description": "涨跌幅，单位：%"
          },
          "ChangeAmount": {
            "type": "number",
            "description": "涨跌额，单位：元"
          },
          "TurnoverRate": {
            "type": "number",
            "description": "换手率，单位：%"
          }
        },
        "required": [
          "TimeKey",
          "Symbol",
          "Open",
          "Close",
          "High",
          "Low",
          "TradingVolume",
          "TradingAmount",
          "Swing",
          "ChangePercent",
          "ChangeAmount",
          "TurnoverRate"
        ],
        "description": "行情对象数组；可靠来源确认区间无记录时为空数组。"
      },
      "description": "行情对象数组；可靠来源确认区间无记录时为空数组。"
    }
  }
}

HTTP 401：公共鉴权失败；沿用现有公共契约。

HTTP 403：公共权益或额度不足；沿用现有公共契约。

HTTP 404：资源不存在。请求路径不存在。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 405：请求方法不允许。当前路径不支持该 HTTP 方法。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 415：请求内容类型不支持。上传或请求体的内容类型不符合接口要求。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 429：公共频率限制；沿用现有公共契约。

HTTP 502：上游依赖错误。上游依赖服务不可用或返回异常。
application/json

{
  "$ref": "#/components/schemas/CommonResponse"
}

HTTP 400：业务码 501：参数缺失、非法、重复或冲突。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "行情对象数组；可靠来源确认区间无记录时为空数组。"
    }
  }
}

HTTP 503：业务码 901：处理、依赖失败或超时。
application/json

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "请求参数，一般用于调试"
        },
        "StatusCode": {
          "type": "integer",
          "description": "接口返回状态码"
        },
        "StatusDescription": {
          "type": "string",
          "description": "接口返回状态说明"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "接口数据返回时间"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "此条件下的总数据量，一般用于分页计算"
        }
      }
    },
    "Data": {
      "type": "null",
      "description": "行情对象数组；可靠来源确认区间无记录时为空数组。"
    }
  }
}

业务状态与 HTTP 状态

业务码	含义	说明
100	成功	HTTP 200；仍应检查业务状态。
501	参数错误	HTTP 400
901	依赖失败	HTTP 503

接口详情：https://www.gugudata.com/api/details/stockcnindexhistory
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"symbol=000001\u0026period=daily\u0026begindate=20260101\u0026enddate=20261231","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-11-02 15:27:04.806","DataTotalCount":198},"Data":[{"TimeKey":"2026-01-05","Symbol":"000001","Open":3986.969970703125,"Close":4023.419921875,"High":4025.260009765625,"Low":3983.580078125,"TradingVolume":596950455,"TradingAmount":1067334172672,"Swing":1.0499999523162842,"ChangePercent":1.3799999952316284,"ChangeAmount":54.580001831054688,"TurnoverRate":1.2300000190734863},{"TimeKey":"2026-01-06","Symbol":"000001","Open":4026.02001953125,"Close":4083.669921875,"High":4083.669921875,"Low":4025.090087890625,"TradingVolume":702472270,"TradingAmount":1175768662016,"Swing":1.4600000381469727,"ChangePercent":1.5,"ChangeAmount":60.25,"TurnoverRate":1.440000057220459},{"TimeKey":"2026-01-07","Symbol":"000001","Open":4083.840087890625,"Close":4085.77001953125,"High":4098.77978515625,"Low":4069.43994140625,"TradingVolume":683384352,"TradingAmount":1197422804992,"Swing":0.72000002861022949,"ChangePercent":0.05000000074505806,"ChangeAmount":2.0999999046325684,"TurnoverRate":1.4099999666213989},{"TimeKey":"2026-01-08","Symbol":"000001","Open":4077.719970703125,"Close":4082.97998046875,"High":4093.8701171875,"Low":4067.1201171875,"TradingVolume":666131337,"TradingAmount":1183188779008,"Swing":0.64999997615814209,"ChangePercent":-0.070000000298023224,"ChangeAmount":-2.7899999618530273,"TurnoverRate":1.3700000047683716},{"TimeKey":"2026-01-09","Symbol":"000001","Open":4086.760009765625,"Close":4120.43017578125,"High":4121.72021484375,"Low":4083.6201171875,"TradingVolume":729837985,"TradingAmount":1289205972992,"Swing":0.93000000715255737,"ChangePercent":0.92000001668930054,"ChangeAmount":37.450000762939453,"TurnoverRate":1.5},{"TimeKey":"2026-01-12","Symbol":"000001","Open":4134.89013671875,"Close":4165.2900390625,"High":4168.35986328125,"Low":4119.8798828125,"TradingVolume":839456089,"TradingAmount":1446230097920,"Swing":1.1799999475479126,"ChangePercent":1.0900000333786011,"ChangeAmount":44.860000610351563,"TurnoverRate":1.7300000190734863},{"TimeKey":"2026-01-13","Symbol":"000001","Open":4169.7001953125,"Close":4138.759765625,"High":4179.7001953125,"Low":4126.22998046875,"TradingVolume":868382717,"TradingAmount":1481574187008,"Swing":1.2799999713897705,"ChangePercent":-0.63999998569488525,"ChangeAmount":-26.530000686645508,"TurnoverRate":1.7899999618530273},{"TimeKey":"2026-01-14","Symbol":"000001","Open":4138.64990234375,"Close":4126.08984375,"High":4190.8701171875,"Low":4103.6201171875,"TradingVolume":952551289,"TradingAmount":1607041286144,"Swing":2.1099998950958252,"ChangePercent":-0.31000000238418579,"ChangeAmount":-12.670000076293945,"TurnoverRate":1.9600000381469727},{"TimeKey":"2026-01-15","Symbol":"000001","Open":4106.22021484375,"Close":4112.60009765625,"High":4133.06982421875,"Low":4096.85009765625,"TradingVolume":680250791,"TradingAmount":1175915069440,"Swing":0.87999999523162842,"ChangePercent":-0.33000001311302185,"ChangeAmount":-13.489999771118164,"TurnoverRate":1.3999999761581421},{"TimeKey":"2026-01-16","Symbol":"000001","Open":4127.06005859375,"Close":4101.91015625,"High":4140.22998046875,"Low":4091.81005859375,"TradingVolume":763588465,"TradingAmount":1338017316864,"Swing":1.1799999475479126,"ChangePercent":-0.25999999046325684,"ChangeAmount":-10.6899995803833,"TurnoverRate":1.5700000524520874},{"TimeKey":"2026-01-19","Symbol":"000001","Open":4090.719970703125,"Close":4114,"High":4126.52001953125,"Low":4090.06005859375,"TradingVolume":688905870,"TradingAmount":1190137823232,"Swing":0.88999998569488525,"ChangePercent":0.28999999165534973,"ChangeAmount":12.090000152587891,"TurnoverRate":1.4199999570846558},{"TimeKey":"2026-01-20","Symbol":"000001","Open":4116.3701171875,"Close":4113.64990234375,"High":4128.93017578125,"Low":4080.2900390625,"TradingVolume":734362496,"TradingAmount":1221485658112,"Swing":1.1799999475479126,"ChangePercent":-0.0099999997764825821,"ChangeAmount":-0.34999999403953552,"TurnoverRate":1.5099999904632568},{"TimeKey":"2026-01-21","Symbol":"000001","Open":4103.52978515625,"Close":4116.93994140625,"High":4135.9599609375,"Low":4103.52978515625,"TradingVolume":666989507,"TradingAmount":1180184608768,"Swing":0.79000002145767212,"ChangePercent":0.079999998211860657,"ChangeAmount":3.2899999618530273,"TurnoverRate":1.3700000047683716},{"TimeKey":"2026-01-22","Symbol":"000001","Open":4126.06982421875,"Close":4122.580078125,"High":4140.83984375,"Low":4109.919921875,"TradingVolume":709695409,"TradingAmount":1201764171776,"Swing":0.75,"ChangePercent":0.14000000059604645,"ChangeAmount":5.6399998664855957,"TurnoverRate":1.4600000381469727},{"TimeKey":"2026-01-23","Symbol":"000001","Open":4130.10986328125,"Close":4136.16015625,"High":4143.75,"Low":4120.2001953125,"TradingVolume":782115454,"TradingAmount":1336857067520,"Swing":0.56999999284744263,"ChangePercent":0.33000001311302185,"ChangeAmount":13.579999923706055,"Tur

🟠400请求参数错误。请求参数缺失、格式错误或参数组合不合法。

🟠401鉴权失败。缺少 appkey 或 appkey 无效。

🟠403无权限访问。订单到期、权限不足或接口额度不可用。

🟠404资源不存在。请求路径不存在。

🟠405请求方法不允许。当前路径不支持该 HTTP 方法。

🟠415请求内容类型不支持。上传或请求体的内容类型不符合接口要求。

🟠429请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。

🔴500服务内部错误。服务端处理异常，请稍后重试。

🔴502上游依赖错误。上游依赖服务不可用或返回异常。

🔴503业务码 901：处理、依赖失败或超时。

业务说明#

请求参数#

独立请求示例#

返回契约#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

请求参数

独立请求示例

返回契约

业务状态与 HTTP 状态