Index weight summary
Skill FTShare-Lab/FTShare-skills/ftshare-market-data/sub-skills/index-weight-summary
FTShare Agent Skills for financial data and investment research workflows｜金融数据 Skill 与投研业务 Skill 仓库。
npx -y skills add FTShare-Lab/FTShare-skills --skill index-weight-summaryAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
分页查询指数权重汇总（market.ft.tech）。可按 index_code 查询指定指数各期权重的 date 与 url_hash。用户问指数权重汇总、成分股权重期数、权重文件 url_hash、沪深300 权重日期、有哪些指数权重数据时使用。下游：取到 url_hash 后可调 index-weight-download 下载 xlsx；取到 index_code/date 后可调 index-weight-list 查成份明细。
SKILL.md
3.3 KB, as published. Nobody here has run it
分页查询指数权重汇总（index-weight-summary）
1. 接口描述
| 项目 | 说明 |
|---|---|
| 接口名称 | 分页查询指数权重汇总 |
| 外部接口 | /api/v1/market/data/index/index_weight_summary |
| 请求方式 | GET |
| 适用场景 | 按指数汇总各期权重数据的 date 与 url_hash；可用 index_code 定位单个指数，便于再调用「下载指数权重文件」获取具体权重表 |
2. 请求参数
说明：使用查询参数。
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| index_code | string | 否 | 指数代码 | 000300 | 不传则分页返回全部指数 |
| page | int | 否 | 页码 | 1 | 默认 1 |
| page_size | int | 否 | 每页条数 | 20 | 默认 20，最大 100 |
3. 响应说明
返回值为分页列表对象 IndexWeightSummaryListResponse。
IndexWeightSummaryListResponse 结构
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| total | int | 否 | 总条数（按指数汇总的记录数） | - |
| page | int | 否 | 当前页码 | - |
| page_size | int | 否 | 每页条数 | - |
| index_weights | array | 否 | 单只指数的期数汇总列表 | - |
IndexWeightSummary 结构（index_weights 元素）
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| index_code | String | 否 | 指数代码 | - |
| periods | array | 否 | 该指数各期的日期与下载用 url_hash | - |
IndexWeightPeriod 结构（periods 元素）
| 字段名 | 类型 | 是否可为空 | 说明 | 单位 |
|---|---|---|---|---|
| date | String | 否 | 权重日期；文档示例为 YYYYMMDD，线上也可能为 YYYY-MM-DD，以实际返回为准 | - |
| url_hash | String | 否 | 该期权重文件的哈希 | - |
4. 调用方式
本 handler 与上级 FTShare-index-data/run.py 配合使用：
python <RUN_PY> index-weight-summary --index-code 000300 --page 1 --page-size 20
python <RUN_PY> index-weight-summary --page 1 --page-size 20
其中 <RUN_PY> 为 FTShare-index-data/run.py 的绝对路径。
直接执行 handler（调试）
python scripts/handler.py --page 1 --page-size 20
python scripts/handler.py --index-code 000300 --page 1 --page-size 20
（需在 sub-skills/index-weight-summary 目录下执行，或传入脚本完整路径。）
5. 链路说明
本接口为权重链第 1 步。
- 取到
index_code+date→ 可调index-weight-list --index_code <code> --date <date>查成份明细。 - 取到
url_hash→ 可调index-weight-download --url-hash <url_hash>直接下载整期 xlsx。
6. 请求示例
GET /api/v1/market/data/index/index_weight_summary?index_code=000300&page=1&page_size=20