[DEMO] A 股历史行情数据

历史数据支持日线/周线/月线

GET /stock/cn/demo

业务说明

支持 A 股历史日线、周线、月线数据查询；

包含上交所和深交所所有股票数据；

每日 A 股收盘后更新当日交易数据，停牌不更新；

支持一次查询多个股票历史数据；

支持最大 3660 个自然日时间窗口查询；

超高查询效率，千万级数据毫秒级返回；

支持未复权、前复权、后复权三种数据形态查询；

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

此公开操作无需 AppKey。

返回契约

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": "接口实际使用的查询参数摘要，包含股票代码、起止日期、复权方式和行情周期，不包含 AppKey。Demo 返回固定样例的查询条件。"
        },
        "StatusCode": {
          "type": "integer",
          "description": "业务状态码。100 表示查询成功，其他值请结合 HTTP 状态与 StatusDescription 判断。"
        },
        "StatusDescription": {
          "type": "string",
          "description": "业务状态的文字说明。出错时可结合 StatusCode 定位原因。"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "服务端生成响应的时间，格式为 yyyy-MM-dd HH:mm:ss.fff。"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "本次 Data 数组实际返回的记录数。查询多只股票时计入所有股票的记录。"
        }
      }
    },
    "Data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "TimeKey",
          "Symbol",
          "StockName",
          "Open",
          "Close",
          "High",
          "Low",
          "TradingVolume",
          "TradingAmount",
          "Swing",
          "ChangePercent",
          "ChangeAmount",
          "TurnoverRate"
        ],
        "properties": {
          "TimeKey": {
            "type": "integer",
            "description": "该条行情对应的日期，使用 yyyyMMdd 格式的整数，例如 20261030。日线为交易日，周线和月线为行情记录标注的周期日期。"
          },
          "Symbol": {
            "type": "string",
            "description": "当前行情记录所属的六位 A 股股票代码，以字符串返回并保留前导零。批量查询时可用此字段按股票分组。"
          },
          "StockName": {
            "type": "string",
            "description": "股票名称，用于展示和核对股票代码。"
          },
          "Open": {
            "type": "number",
            "description": "所选周期内的开盘价，单位为元，按 adjust 指定的复权口径返回。"
          },
          "Close": {
            "type": "number",
            "description": "所选周期内的收盘价，单位为元，按 adjust 指定的复权口径返回。"
          },
          "High": {
            "type": "number",
            "description": "所选周期内的最高价，单位为元，按 adjust 指定的复权口径返回。"
          },
          "Low": {
            "type": "number",
            "description": "所选周期内的最低价，单位为元，按 adjust 指定的复权口径返回。"
          },
          "TradingVolume": {
            "type": "integer",
            "description": "成交量，单位为手（1 手 = 100 股）"
          },
          "TradingAmount": {
            "type": "number",
            "description": "所选周期内的成交金额合计，单位为元。"
          },
          "Swing": {
            "type": "number",
            "description": "所选周期内的价格振幅，单位为百分比。例如 2.5 表示振幅为 2.5%。"
          },
          "ChangePercent": {
            "type": "number",
            "description": "所选周期内的涨跌幅，单位为百分比。正值表示上涨，负值表示下跌，例如 -1.2 表示下跌 1.2%。"
          },
          "ChangeAmount": {
            "type": "number",
            "description": "所选周期内的涨跌额，单位为元。正值表示价格上涨，负值表示价格下跌。"
          },
          "TurnoverRate": {
            "type": "number",
            "description": "所选周期内的换手率，单位为百分比。例如 0.34 表示换手率为 0.34%。"
          }
        }
      }
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "接口实际使用的查询参数摘要，包含股票代码、起止日期、复权方式和行情周期，不包含 AppKey。Demo 返回固定样例的查询条件。"
        },
        "StatusCode": {
          "type": "integer",
          "description": "业务状态码。100 表示查询成功，其他值请结合 HTTP 状态与 StatusDescription 判断。"
        },
        "StatusDescription": {
          "type": "string",
          "description": "业务状态的文字说明。出错时可结合 StatusCode 定位原因。"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "服务端生成响应的时间，格式为 yyyy-MM-dd HH:mm:ss.fff。"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "本次 Data 数组实际返回的记录数。查询多只股票时计入所有股票的记录。"
        }
      }
    },
    "Data": {
      "type": "null"
    }
  }
}

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

