> Source: https://ashareapi.com/hk-stock/  ·  Markdown version for LLMs / AI agents

港股数据

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

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

## 按你要回答的问题选入口
 不用一个接口硬凑——港股能查的有 22 个入口，下面是最常用的四类：
 |
| | 你要回答的问题 | 入口 | 拿到什么

| | 「港股有哪些票 / 恒指成分是什么？」 | [/v1/index-constituent](/docs/endpoints/index-constituent) · [/v1/index-list](/docs/endpoints/index-list) · `/v1/screen?market=hk` | 恒生指数 / 国企指数 / 恒生科技成分股（各 20 只）；1223 个指数的清单；港股排行与筛选

| | 「这家公司怎么样？」 | [/v1/finance](/docs/endpoints/finance) · `/v1/shareholder` · `/v1/dividend` · `/v1/profile` | 财务三表、股东研究、分红派息、公司简况

| | 「机构怎么看？」 | [/v1/rating](/docs/endpoints/rating) · [/v1/consensus](/docs/endpoints/consensus) | 目标价均值/最高/最低 + 评级分布（买入 45 / 中性 2 / 卖出 1）+ 覆盖机构数；未来 EPS / 营收 / 利润预测

| | 「资金在做什么？」 | [/v1/fund-flow](/docs/endpoints/fund-flow) · [/v1/fund-south](/docs/endpoints/fund-south) · [/v1/fund-short](/docs/endpoints/fund-short) | 主力与散户买卖净额；港股通南下季度持仓与占比；每日卖空比率

 「港股有哪些票 / 恒指成分是什么？」
 [/v1/index-constituent](/docs/endpoints/index-constituent) · [/v1/index-list](/docs/endpoints/index-list) · `/v1/screen?market=hk`
 恒生指数 / 国企指数 / 恒生科技成分股（各 20 只）；1223 个指数的清单；港股排行与筛选

 「这家公司怎么样？」
 [/v1/finance](/docs/endpoints/finance) · `/v1/shareholder` · `/v1/dividend` · `/v1/profile`
 财务三表、股东研究、分红派息、公司简况

 「机构怎么看？」
 [/v1/rating](/docs/endpoints/rating) · [/v1/consensus](/docs/endpoints/consensus)
 目标价均值/最高/最低 + 评级分布（买入 45 / 中性 2 / 卖出 1）+ 覆盖机构数；未来 EPS / 营收 / 利润预测

 「资金在做什么？」
 [/v1/fund-flow](/docs/endpoints/fund-flow) · [/v1/fund-south](/docs/endpoints/fund-south) · [/v1/fund-short](/docs/endpoints/fund-short)
 主力与散户买卖净额；港股通南下季度持仓与占比；每日卖空比率

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

## 22 个入口（按用途）
 港股可用端点一览，括号内为最低档位：
 |
| | 用途 | 端点 | 要点

| | 行情 | [/v1/quote](/docs/endpoints/quote) · [/v1/kline](/docs/endpoints/kline) · `/v1/minute` · `/v1/technical` | ⚠️ 港股 K 线**不支持日期范围**，用 `count`

| | 基本面 | [/v1/finance](/docs/endpoints/finance) · `/v1/profile` · `/v1/shareholder` · `/v1/dividend` | 报表期次与字段口径以返回为准

| | 机构态度 | [/v1/rating](/docs/endpoints/rating)（港美股专属）· [/v1/consensus](/docs/endpoints/consensus) | ⚠️ 港股一致预期**没有目标价**，只有 `*Forecast` 一套

| | 资金 / 卖空 | [/v1/fund-flow](/docs/endpoints/fund-flow) · [/v1/fund-south](/docs/endpoints/fund-south) · [/v1/fund-short](/docs/endpoints/fund-short) | ⚠️ 卖空**必须传 date**；南下是**季度**持仓

| | 事件 | `/v1/calendar` · [/v1/disclosure](/docs/endpoints/disclosure) · `/v1/ipo` · [/v1/suspension](/docs/endpoints/suspension) | 港股事件密度远高于 A 股（实测一只 151 条）

| | 指数 | [/v1/index-constituent](/docs/endpoints/index-constituent) · [/v1/index-list](/docs/endpoints/index-list) | ⚠️ 港股成分股字段是**中文键**（代码/名称/涨跌幅/成交额）

| | 筛选 | `/v1/screen?market=hk` | ⚠️ 港美股 PE 字段是 `PeTTM`（大小写敏感）

