API 文档
接口地址: https://api.gugudata.com/stock/hk
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/stock/hk?appkey=YOUR_APPKEY&symbol=00012&beginDate=20261019&endDate=20261023&adjust=pre
数据预览: https://www.gugudata.com/preview/stockhk
接口测试: https://api.gugudata.com/stock/hk/demo
OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
前置接口说明: 查询港股股票代码列表数据,支持分页查询
前置接口地址: https://api.gugudata.com/stock/hksymbols?appkey=YOUR_APPKEY&pageindex=1&pagesize=20
前置接口参数说明: appkey=YOUR_APPKEY&pageindex=第几页&pagesize=每页返回数量,最大 20 条
前置接口返回格式: application/json; charset=utf-8
前置接口返回说明: 包含股票编码、股票名称、股票中文名称
前置接口请求方式: GET
前置接口请求协议: HTTPS
| 参数名 |
参数类型 |
是否必须 |
默认值 |
备注 |
| appkey |
string |
是 |
无 |
付费后获取的 APPKEY。 |
| symbol |
string |
是 |
无 |
港股股票代码,通常为 5 位数字代码,例如 00700。 仅展示当前有效代码,历史代码仍可用于已支持的历史数据查询。 |
| beginDate |
string |
是 |
无 |
查询开始日期,格式 yyyyMMdd;与 endDate 最大间隔为 366 天。 |
| endDate |
string |
是 |
无 |
查询结束日期,格式 yyyyMMdd;与 beginDate 最大间隔为 366 天。 |
| adjust |
string |
否 |
无 |
复权类型,可为空;按所选复权口径返回。 |
| 参数名 |
参数类型 |
备注 |
| DataStatus.RequestParameter |
string |
本次实际业务请求参数,不包含鉴权凭据;Demo 展示对应样例输入。 |
| DataStatus.StatusCode |
integer |
接口返回状态码。 |
| DataStatus.StatusDescription |
string |
接口返回状态说明。 |
| DataStatus.ResponseDateTime |
string |
接口数据返回时间。 |
| DataStatus.DataTotalCount |
integer |
此条件下的数据总量;对象型结果通常为 1,列表型结果为列表数量或分页总数。 |
| Data |
array |
历史行情对象数组;合法无记录时为空数组。 |
| Data.TimeKey |
integer |
交易日期。 |
| Data.Symbol |
string |
股票代码。 |
| Data.Open |
number |
开盘价。 |
| Data.Close |
number |
收盘价。 |
| Data.High |
number |
最高价。 |
| Data.Low |
number |
最低价。 |
| Data.TradingVolume |
integer |
成交量。 |
| Data.TradingAmount |
number |
成交额。 |
| Data.Swing |
number |
振幅,单位:%。 |
| Data.ChangePercent |
number |
涨跌幅,单位:%。 |
| Data.ChangeAmount |
number |
涨跌额。 |
| Data.TurnoverRate |
number |
换手率,单位:%。 |
仅展示部分示例数据,数组最多展示 3 项,长内容已省略;完整数据请调用接口获取。
{
"DataStatus": {
"RequestParameter": "symbol=00012&beginDate=20260930&endDate=20261030&adjust=pre",
"StatusCode": 100,
"StatusDescription": "请求成功",
"ResponseDateTime": "2026-11-02 15:27:14.207",
"DataTotalCount": 21
},
"Data": [
{
"TimeKey": 20260930,
"Symbol": "00012",
"Open": 26.36,
"Close": 26.74,
"High": 26.76,
"Low": 26.14,
"TradingVolume": 11176094,
"TradingAmount": 297654816,
"Swing": 2.35,
"ChangePercent": 1.44,
"ChangeAmount": 0.38,
"TurnoverRate": 0.23
},
{
"TimeKey": 20261002,
"Symbol": "00012",
"Open": 26.6,
"Close": 25.98,
"High": 26.6,
"Low": 25.76,
"TradingVolume": 10414400,
"TradingAmount": 271446288,
"Swing": 3.14,
"ChangePercent": -2.84,
"ChangeAmount": -0.76,
"TurnoverRate": 0.22
},
{
"TimeKey": 20261005,
"Symbol": "00012",
"Open": 25.98,
"Close": 25.5,
"High": 25.98,
"Low": 25.4,
"TradingVolume": 8945987,
"TradingAmount": 228579473,
"Swing": 2.23,
"ChangePercent": -1.85,
"ChangeAmount": -0.48,
"TurnoverRate": 0.18
}
]
}