{
  "type": "object",
  "properties": {
    "DataStatus": {
      "type": "object",
      "required": [
        "RequestParameter",
        "StatusCode",
        "StatusDescription",
        "ResponseDateTime",
        "DataTotalCount"
      ],
      "properties": {
        "RequestParameter": {
          "type": "string",
          "description": "接口实际使用的查询参数摘要，包含股票代码、起止日期、复权方式和行情周期，不包含 AppKey。Demo 返回固定样例的查询条件。"
        },
        "StatusCode": {
          "type": "integer",
          "description": "业务状态码。100 表示查询成功，其他值请结合 HTTP 状态与 StatusDescription 判断。"
        },
        "StatusDescription": {
          "type": "string",
          "description": "业务状态的文字说明。出错时可结合 StatusCode 定位原因。"
        },
        "ResponseDateTime": {
          "type": "string",
          "description": "服务端生成响应的时间，格式为 yyyy-MM-dd HH:mm:ss.fff。"
        },
        "DataTotalCount": {
          "type": "integer",
          "description": "本次 Data 数组实际返回的记录数。查询多只股票时计入所有股票的记录。"
        }
      }
    },
    "Data": {
      "type": "null"
    }
  }
}

业务状态与 HTTP 状态

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

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

常见问题

怎么查询日线、周线和月线？

用 `period` 选择周期。`daily` 是日线，`weekly` 是周线，`monthly` 是月线。不传时默认日线。查询不同周期时，分别发起请求。

怎么查询超过 3660 个自然日的历史行情？

`beginDate` 和 `endDate` 都按 `yyyyMMdd` 填写，结束日期与开始日期的间隔最多 3660 个自然日。查更长区间时，可以分段请求。合并结果时，可在同一周期和复权口径下按 `Symbol` 和 `TimeKey` 去重。

未复权、前复权和后复权有什么区别？

`adjust` 留空时返回未复权价格，用于查看当时的成交价格。`pre` 是前复权，以近期价格为基准调整历史价格。`after` 是后复权，以较早价格为基准调整后续价格。比较同一只股票的历史价格时，建议统一复权口径。

一次能查几只股票？怎么区分返回的数据？

`symbol` 可以传最多 10 个股票代码，用逗号分隔，例如 `600036,000001`。六位代码要保留前导零。多只股票共用同一组起止日期、周期和复权参数，返回后可按 `Data[].Symbol` 分组。

为什么日线会缺少某些日期？当天行情什么时候可查？

日线按实际交易记录返回。周末、休市日和股票停牌日可能没有记录，当天日线在收盘后更新。可以用 `Data[].TimeKey` 核对实际返回的日期。若业务状态码为 `100` 且 `Data` 为空数组，表示本次查询成功但该区间没有可返回的行情。

Demo 和正式接口有什么区别？

