31_api_intro_stock_cn_history
A 股历史行情数据 API 接口
所有A股历史交易行情数据，全量历史交易 / 包含前后复权数据。
1. 产品功能
- 支持所有 A 股全量历史（天）交易查询；
- 包含上交所和深交所所有股票数据；
- 每日 A 股收盘后更新当日交易数据，停牌不更新；
- 支持一次查询多个股票历史数据；
- 支持任意时间段查询；
- 超高查询效率，千万级数据毫秒级返回；
- 支持查询所有交易数据的未复权、前复权、后复权数据；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡。
2. API 文档
API 详情地址: https://www.gugudata.com/api/details/stockcn
接口地址: https://api.gugudata.com/stock/cn
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
数据预览: https://www.gugudata.com/preview/stockcn
接口测试: https://api.gugudata.com/stock/cn/demo
前置接口
前置接口说明: 查询 A 股股票代码列表数据，支持分页查询
前置接口地址: https://api.gugudata.com/stock/cnsymbols?appkey=YOUR_APPKEY&pageindex=YOUR_VALUE&pagesize=YOUR_VALUE
前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量，最大 50 条
前置接口返回格式: application/json; charset=utf-8
前置接口返回说明: 包含股票编码、股票名称、股票中文名称
前置接口请求方式: GET
前置接口请求协议: HTTPS
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| symbol | string | 是 | YOUR_VALUE | A股股票代码，具体值参见 A股股票代码参数枚举页面。支持一次查询多个股票，使用逗号隔开，参数格式为：600031,600036 |
| begindate | string | 是 | YOUR_VALUE | 股票交易开始时间，格式为 20200101 |
| enddate | string | 是 | YOUR_VALUE | 股票交易结束时间，格式为 20200101，与开始时间最大时间跨度支持 366 个自然日，获取全量数据请分批获取，数据量较大，请保持合理的请求频率 |
| adjust | string | 否 | 查询前复权、后复权数据，如果传递参数值为 pre，那么返回前复权数据（所有数据进行了前复权）；如果传递参数值为 after，那么返回后复权数据；默认值为空或不传递，返回未复权数据 |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量，一般用于分页计算 |
| Data.TimeKey | int | 交易日期 |
| Data.Symbol | string | A股股票代码 |
| Data.StockName | string | 股票名称 |
| Data.Open | double | 开盘价 |
| Data.Close | double | 收盘价 |
| Data.High | double | 最高 |
| Data.Low | double | 最低 |
| Data.TradingAmount | double | 成交额 ，单位：元 |
| Data.TradingAmount | int | 成交量，单位：股 |
| Data.Swing | double | 振幅，单位：% |
| Data.ChangePercent | double | 涨跌幅 ，单位：% |
| Data.ChangeAmount | double | 涨跌额 ，单位：元 |
| Data.TurnoverRate | double | 换手率 ，单位：% |
