@pipeworx/hk-stocks

Connect: https://gateway.pipeworx.io/hk-stocks/mcp · Install: one-click buttons

Tools: 3

Live Hong Kong equity market data — the full Hang Seng index family and real-time HKEX stock quotes, with a name→code resolver that returns the actual share rather than its warrants.

Tools

• hk_market_snapshot() — closing level, change, change %, day range and 52-week range for HSI (恒生指数), HSCEI (恒生中国企业指数, H-shares), HSTECH (恒生科技指数), HSCCI (恒生香港中资企业指数, red chips), and VHSI (恒指波幅指数, volatility). Answers “how did Hong Kong close”.
• hk_quote({ codes }) — real-time quotes by HKEX code. English + Chinese name, price, change, open/prev close, day high/low, share volume, HKD turnover, P/E, 52-week range. Accepts 700, 00700, 0700.HK, HK:700.
• hk_resolve_symbol({ name }) — company name → HKEX code. Handles English and Chinese input.

Auth

Keyless. Both upstreams are public and unauthenticated; no registration, no quota to negotiate.

Data sources

• https://hq.sinajs.cn/list=rt_hkHSI,rt_hk00700 — index levels and equity quotes. GBK-encoded, not UTF-8 — decode from raw bytes (new TextDecoder('gbk')), or every Chinese name arrives as mojibake.
• https://suggest3.sinajs.cn/suggest/type=31&key=腾讯 — name→code for Chinese input.
• https://query1.finance.yahoo.com/v1/finance/search?q=tencent — name→code for Latin input.

Things worth not rediscovering

Neither resolver upstream covers both scripts, which is why there are two.

• Yahoo rejects non-ASCII outright — q=小米 returns HTTP 400, not an empty result set. It cannot answer Chinese queries at all.
• Sina’s HK suggest is a warrant index on Latin input. key=tencent returns TENCENT N4104, TENCENT N6006, TENCENT N3606-R … and never 00700. On Chinese input (key=腾讯) the same endpoint ranks the real equity first. So Sina is used for CJK, Yahoo for Latin, and Yahoo-miss falls back to Sina.

HKEX code ranges do the filtering. Equities and GEM sit below 10000; 10000–69999 are derivative warrants and CBBCs; 80000+ are the RMB counters of dual-counter stocks (80700 is Tencent’s RMB line, not its HKD share). Both are plausible-looking wrong answers to “Tencent’s HK code”, so a single < 10000 threshold excludes both.

Index turnover/volume are deliberately not returned. Sina populates fields 11/12 as HKD turnover and share volume for equities — verifiable, since 36,203,193 shares × ~HK$462 reconciles to the HK$16.76bn turnover it reports. On index rows those slots hold something else: HSI reports 312,233,275 and 14,192,915,767, neither of which reconciles against known HKEX daily market turnover. Rather than relabel a number we cannot account for, the snapshot omits it and says so. Per-stock turnover from hk_quote is sound.

A missing listing returns an empty payload, not an error. Sina answers an unknown code with var hq_str_rt_hk99999=""; — HTTP 200. Callers must treat an empty field list as not-found, or a nonexistent stock silently becomes a quote with null prices.

Tools

• hk_market_snapshot — Hong Kong stock market snapshot — closing levels and daily change for the whole Hang Seng index family: the Hang Seng Index (恒生指数, HSI), Hang Seng China Enterprises Index (恒生中国企业指数, HSCEI, the H-share
• hk_quote — Real-time quote(s) for Hong Kong-listed stocks by HKEX code. Answers ‘Tencent stock price’, ‘腾讯股价’, ‘00700 quote’, ‘HSBC Hong Kong share price’. Accepts one code or a comma-separated list, in any comm
• hk_resolve_symbol — Find the HKEX stock code for a company by name — the lookup step before hk_quote. Answers ‘what is Tencent’s Hong Kong ticker’, ‘Xiaomi HK code’, ‘Alibaba Hong Kong listing’. Returns ONLY Hong Kong-li