Hong Kong Stock Data API

Access real-time Hong Kong Stock market data via Infoway API. Get live quotes, candlestick, trade ticks, order books, and fundamentals for over 4,000 HK stocks.

Overview

The Infoway Hong Kong Stock Real-Time Market Data API provides comprehensive coverage of over 4,000 Hong Kong-listed companies, offering live market data to help users monitor market movements and make timely trading decisions.

1. Get the Hong Kong Stock List

Infoway API supports queries for all listed Hong Kong stocks (over 4,000 tickers). You can obtain the list in two ways:

Option 1 — Download from the Web Portal

Log in to your Infoway account and download the latest stock excel list file from the Downloads section at the right side of the dashboard.

Option 2 — Query via API

You can also retrieve the list programmatically through the HTTP Symbol List API. Refer to the GET /symbol-list documentation for usage details.

The stock list is updated periodically to include newly listed companies and remove delisted securities. To ensure your application always reflects the latest market data, it is recommended to refresh the list regularly.

2. Query Methods

Infoway offers two primary data-access methods, optimized for different use cases:

Method	Ideal Use Case	Description
HTTP API	Scheduled or batch data queries	Flexible pull-based access to company fundamentals, historical quotes, real-time candlesticks, and order book data.
WebSocket Streaming	Low-latency, real-time monitoring	Push-based streaming for the fastest access to live market updates.

Both HTTP and WebSocket interfaces are subject to rate limits. See the Rate Limit Policy section for detailed constraints.

3. Market Data Schemas

The Infoway Hong Kong Stock Real-Time Market Data API supports multiple categories of data feeds.

3.1 Real-Time Candlestick (OHLCV) Data

Provides live candlestick data for Hong Kong stocks, including open, high, low, close, volume, turnover, price change percentage, and absolute change.

You can access data via:

• HTTP Request: see GET /candlestick

• WebSocket Subscription: see WebSocket /candlestick topic

Example Response

{
  "s": "00005.HK",
  "respList": [
    {
      "t": "1752825540",
      "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 Latest Trade

Query the latest trade details for Hong Kong-listed companies to stay up-to-date with market activity.

Access methods:

• HTTP API: GET /trades

• WebSocket: Subscribe to /trades

Example Response

{
  "s": "00005.HK",
  "t": 1752826113546,
  "p": "98.150",
  "v": "956000",
  "vw": "93831400.000",
  "td": 0
}

3.3 Level-10 Order Book (Market Depth)

The Infoway API provides Level-10 order book data for Hong Kong equities, enabling users to analyze market depth and liquidity.

Access methods:

• HTTP API: GET /market-depth

• WebSocket: Subscribe to /Depth

Example Response

{
  "s": "00005.HK",
  "t": 1752826121043,
  "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 Hong Kong Stock Fundamentals

Retrieve fundamental information for listed companies, including corporate names, share structure, exchange details, and key financial indicators. (GET / symbol-fundamentals)

Example Response

{
  "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 Trading Days & Market Hours

Retrieve trading session schedules and trading calendar information for the Hong Kong Stock market. This ensures your system is synchronized with market open/close times and holiday periods.

Query Methods

• GET /trading-hours — Returns daily trading sessions and their start/end times

• GET /trading-days — Returns valid trading days and half-days

Example: Trading Hours

{
  "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"
    }
  ]
}

Example: Trading Days

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