FTShare-Lab 查询恒生系列指数成份股权重
接口说明
| 项目 | 说明 |
|---|---|
| 接口名称 | 对外接口-查询恒生指数成分权重 |
| 接口列表 | hsi-daily-weight |
| 外部接口 | GET /api/v1/market/data/hk/hsi-daily-weight |
| 请求方式 | GET |
| 适用场景 | 查询恒生系列指数成份股的权重数据，支持按交易日、日期范围、指数代码、股票代码过滤。数据来源 MySQL xz02.base_data.hsi_daily_weight。 |
请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| trade_date | int | 否 | 交易日 | 20260529 | YYYYMMDD；与 start_date/end_date 互斥 |
| start_date | int | 否 | 交易日下界 | 20260501 | YYYYMMDD；须与 end_date 同时提供 |
| end_date | int | 否 | 交易日上界 | 20260529 | YYYYMMDD；须与 start_date 同时提供 |
| index_slug | string | 否 | 指数代码（大小写不敏感） | HSI | HSI(恒生)/HSCEI(国企)/HSAIT(见注意) |
| stock_code | string | 否 | 4 位港股代码 | 0700 | 如 0700(腾讯)，4 位非 5 位 |
| page / page_size | int | 否 | 分页 | 1 / 50 | 默认 1 / 50，page_size 最大 200 |
至少需要一个过滤条件：
trade_date、start_date+end_date、index_slug、stock_code，否则 400。
执行方式
# 恒生指数 HSI 某日成份权重（先按指数取，再按最新交易日筛）
python scripts/handler.py --index_slug HSI --page 1 --page_size 200
# 某日某指数成份权重
python scripts/handler.py --trade_date 20260529 --index_slug HSCEI
# 某股票在各指数的权重历史
python scripts/handler.py --stock_code 0700
# 日期范围 + 指数
python scripts/handler.py --start_date 20260501 --end_date 20260529 --index_slug HSI
响应结构（信封：code/message/data.records）
{
"code": 0, "message": "success",
"data": {
"pageNum": 1, "pageSize": 50, "total": 90, "pages": 2,
"records": [
{ "trade_date": "2026-05-29", "index_slug": "hsi", "index_name": "hsi",
"stock_code": "0700", "stock_name": "TENCENT 騰訊控股", "weight_pct": "8.4",
"source_file": "con_29May26.pdf", "url_hash": "...", "processed_at": "2026-05-29 19:34:36" }
]
}
}
⚠️ 数据在
data.records，不是顶层数组。
records 字段
| 字段 | 说明 |
|---|---|
| trade_date | 交易日 YYYY-MM-DD |
| index_slug | 指数代码（小写，如 hsi/hscei/hsait） |
| index_name | 当前与 index_slug 相同（小写代码，非中文名） |
| stock_code | 4 位港股代码（0700，非 00700） |
| stock_name | 股票名称（多为英文/繁体，如 TENCENT 騰訊控股） |
| weight_pct | 权重百分比，字符串（如 "8.4"）；未缩放，直接是百分数 |
| source_file / url_hash / processed_at | 来源文件 / URL 哈希 / 处理时间 |
注意事项
- ⚠️
HSAIT的"恒生科技"映射存疑（实测发现，2026-05-29 验证）：- 文档称
HSAIT = 恒生科技指数，但实测返回 40 只成份股，且中国移动(0941)以 10.86% 排第一。 - 官方恒生科技指数(HSTECH)为 30 只、8% 个股权重上限、不含中国移动——三点均不符。
- → 勿将
HSAIT直接当作恒生科技指数权重。其真实对应指数未确定（可能为恒生港股通科技/综合类）。需数据团队核对index_slug映射或上游 PDF 解析。 - 另：kline 接口里恒生科技叫
HSTECH，与本接口的HSAIT命名不一致。
- 文档称
HSI/HSCEI权重可用：HSI 实测返回 ~90 只成份股（恒指规模相符），Top 为汇丰/阿里/腾讯/友邦/建行，合理。weight_pct是字符串百分数（未做 ×1e4 缩放，与港股财报的金额缩放不同）。stock_code为 4 位（0700，非00700/00700.HK）。index_slug大小写不敏感，响应中始终返回小写。trade_date与start_date/end_date互斥；start_date/end_date必须成对且start_date ≤ end_date。- 排序：
trade_date DESC, index_slug, stock_code。 - HTTP 恒为 200，业务错误通过
code/message携带（非 0 为错误）；数据来自 MySQL 实时读取，高频调用建议用trade_date精确过滤。
调用示例
python <RUN_PY> hsi-daily-weight --trade_date 20260821 --index_slug HSI --page 1