| | 公司行为 / 资讯 | [/v1/buyback](/docs/endpoints/buyback) · `/v1/news` · `/v1/notice` · `/v1/search` | 回购：港股是**逐日明细**，A 股是事件概要

 行情
 [/v1/quote](/docs/endpoints/quote) · [/v1/kline](/docs/endpoints/kline) · `/v1/minute` · `/v1/technical`
 ⚠️ 港股 K 线**不支持日期范围**，用 `count`

 基本面
 [/v1/finance](/docs/endpoints/finance) · `/v1/profile` · `/v1/shareholder` · `/v1/dividend`
 报表期次与字段口径以返回为准

 机构态度
 [/v1/rating](/docs/endpoints/rating)（港美股专属）· [/v1/consensus](/docs/endpoints/consensus)
 ⚠️ 港股一致预期**没有目标价**，只有 `*Forecast` 一套

 资金 / 卖空
 [/v1/fund-flow](/docs/endpoints/fund-flow) · [/v1/fund-south](/docs/endpoints/fund-south) · [/v1/fund-short](/docs/endpoints/fund-short)
 ⚠️ 卖空**必须传 date**；南下是**季度**持仓

 事件
 `/v1/calendar` · [/v1/disclosure](/docs/endpoints/disclosure) · `/v1/ipo` · [/v1/suspension](/docs/endpoints/suspension)
 港股事件密度远高于 A 股（实测一只 151 条）

 指数
 [/v1/index-constituent](/docs/endpoints/index-constituent) · [/v1/index-list](/docs/endpoints/index-list)
 ⚠️ 港股成分股字段是**中文键**（代码/名称/涨跌幅/成交额）

 筛选
 `/v1/screen?market=hk`
 ⚠️ 港美股 PE 字段是 `PeTTM`（大小写敏感）

 公司行为 / 资讯
 [/v1/buyback](/docs/endpoints/buyback) · `/v1/news` · `/v1/notice` · `/v1/search`
 回购：港股是**逐日明细**，A 股是事件概要

## 四条能直接跑的例子
 免费端点（[/v1/quote](/docs/endpoints/quote)、[/v1/kline](/docs/endpoints/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](/docs/endpoints/finance) 或行情自带字段

 「恒生科技有哪些成分股」
 `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](/docs/endpoints/finance) 或行情自带字段

 ⚠️ **Agent 的四条纪律**：① 港股代码 **5 位**（`hk00700`）；② [/v1/fund](/docs/endpoints/fund) **查不了港股**（A 股综合口径），要用 [/v1/fund-flow](/docs/endpoints/fund-flow)；③ [/v1/chip](/docs/endpoints/chip)、`/v1/sector`、`/v1/hot`、`/v1/lhb` **不支持港股**；④ [/v1/rating](/docs/endpoints/rating) 只收港美股，A 股会 422。

## 边界先说清（7 条，省你试错）
 这些是数据本身的限制，不是接口没做好：

 筹码分布不支持港股
 [/v1/chip](/docs/endpoints/chip) 只覆盖沪深 A 股。港股的持仓成本类数据没有替代口径。

 港股 K 线不支持日期范围
 只能用 `count` 取最近 N 根；A 股才支持 `start`/`end`。

 「港股通持股（A股口径）」不适用
 [/v1/fund](/docs/endpoints/fund) 是 A 股综合口径（龙虎榜/大宗/两融），传港股会 422 —— 港股资金面请用 `fund-flow` / `fund-south` / `fund-short`。

 卖空数据要传 date
 不传且当日数据未发布时，只返回 `code`/`name`/`EndDate`/`ClosePrice` 四个标识字段。

 港股一致预期没有目标价
 [/v1/consensus](/docs/endpoints/consensus) 对港股只给 `epsForecast` / `netProfitForecast` / `peRatioForecast` 等一整套预测，`targetPrice` 为 `null`。目标价请用 [/v1/rating](/docs/endpoints/rating)。

 港股指数成分字段是中文键
 A 股指数返回 `code`/`name`/`IndexName`；港股返回 `代码`/`名称`/`涨跌幅`/`成交额`，⛔ 不能按同一套键名解析。

 港股 K 线全历史拿不到
 受 1212 条上限约束；A 股全历史请用 `/v1/kline-full`，但那不含港股。

## 常见问题
 港股代码怎么写？
 **5 位数字 + hk 前缀**：腾讯 `hk00700`、美团 `hk03690`。与 A 股 6 位（`sh600519`）不同；不确定代码先用 `/v1/search`。

 能一次查多只港股吗？
 资金面可以：[/v1/fund-south](/docs/endpoints/fund-south)、[/v1/rating](/docs/endpoints/rating)、[/v1/consensus](/docs/endpoints/consensus) 支持逗号多只。但 [/v1/index-constituent](/docs/endpoints/index-constituent) **一次只能 1 个指数**（逗号会返回空）。

 港股的 PE 字段为什么报错？
 港美股是 `PeTTM`（大小写敏感），A 股才是 `PE_TTM` —— 用 `/v1/screen?market=hk` 时注意。

 免费能查港股吗？
 [/v1/quote](/docs/endpoints/quote)、[/v1/kline](/docs/endpoints/kline)、`/v1/hot` 免费端点可直接查港股行情；财务、评级、资金、指数等需标准版（¥29.9）或专业版（¥99）。

 港股资金流「开盘前为 0」是没数据吗？
 不是。部分资金字段在开盘前为 0 是正常现象，盘中会恢复。

## 想再深入
 相关文档：
 [港股能力盘点（22 个入口全表 + 每项实测）
 命令级 18 + 子命令级 4 · 口径差异 · 不支持清单](/docs)[指数成分股端点
 A 股与港股字段差异 · 三个港股指数](/docs/endpoints/index-constituent)[筛选端点（market=hk）
 港股排行 · 主题池 · 为什么不能因子筛选](/docs/endpoints/screen)

 用一只港股试一下
 [/v1/quote](/docs/endpoints/quote) 与 [/v1/kline](/docs/endpoints/kline) 免费无需 Key；评级、资金、指数成分需付费档。
 [MCP 接入说明](/mcp)[查看定价](/pricing)
