港股分时行情数据
GET
https://api.gugudata.com/stock/hk/stockhkperminute
GET /stock/hk/stockhkperminute业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费后获取的 APPKEY |
| symbol | query | string | 是 | 无 | 支持传递单个港股股票代码进行筛选，如：00012。具体值参见 港股股票代码参数枚举页面 |
| beginDate | query | string | 是 | 无 | 交易开始时间，参数格式为: 2021-01-01 09:00:00 |
| endDate | query | string | 是 | 无 | 交易结束时间，参数格式为: 2021-01-01 09:00:00，与开始时间最大时间跨度支持 366 个自然日（1 分钟数据仅支持 5 日内数据），请注意港股数据有延迟。 |
| period | query | integer | 否 | 5 | 交易数据时间区间，可选时间区间价参数为: 1|5|15|30|60 (分钟)， 其中 1 分钟时间区间交易数据仅返回近 5 个交易日不复权数据 |
| adjust | query | string | 否 | 查询前复权、后复权数据，如果传递参数值为 pre，那么返回前复权数据（所有数据进行了前复权）；如果传递参数值为 after，那么返回后复权数据；默认值为空或不传递，返回未复权数据 |
独立请求示例
{
"symbol": "00700",
"beginDate": "20261030 09:30:00",
"endDate": "20261030 16:00:00",
"period": 5,
"adjust": ""
}返回契约
application/json{
"type": "object",
"required": [
"DataStatus",
"Data"
],
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Symbol": {
"type": "string",
"description": "港股股票代码"
},
"TimeKey": {
"type": "string",
"description": "交易时间"
},
"Open": {
"type": "number",
"description": "开盘价，单位：港元"
},
"Close": {
"type": "number",
"description": "收盘价，单位：港元"
},
"High": {
"type": "number",
"description": "最高，单位：港元"
},
"Low": {
"type": "number",
"description": "最低，单位：港元"
},
"TradingVolume": {
"type": "number",
"description": "成交量\t，单位：股"
},
"TradingAmount": {
"type": "number",
"description": "成交额\t，单位：港元"
},
"Latest": {
"type": "number",
"description": "最新价，单位：港元"
}
},
"required": [
"Symbol",
"TimeKey",
"Open",
"Close",
"High",
"Low",
"TradingVolume",
"TradingAmount",
"Latest"
],
"description": "按来源顺序返回的分钟记录对象数组；来源可提供的时段可能短于请求范围。"
},
"description": "按来源顺序返回的分钟记录对象数组；来源可提供的时段可能短于请求范围。"
}
}
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "按来源顺序返回的分钟记录对象数组；来源可提供的时段可能短于请求范围。"
}
}
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "按来源顺序返回的分钟记录对象数组；来源可提供的时段可能短于请求范围。"
}
}
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数错误 | HTTP 400 |
| 901 | 依赖失败 | HTTP 503 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-03 03:04:17