港股数据:从恒指成分,到南下资金持仓
港股研究的链条比 A 股更长:先要知道有哪些票(恒指/国企/恒科成分),再看单只的基本面与机构态度,最后看资金——谁在买(南下持仓)、谁在做空(卖空比率)。这 22 个入口覆盖了整条链。
港股数据 = 恒指体系(成分/行情)+ 单只基本面(财务/股东/分红)+ 机构态度(评级/目标价/一致预期)+ 资金面(南下持仓/卖空/个股资金流)。四条链缺一条,结论就站不住。
按你要回答的问题选入口
不用一个接口硬凑——港股能查的有 22 个入口,下面是最常用的四类:
| 你要回答的问题 | 入口 | 拿到什么 |
|---|---|---|
| 「港股有哪些票 / 恒指成分是什么?」 | /v1/index-constituent · /v1/index-list · /v1/screen?market=hk | 恒生指数 / 国企指数 / 恒生科技成分股(各 20 只);1223 个指数的清单;港股排行与筛选 |
| 「这家公司怎么样?」 | /v1/finance · /v1/shareholder · /v1/dividend · /v1/profile | 财务三表、股东研究、分红派息、公司简况 |
| 「机构怎么看?」 | /v1/rating · /v1/consensus | 目标价均值/最高/最低 + 评级分布(买入 45 / 中性 2 / 卖出 1)+ 覆盖机构数;未来 EPS / 营收 / 利润预测 |
| 「资金在做什么?」 | /v1/fund-flow · /v1/fund-south · /v1/fund-short | 主力与散户买卖净额;港股通南下季度持仓与占比;每日卖空比率 |
⇒ 还有:/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 一套 |
| 资金 / 卖空 | /v1/fund-flow · /v1/fund-south · /v1/fund-short | ⚠️ 卖空必须传 date;南下是季度持仓 |
| 事件 | /v1/calendar · /v1/disclosure · /v1/ipo · /v1/suspension | 港股事件密度远高于 A 股(实测一只 151 条) |
| 指数 | /v1/index-constituent · /v1/index-list | ⚠️ 港股成分股字段是中文键(代码/名称/涨跌幅/成交额) |
| 筛选 | /v1/screen?market=hk | ⚠️ 港美股 PE 字段是 PeTTM(大小写敏感) |
| 公司行为 / 资讯 | /v1/buyback · /v1/news · /v1/notice · /v1/search | 回购:港股是逐日明细,A 股是事件概要 |
/v1/screen?market=hkPeTTM(大小写敏感)四条能直接跑的例子
免费端点(/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 可以直接答这些问题:
| 用户这么问 | 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 或行情自带字段 |
ashare_index_constituent(code="hkHSTECH")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 文案里⚠️ 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 股。港股的持仓成本类数据没有替代口径。
只能用 count 取最近 N 根;A 股才支持 start/end。
/v1/fund 是 A 股综合口径(龙虎榜/大宗/两融),传港股会 422 —— 港股资金面请用 fund-flow / fund-south / fund-short。
不传且当日数据未发布时,只返回 code/name/EndDate/ClosePrice 四个标识字段。
/v1/consensus 对港股只给 epsForecast / netProfitForecast / peRatioForecast 等一整套预测,targetPrice 为 null。目标价请用 /v1/rating。
A 股指数返回 code/name/IndexName;港股返回 代码/名称/涨跌幅/成交额,⛔ 不能按同一套键名解析。
受 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 个指数(逗号会返回空)。
港美股是 PeTTM(大小写敏感),A 股才是 PE_TTM —— 用 /v1/screen?market=hk 时注意。
不是。部分资金字段在开盘前为 0 是正常现象,盘中会恢复。