港股数据

港股数据:从恒指成分,到南下资金持仓

港股研究的链条比 A 股更长:先要知道有哪些票(恒指/国企/恒科成分),再看单只的基本面与机构态度,最后看资金——谁在买(南下持仓)、谁在做空(卖空比率)。这 22 个入口覆盖了整条链。

一句话说清

港股数据 = 恒指体系(成分/行情)+ 单只基本面(财务/股东/分红)+ 机构态度(评级/目标价/一致预期)+ 资金面(南下持仓/卖空/个股资金流)。四条链缺一条,结论就站不住。

按你要回答的问题选入口

不用一个接口硬凑——港股能查的有 22 个入口,下面是最常用的四类:

「港股有哪些票 / 恒指成分是什么?」
/v1/index-constituent · /v1/index-list · /v1/screen?market=hk
恒生指数 / 国企指数 / 恒生科技成分股(各 20 只);1223 个指数的清单;港股排行与筛选
「这家公司怎么样?」
/v1/finance · /v1/shareholder · /v1/dividend · /v1/profile
财务三表、股东研究、分红派息、公司简况
「机构怎么看?」
目标价均值/最高/最低 + 评级分布(买入 45 / 中性 2 / 卖出 1)+ 覆盖机构数;未来 EPS / 营收 / 利润预测
「资金在做什么?」
主力与散户买卖净额;港股通南下季度持仓与占比;每日卖空比率

⇒ 还有:/v1/quote 报价 · /v1/kline K 线 · /v1/minute 分时 · /v1/technical 55 项技术指标 · /v1/news 新闻 · /v1/notice 公告 · /v1/calendar 事件日历 · /v1/ipo 新股 · /v1/search 搜索 · /v1/suspension 停复牌 · /v1/disclosure 财报披露日 · /v1/buyback 回购。

22 个入口(按用途)

港股可用端点一览,括号内为最低档位:

行情
/v1/quote · /v1/kline · /v1/minute · /v1/technical
⚠️ 港股 K 线不支持日期范围,用 count
基本面
/v1/finance · /v1/profile · /v1/shareholder · /v1/dividend
报表期次与字段口径以返回为准
机构态度
/v1/rating(港美股专属)· /v1/consensus
⚠️ 港股一致预期没有目标价,只有 *Forecast 一套
资金 / 卖空
⚠️ 卖空必须传 date;南下是季度持仓
事件
/v1/calendar · /v1/disclosure · /v1/ipo · /v1/suspension
港股事件密度远高于 A 股(实测一只 151 条)
指数
⚠️ 港股成分股字段是中文键(代码/名称/涨跌幅/成交额)
筛选
/v1/screen?market=hk
⚠️ 港美股 PE 字段是 PeTTM(大小写敏感)
公司行为 / 资讯
/v1/buyback · /v1/news · /v1/notice · /v1/search
回购:港股是逐日明细,A 股是事件概要

四条能直接跑的例子

免费端点(/v1/quote、/v1/kline)无需 Key;其余需标准版或专业版。港股代码是 5 位:hk00700。

# ① 恒生科技指数成分股(20 只)
curl "https://api.ashareapi.com/v1/index-constituent?code=hkHSTECH&key=$KEY"

# ② 机构评级:目标价与评级分布
curl "https://api.ashareapi.com/v1/rating?codes=hk00700&key=$KEY"

# ③ 卖空数据(⚠️ 必须传 date)
curl "https://api.ashareapi.com/v1/fund-short?code=hk00700&date=2026-10-15&key=$KEY"

# ④ 港股通南下持仓(季度)
curl "https://api.ashareapi.com/v1/fund-south?codes=hk00700&key=$KEY"

⚠️ 港股财务与 A 股字段口径不同,⛔ 别按 A 股列名硬解析;港股一致预期没有 targetPrice,只有预测项。

Agent 拿这一页就能用

接成 MCP 工具后,Agent 可以直接答这些问题:

「恒生科技有哪些成分股」
ashare_index_constituent(code="hkHSTECH")
一次只查 1 个指数
「腾讯的机构目标价多少」
ashare_rating(codes="hk00700")
目标价在 targetPriceAvg,样本 49 家
「腾讯被做空多少」
ashare_fund_short(code="hk00700", date="2026-10-15")
⚠️ 不传 date 只回标识字段
「南下资金持有腾讯多少」
ashare_fund_south(codes="hk00700")
季度口径,占比看 持有比例(%)
「主力今天在买还是卖」
ashare_fund_flow(code="hk00700")
MainNetFlow 单位是港元/元
「港股什么时候出财报」
ashare_disclosure(codes="hk00700")
⚠️ 港股日期常在 disclosureDesc 文案里
「腾讯的 PE 多少」
ashare_screen(mode="condition", asset=?) ⛔
港股不走因子筛选;用 /v1/finance 或行情自带字段

⚠️ Agent 的四条纪律:① 港股代码 5 位(hk00700);② /v1/fund 查不了港股(A 股综合口径),要用 /v1/fund-flow;③ /v1/chip、/v1/sector、/v1/hot、/v1/lhb 不支持港股;④ /v1/rating 只收港美股,A 股会 422。

边界先说清(7 条,省你试错)

这些是数据本身的限制,不是接口没做好:

筹码分布不支持港股

/v1/chip 只覆盖沪深 A 股。港股的持仓成本类数据没有替代口径。

港股 K 线不支持日期范围

只能用 count 取最近 N 根;A 股才支持 start/end。

「港股通持股(A股口径)」不适用

/v1/fund 是 A 股综合口径(龙虎榜/大宗/两融),传港股会 422 —— 港股资金面请用 fund-flow / fund-south / fund-short。

卖空数据要传 date

不传且当日数据未发布时,只返回 code/name/EndDate/ClosePrice 四个标识字段。

港股一致预期没有目标价

/v1/consensus 对港股只给 epsForecast / netProfitForecast / peRatioForecast 等一整套预测,targetPrice 为 null。目标价请用 /v1/rating。

港股指数成分字段是中文键

A 股指数返回 code/name/IndexName;港股返回 代码/名称/涨跌幅/成交额,⛔ 不能按同一套键名解析。

港股 K 线全历史拿不到

受 1212 条上限约束;A 股全历史请用 /v1/kline-full,但那不含港股。

常见问题

港股代码怎么写?

5 位数字 + hk 前缀:腾讯 hk00700、美团 hk03690。与 A 股 6 位(sh600519)不同;不确定代码先用 /v1/search。

能一次查多只港股吗?

资金面可以:/v1/fund-south、/v1/rating、/v1/consensus 支持逗号多只。但 /v1/index-constituent 一次只能 1 个指数(逗号会返回空)。

港股的 PE 字段为什么报错?

港美股是 PeTTM(大小写敏感),A 股才是 PE_TTM —— 用 /v1/screen?market=hk 时注意。

免费能查港股吗?

/v1/quote、/v1/kline、/v1/hot 免费端点可直接查港股行情;财务、评级、资金、指数等需标准版(¥29.9)或专业版(¥99)。

港股资金流「开盘前为 0」是没数据吗?

不是。部分资金字段在开盘前为 0 是正常现象,盘中会恢复。

用一只港股试一下

/v1/quote 与 /v1/kline 免费无需 Key;评级、资金、指数成分需付费档。