A 股历史行情数据
GET
https://api.gugudata.com/stock/cn
GET /stock/cn业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费开通本接口后，在开发者中心获取的 AppKey，用于验证接口调用权限。可通过请求头 X-GUGUDATA-APPKEY、X-API-Key、Authorization（Bearer）或查询参数 appkey 传递。 |
| symbol | query | string | 是 | 无 | A 股股票代码，具体值参见 A 股股票代码参数枚举页面。支持逗号分隔的多只股票（兼容中文逗号），去重后每次最多 10 只，例如 600036,000001。保留六位代码的前导零。支持 sh600031、sz000001、bj430047 等带交易所前缀的写法，接口会统一为六位代码。 |
| beginDate | query | string | 是 | 无 | 查询起始日期，按 yyyyMMdd 填写，例如 20261001。起始日期不能晚于结束日期。该日期用于限定查询区间，日线只返回区间内有行情记录的交易日。 |
| endDate | query | string | 是 | 无 | 查询结束日期，按 yyyyMMdd 填写，例如 20261031。与 beginDate 的间隔最多为 3660 个自然日。查询更长区间时请按日期分批，并控制请求频率。 |
| adjust | query | string | 否 | 价格复权方式。不传或留空时返回未复权行情。pre 表示前复权，after 表示后复权。开盘、收盘、最高和最低价按所选口径返回。传入其他非空值会返回参 数错误。 | |
| period | query | string | 否 | daily | 行情周期。不传或留空时默认 daily（日线），也可选 weekly（周线）或 monthly（月线）。每条记录对应所选周期内的一根 K 线。传入其他非空值会返回参数错误。 |
独立请求示例
{
"symbol": "600036",
"beginDate": "20261001",
"endDate": "20261031",
"adjust": "",
"period": "daily"
}返回契约
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%。"
}
}
}
}
}
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}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"
}
}
}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 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
常见问题
怎么查询日线、周线和月线？
怎么查询超过 3660 个自然日的历史行情？
未复权、前复权和后复权有什么区别？
一次能查几只股票？怎么区分返回的数据？
为什么日线会缺少某些日期？当天行情什么时候可查？
Demo 和正式接口有什么区别？
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-12 11:39:23