Demo 无需 AppKey，供接口测试和开发调试使用，返回与正式接口一致的数据结构。Demo 返回招商银行（`600036`）的日线样例。查询指定股票、日期区间、周期或复权行情时，使用正式接口和对应的 AppKey。

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"symbol=600036\u0026beginDate=20260930\u0026endDate=20261030\u0026adjust=\u0026period=daily","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-11-02 17:23:02.660","DataTotalCount":18},"Data":[{"TimeKey":20260930,"Symbol":"600036","StockName":"招商银行","Open":40.590000152587891,"Close":41.2599983215332,"High":41.380001068115234,"Low":40.520000457763672,"TradingVolume":699871,"TradingAmount":2878465024,"Swing":2.119999885559082,"ChangePercent":1.8500000238418579,"ChangeAmount":0.75,"TurnoverRate":0.34000000357627869},{"TimeKey":20261008,"Symbol":"600036","StockName":"招商银行","Open":41.2599983215332,"Close":41.709999084472656,"High":41.830001831054688,"Low":41,"TradingVolume":642424,"TradingAmount":2673146112,"Swing":2.0099999904632568,"ChangePercent":1.0900000333786011,"ChangeAmount":0.44999998807907104,"TurnoverRate":0.31000000238418579},{"TimeKey":20261009,"Symbol":"600036","StockName":"招商银行","Open":41.720001220703125,"Close":41.419998168945313,"High":42.090000152587891,"Low":41.419998168945313,"TradingVolume":861924,"TradingAmount":3607539200,"Swing":1.6100000143051147,"ChangePercent":-0.699999988079071,"ChangeAmount":-0.28999999165534973,"TurnoverRate":0.41999998688697815},{"TimeKey":20261012,"Symbol":"600036","StockName":"招商银行","Open":41.560001373291016,"Close":42.7599983215332,"High":42.7599983215332,"Low":41.520000457763672,"TradingVolume":1028564,"TradingAmount":4364044288,"Swing":2.9900000095367432,"ChangePercent":3.2400000095367432,"ChangeAmount":1.3400000333786011,"TurnoverRate":0.5},{"TimeKey":20261013,"Symbol":"600036","StockName":"招商银行","Open":42.659999847412109,"Close":42.799999237060547,"High":42.950000762939453,"Low":42.5,"TradingVolume":794213,"TradingAmount":3393863168,"Swing":1.0499999523162842,"ChangePercent":0.090000003576278687,"ChangeAmount":0.039999999105930328,"TurnoverRate":0.38999998569488525},{"TimeKey":20261014,"Symbol":"600036","StockName":"招商银行","Open":42.610000610351563,"Close":42.669998168945313,"High":42.939998626708984,"Low":42.470001220703125,"TradingVolume":590702,"TradingAmount":2521262336,"Swing":1.1000000238418579,"ChangePercent":-0.30000001192092896,"ChangeAmount":-0.12999999523162842,"TurnoverRate":0.28999999165534973},{"TimeKey":20261015,"Symbol":"600036","StockName":"招商银行","Open":42.7400016784668,"Close":42.659999847412109,"High":42.849998474121094,"Low":42.119998931884766,"TradingVolume":950418,"TradingAmount":4043592448,"Swing":1.7100000381469727,"ChangePercent":-0.019999999552965164,"ChangeAmount":-0.0099999997764825821,"TurnoverRate":0.46000000834465027},{"TimeKey":20261016,"Symbol":"600036","StockName":"招商银行","Open":42.599998474121094,"Close":42.450000762939453,"High":42.7400016784668,"Low":41.919998168945313,"TradingVolume":840913,"TradingAmount":3560858368,"Swing":1.9199999570846558,"ChangePercent":-0.49000000953674316,"ChangeAmount":-0.20999999344348907,"TurnoverRate":0.40999999642372131},{"TimeKey":20261019,"Symbol":"600036","StockName":"招商银行","Open":42.299999237060547,"Close":43.049999237060547,"High":43.159999847412109,"Low":42.150001525878906,"TradingVolume":732050,"TradingAmount":3139526400,"Swing":2.380000114440918,"ChangePercent":1.4099999666213989,"ChangeAmount":0.60000002384185791,"TurnoverRate":0.34999999403953552},{"TimeKey":20261020,"Symbol":"600036","StockName":"招商银行","Open":42.950000762939453,"Close":42.520000457763672,"High":43.130001068115234,"Low":42.180000305175781,"TradingVolume":760948,"TradingAmount":3235055104,"Swing":2.2100000381469727,"ChangePercent":-1.2300000190734863,"ChangeAmount":-0.52999997138977051,"TurnoverRate":0.37000000476837158},{"TimeKey":20261021,"Symbol":"600036","StockName":"招商银行","Open":42.599998474121094,"Close":42.279998779296875,"High":42.599998474121094,"Low":42,"TradingVolume":748180,"TradingAmount":3157692672,"Swing":1.4099999666213989,"ChangePercent":-0.56000000238418579,"ChangeAmount":-0.23999999463558197,"TurnoverRate":0.36000001430511475},{"TimeKey":20261022,"Symbol":"600036","StockName":"招商银行","Open":41.869998931884766,"Close":41.819999694824219,"High":42.299999237060547,"Low":41.450000762939453,"TradingVolume":989244,"TradingAmount":4140322816,"Swing":2.0099999904632568,"ChangePercent":-1.0900000333786011,"ChangeAmount":-0.46000000834465027,"TurnoverRate":0.47999998927116394},{"TimeKey":20261023,"Symbol":"600036","StockName":"招商银行","Open":41.700000762939453,"Close":41.770000457763672,"High":42.380001068115234,"Low":41.419998168945313,"TradingVolume":1232174,"TradingAmount":5160869888,"Swing":2.2999999523162842,"ChangePercent":-0.11999999731779099,"ChangeAmount":-0.05000000074505806,"TurnoverRate":0.60000002384185791},{"TimeKey":20261026,"Symbol":"600036","StockName":"招商银行","Open":41.4900016784668,"Close":42.5,"High":42.5,"Low":41.430000305175781,"TradingVolume":951383,"TradingAmount":3999528448,"Swing":2.559999942779541,"ChangePercent":1.75,"ChangeAmount":0.73000001907348633,"TurnoverRate":0.46000000834465027},{"TimeKey":20261027,"Symbol":"600036","StockName":"招商银行","Open":42.299999237060547,"Close":42.9900016784668,"High":43.060001373291016,"Low":42.040000915527344,"TradingVolume":867283,"TradingAmount":3702086144,"Swing":2.4000000953674316,"ChangePercent":1.1499999761581421,"ChangeAmount":0.49000000953674316,"TurnoverRate":0.41999998688697815},{"TimeKey":20261028,"Symbol":"600036","StockName":"招商银行","Open":42.5099983215332,"Close":42.130001068115234,"High":42.680000305175781,"Low":41.849998474121094,"TradingVolume":1077899,"TradingAmount":4553406464,"Swing":1.9299999475479126,"ChangePercent":-2,"ChangeAmount":-0.86000001430511475,"TurnoverRate":0.51999998092651367},{"TimeKey":20261029,"Symbol":"600036","StockName":"招商银行","Open":42.5,"Close":42.939998626708984,"High":43.029998779296875,"Low":42.090000152587891,"TradingVolume":1087494,"TradingAmount":4649048576,"Swing":2.2300000190734863,"ChangePercent":1.9199999570846558,"ChangeAmount":0.81000000238418579,"TurnoverRate":0.52999997138977051},{"TimeKey":20261030,"Symbol":"600036","StockName":"招商银行","Open":43.290000915527344,"Close":43.549999237060547,"High":43.549999237060547,"Low":42.799999237060547,"TradingVolume":1027158,"TradingAmount":4441650176,"Swing":1.75,"ChangePercent":1.4199999570846558,"ChangeAmount":0.61000001430511475,"TurnoverRate":0.5}]}

