$npx -y skills add FTShare-Lab/FTShare-skills --skill fund-holder-structure-single-fund查询基金持有人结构(按报告期)。当用户需要查询基金持有人户数、户均持有份额、机构/个人/前十大持有人份额与比例等,可按 report_type 与 start_date/end_date 过滤时使用。直接返回数组(非分页)。
| 1 | # 基金持有人结构 |
| 2 | |
| 3 | ## 接口说明 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |----------|-------------------------------------------------------------------| |
| 7 | | 接口名称 | 基金持有人结构 | |
| 8 | | 外部接口 | `/api/v1/market/data/fund/fund-holder-structure` | |
| 9 | | 请求方式 | GET | |
| 10 | |
| 11 | ## 请求参数 |
| 12 | |
| 13 | | 参数名 | 类型 | 是否必填 | 描述 | |
| 14 | |--------|------|----------|------| |
| 15 | | `--fund_code` | string | 是 | 基金代码(如 000001 或 000001.OF) | |
| 16 | | `--report_type` | string | 否 | 报告类型:年度报告/中期报告/上市公告书/基金合同生效公告,缺省全部 | |
| 17 | | `--start_date` | int | 否 | 报告期起始日期 YYYYMMDD | |
| 18 | | `--end_date` | int | 否 | 报告期截止日期 YYYYMMDD | |
| 19 | |
| 20 | ## 执行方式 |
| 21 | |
| 22 | 通过根目录的 `run.py` 调用(推荐): |
| 23 | |
| 24 | ```bash |
| 25 | python <RUN_PY> fund-holder-structure-single-fund --fund_code 000001 --report_type 年度报告 |
| 26 | ``` |
| 27 | |
| 28 | > `<RUN_PY>` 为主 `SKILL.md` 同级的 `run.py` 绝对路径。 |
| 29 | |
| 30 | ## 响应结构 |
| 31 | |
| 32 | JSON 对象或数组,结构请参考 [ftshare-doc](../..) 接口文档。 |
| 33 | |
| 34 | ## 注意事项 |
| 35 | |
| 36 | - 必填参数必须提供。 |
| 37 | - 响应以 JSON 格式输出至 stdout,诊断信息输出至 stderr。 |