港股实时行情接口

所有港股实时交易行情数据

部分行情数值未提供时以 0 占位，不代表实际数值为 0。

GET /stock/hk/realtime

业务说明

支持所有港股实时交易数据查询（合规要求，数据延迟最多 15 分钟）；

包含港股实时交易多项指标数据；

毫秒级查询性能；

支持传递港股代码，筛选某一支港股的实时交易数据；

全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；

全面兼容 Apple ATS；

全国多节点 CDN 部署；

接口极速响应，多台服务器构建 API 接口负载均衡。

鉴权：需要 AppKey，使用本操作声明的鉴权位置。

请求参数

参数	位置	类型	必填	真实默认值	说明
appkey	query	string	否	无	付费后获取的 APPKEY
symbol	query	string	否	无	默认不传递或传递空值，则获取所有港股的实时交易数据。支持传递单个港股股票代码进行筛选，具体值参见港股股票代码参数枚举页面

独立请求示例

{
  "symbol": "00012"
}

返回契约

HTTP 200：业务码 100 成功。
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": "港股股票代码"
          },
          "StockName": {
            "type": "string",
            "description": "股票名称"
          },
          "Latest": {
            "type": "number",
            "description": "最新价，单位：港元"
          },
          "ChangeAmount": {
            "type": "number",
            "description": "涨跌额，单位：港元"
          },
          "ChangePercent": {
            "type": "number",
            "description": "涨跌幅，单位：%"
          },
          "Open": {
            "type": "number",
            "description": "开盘价，单位：港元"
          },
          "High": {
            "type": "number",
            "description": "最高，单位：港元"
          },
          "Low": {
            "type": "number",
            "description": "最低，单位：港元"
          },
          "PreClose": {
            "type": "number",
            "description": "昨收价，单位：港元"
          },
          "TradingVolume": {
            "type": "integer",
            "format": "int64",
            "description": "成交量，单位：股"
          },
          "TradingAmount": {
            "type": "number",
            "description": "成交额，单位：港元"
          }
        },
        "required": [
          "Symbol",
          "StockName",
          "Latest",
          "ChangeAmount",
          "ChangePercent",
          "Open",
          "High",
          "Low",
          "PreClose",
          "TradingVolume",
          "TradingAmount"
        ],
        "description": "按既有顺序返回的行情对象数组。"
      },
      "description": "按既有顺序返回的行情对象数组。"
    }
  }
}

HTTP 400：业务码 501：参数缺失、非法、重复或冲突。
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 503：业务码 901：处理、依赖失败或超时。
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 401：公共鉴权失败；沿用现有公共契约。

HTTP 403：公共权益或额度不足；沿用现有公共契约。

HTTP 429：公共频率限制；沿用现有公共契约。

业务状态与 HTTP 状态

业务码	含义	说明
100	成功	HTTP 200；仍应检查业务状态。
501	参数错误	HTTP 400
901	依赖失败	HTTP 503

接口详情：https://www.gugudata.com/api/details/stockhkrealtime
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json

返回响应

🟢200成功

application/json

业务码 100 成功。

Bodyapplication/json

示例

{"DataStatus":{"RequestParameter":"symbol=01450","StatusCode":100,"StatusDescription":"请求成功","ResponseDateTime":"2026-11-02 17:23:26.523","DataTotalCount":1},"Data":[{"Symbol":"01450","StockName":"交个朋友控股","Latest":0.45500001311302185,"ChangeAmount":0,"ChangePercent":0,"Open":0.45500001311302185,"High":0.45500001311302185,"Low":0.44999998807907104,"PreClose":0.45500001311302185,"TradingVolume":336000,"TradingAmount":152780}]}

🟠400业务码 501：参数缺失、非法、重复或冲突。

🔴503业务码 901：处理、依赖失败或超时。

🟠401公共鉴权失败；沿用现有公共契约。

🟠403公共权益或额度不足；沿用现有公共契约。

🟠429公共频率限制；沿用现有公共契约。

业务说明#

请求参数#

独立请求示例#

返回契约#

业务状态与 HTTP 状态#

请求参数

请求示例代码

返回响应

业务说明

请求参数

独立请求示例

返回契约

业务状态与 HTTP 状态