API 文档
接口地址: https://api.gugudata.com/stock/cn
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/stock/cn?appkey=YOUR_APPKEY&symbol=600036&beginDate=20261001&endDate=20261031&adjust=&period=daily
数据预览: https://www.gugudata.com/preview/stockcn
接口测试: https://api.gugudata.com/stock/cn/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
前置接口说明: 查询 A 股股票代码列表数据,支持分页查询
前置接口地址: https://api.gugudata.com/stock/cnsymbols?appkey=YOUR_APPKEY&pageindex=1&pagesize=20
前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量,最大 20 条(超过 20 将返回参数错误)
前置接口返回格式: application/json; charset=utf-8
前置接口返回说明: 包含股票编码、股票名称、股票中文名称
前置接口请求方式: GET
前置接口请求协议: HTTPS
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
付费开通本接口后,在开发者中心获取的 AppKey,用于验证接口调用权限。可通过请求头 X-GUGUDATA-APPKEY、X-API-Key、Authorization(Bearer)或查询参数 appkey 传递。 |
| symbol |
string |
是 |
无 |
A 股股票代码,具体值参见 A 股股票代码参数枚举页面。支持逗号分隔的多只股票(兼容中文逗号),去重后每次最多 10 只,例如 600036,000001。保留六位代码的前导零。支持 sh600031、sz000001、bj430047 等带交易所前缀的写法,接口会统一为六位代码。 |
| beginDate |
string |
是 |
无 |
查询起始日期,按 yyyyMMdd 填写,例如 20261001。起始日期不能晚于结束日期。该日期用于限定查询区间,日线只返回区间内有行情记录的交易日。 |
| endDate |
string |
是 |
无 |
查询结束日期,按 yyyyMMdd 填写,例如 20261031。与 beginDate 的间隔最多为 3660 个自然日。查询更长区间时请按日期分批,并控制请求频率。 |
| adjust |
string |
否 |
无 |
价格复权方式。不传或留空时返回未复权行情。pre 表示前复权,after 表示后复权。开盘、收盘、最高和最低价按所选口径返回。传入其他非空值会返回参数错误。 |
| period |
string |
否 |
daily |
行情周期。不传或留空时默认 daily(日线),也可选 weekly(周线)或 monthly(月线)。每条记录对应所选周期内的一根 K 线。传入其他非空值会返回参数错误。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
接口实际使用的查询参数摘要,包含股票代码、起止日期、复权方式和行情周期,不包含 AppKey。Demo 返回固定样例的查询条件。 |
| DataStatus.StatusCode |
integer |
业务状态码。100 表示查询成功,其他值请结合 HTTP 状态与 StatusDescription 判断。 |
| DataStatus.StatusDescription |
string |
业务状态的文字说明。出错时可结合 StatusCode 定位原因。 |
| DataStatus.ResponseDateTime |
string |
服务端生成响应的时间,格式为 yyyy-MM-dd HH:mm:ss.fff。 |
| DataStatus.DataTotalCount |
integer |
本次 Data 数组实际返回的记录数。查询多只股票时计入所有股票的记录。 |
| Data.TimeKey |
integer |
该条行情对应的日期,使用 yyyyMMdd 格式的整数,例如 20261030。日线为交易日,周线和月线为行情记录标注的周期日期。 |
| Data.Symbol |
string |
当前行情记录所属的六位 A 股股票代码,以字符串返回并保留前导零。批量查询时可用此字段按股票分组。 |
| Data.StockName |
string |
股票名称,用于展示和核对股票代码。 |
| Data.Open |
number |
所选周期内的开盘价,单位为元,按 adjust 指定的复权口径返回。 |
| Data.Close |
number |
所选周期内的收盘价,单位为元,按 adjust 指定的复权口径返回。 |
| Data.High |
number |
所选周期内的最高价,单位为元,按 adjust 指定的复权口径返回。 |
| Data.Low |
number |
所选周期内的最低价,单位为元,按 adjust 指定的复权口径返回。 |
| Data.TradingVolume |
integer |
成交量,单位为手(1 手 = 100 股) |
| Data.TradingAmount |
number |
所选周期内的成交金额合计,单位为元。 |
| Data.Swing |
number |
所选周期内的价格振幅,单位为百分比。例如 2.5 表示振幅为 2.5%。 |
| Data.ChangePercent |
number |
所选周期内的涨跌幅,单位为百分比。正值表示上涨,负值表示下跌,例如 -1.2 表示下跌 1.2%。 |
| Data.ChangeAmount |
number |
所选周期内的涨跌额,单位为元。正值表示价格上涨,负值表示价格下跌。 |
| Data.TurnoverRate |
number |
所选周期内的换手率,单位为百分比。例如 0.34 表示换手率为 0.34%。 |
仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。
{
"DataStatus": {
"RequestParameter": "symbol=600036&beginDate=20260930&endDate=20261030&adjust=&period=daily",
"StatusCode": 100,
"StatusDescription": "请求成功",
"ResponseDateTime": "2026-11-02 15:26:50.644",
"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
}
]
}