🟠400业务码 501：参数缺失、非法、重复或冲突。

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

业务说明

返回契约

业务状态与 HTTP 状态

常见问题

怎么查询日线、周线和月线？

怎么查询超过 3660 个自然日的历史行情？

未复权、前复权和后复权有什么区别？

一次能查几只股票？怎么区分返回的数据？

为什么日线会缺少某些日期？当天行情什么时候可查？

Demo 和正式接口有什么区别？

请求参数

请求示例代码

返回响应

[DEMO] A 股历史行情数据

业务说明#

返回契约#

业务状态与 HTTP 状态#

常见问题#

怎么查询日线、周线和月线？#

怎么查询超过 3660 个自然日的历史行情？#

未复权、前复权和后复权有什么区别？#

一次能查几只股票？怎么区分返回的数据？#

为什么日线会缺少某些日期？当天行情什么时候可查？#

Demo 和正式接口有什么区别？#

请求参数

请求示例代码

返回响应

业务说明

返回契约

业务状态与 HTTP 状态

常见问题

怎么查询日线、周线和月线？

怎么查询超过 3660 个自然日的历史行情？

未复权、前复权和后复权有什么区别？

一次能查几只股票？怎么区分返回的数据？

为什么日线会缺少某些日期？当天行情什么时候可查？

Demo 和正式接口有什么区别？