# 港股实时行情接口

## 1. 获取港股股票清单

Infoway API支持查询港股总计超过4000只股票。您可以通过以下两种方式获取股票清单：

* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](https://docs.infoway.io/rest-api/basic-info/get-symbol-list)。

{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}

## 2. 查询方式

我们为不同需求的用户提供两种高效的查询方式：

| 查询方式        | 适用场景                                                               |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口      | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。                                  |

{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](https://docs.infoway.io/getting-started/api-limitation)。
{% endhint %}

## 3. 支持的数据类型

Infoway 港股实时行情接口提供以下几种数据查询服务：

### 3.1 获取港股实时K线数据

提供实时的港股股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往

* [HTTP请求K线](https://docs.infoway.io/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](https://docs.infoway.io/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。

实时K线返回示例如下：

```
{
  "s": "00005.HK",    //产品代码
  "respList": [
    {
      "t": "1752825540",  //秒时间戳（UTC+8）
      "h": "98.250",    //最高价
      "o": "98.200",    //开盘价
      "l": "98.150",    //最低价
      "c": "98.150",    //收盘价
      "v": "44000",    //成交量
      "vw": "4320240.000",    //成交额
      "pc": "-0.05%",    //涨跌幅
      "pca": "-0.050"    //涨跌额
    }
  ]
}
```

### 3.2 港**股实时成交明细**

查询港股上市公司的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：

* [GET实时成交明细](https://docs.infoway.io/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](https://docs.infoway.io/websocket-api/subscribe-and-unsubscribe/trade-subscribe)

实时成交明细返回示例如下：

```
{
  "s": "00005.HK",    //产品代码
  "t": 1752826113546,    //毫秒时间戳(UTC+8)
  "p": "98.150",    //交易价格
  "v": "956000",    //成交量
  "vw": "93831400.000",    //成交额
  "td": 0    //交易方向 1：BUY 2：SELL 0：默认值
}
```

### 3.3 港股十档**盘口数据**

Infoway API提供港股十档盘口查询，帮助用户了解市场深度和流动性。详细接入步骤请前往：

* [GET查询盘口数据](https://docs.infoway.io/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](https://docs.infoway.io/websocket-api/subscribe-and-unsubscribe/depth-subscribe)

港股十档档盘口返回示例如下：

```
{
  "s": "00005.HK",    //产品代码 
  "t": 1752826121043,    //毫秒时间戳(UTC+8)
  "a": [    //买盘
    [
      "98.150",    //买一价
      "98.200",    //买二价
      "98.250",    //买三价
      "98.300",    //买四价
      "98.350",    //买五价
      "98.400",    //买六价
      "98.450",    //买七价
      "98.500",    //买八价
      "98.550",    //买九价
      "98.600"    //买十价
    ],
    [
      "13200",    //买一量
      "46400",    //买二量
      "58800",    //买三量
      "220800",    //买四量
      "221600",    //买五量
      "545200",    //买六量
      "162000",    //买七量
      "987600",    //买八量
      "230400",    //买九量
      "495200"    //买十量
    ]
  ],
  "b": [    //卖盘
    [
      "98.100",    //卖一价
      "98.050",    //卖二价
      "98.000",    //卖三价
      "97.950",    //卖四价
      "97.900",    //卖五价
      "97.850",    //卖六价
      "97.800",    //卖七价
      "97.750",    //卖八价
      "97.700",    //卖九价
      "97.650"    //卖十价
    ],
    [
      "128800",    //卖一量
      "112000",    //卖二量
      "178000",    //卖三量
      "126400",    //卖四量
      "223600",    //卖五量
      "83200",    //卖六量
      "194800",    //卖七量
      "69600",    //卖八量
      "80400",    //卖九量
      "198000"    //卖十量
    ]
  ]
}


```

### 3.4 港**股股票基础信息**

查询港股上市公司的基础信息，包括公司名称、股票代码、上市日期等。详细了解接入步骤，请前往[这个页面](https://docs.infoway.io/rest-api/basic-info/get-symbol-basic-info)。

股票基础信息返回示例如下：

```
{
  "symbol": "00005.HK",
  "market": "HK",
  "name_cn": "汇丰控股",
  "name_en": "HSBC HOLDINGS",
  "name_hk": "滙豐控股",
  "exchange": "SEHK",
  "currency": "HKD",
  "lot_size": 400,
  "total_shares": 17448265603,
  "circulating_shares": 17448265603,
  "hk_shares": 17448265603,
  "eps": "10.1970581721392237",
  "eps_ttm": "8.7684842825409303",
  "bps": "85.076501878960384",
  "dividend_yield": "5.2748074391180753",
  "stock_derivatives": "Warrant",
  "board": "HKEquity"
}


```

### 3.5 港**股市场交易日和交易时间**

查询港股市场的交易日、交易时间，包括开盘时间、收盘时间等，以确保用户了解每个交易日的市场活动周期。查询方法：

* [查询交易时间](https://docs.infoway.io/rest-api/basic-info/get-market-trading-hours)
* [查询交易日](https://docs.infoway.io/rest-api/basic-info/get-market-trading-days)

交易时间返回示例：

```
{
  "market": "HK",
  "remark": "港股市场",
  "trade_schedules": [
    {
      "begin_time": "09:30:00",
      "end_time": "12:00:00",
      "type": "NormalTrade"
    },
    {
      "begin_time": "13:00:00",
      "end_time": "16:00:00",
      "type": "NormalTrade"
    }
  ]
}

```

交易日返回示例：

```
{
  "trade_days": [
    "20250102",
    "20250103",
    "20250106",
    "20250107",
    "20250108",
    "20250109",
    "20250110",
    "20250113",
    "20250114",
    "20250115"
  ],
  "half_trade_days": []
}
```