$npx -y skills add FTShare-Lab/FTShare-skills --skill etf-pcfs指定日期 ETF PCF 列表(market.ft.tech)。用户问 ETF PCF、申购赎回清单、指定日期 PCF 列表时使用。
| 1 | # 指定日期 ETF PCF 列表 - 获取指定日期 ETF PCF 列表 |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 获取指定日期 ETF PCF 列表 | |
| 8 | | 外部接口 | `GET /api/v1/market/data/etf-pcf/etf-pcfs` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 获取指定交易日 ETF 申购赎回清单(PCF)文件列表,支持分页,数据来自外部 PCF 服务 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 15 | |--------|------|----------|------|----------|------| |
| 16 | | date | int | 是 | 日期 | 20260309 | YYYYMMDD 整型 | |
| 17 | | page | int | 否 | 页码,从 1 开始 | 1 | 默认 1 | |
| 18 | | page_size | int | 否 | 每页记录数 | 20 | 默认 20,最大 100 | |
| 19 | |
| 20 | ## 3. 响应说明 |
| 21 | |
| 22 | 返回分页的 PCF 文件列表。 |
| 23 | |
| 24 | ```json |
| 25 | { |
| 26 | "total": 850, |
| 27 | "page": 1, |
| 28 | "page_size": 20, |
| 29 | "items": [ |
| 30 | { |
| 31 | "etf_code": 159003, |
| 32 | "date": 20260309, |
| 33 | "filename": "pcf_159003_20260309.xml" |
| 34 | }, |
| 35 | { |
| 36 | "etf_code": 159005, |
| 37 | "date": 20260309, |
| 38 | "filename": "pcf_159005_20260309.xml" |
| 39 | } |
| 40 | ] |
| 41 | } |
| 42 | ``` |
| 43 | |
| 44 | ### EtfPcfItem 字段 |
| 45 | |
| 46 | | 字段名 | 类型 | 是否可为空 | 说明 | |
| 47 | |--------|------|------------|------| |
| 48 | | etf_code | int | 否 | ETF 代码 | |
| 49 | | date | int | 否 | 日期 YYYYMMDD | |
| 50 | | filename | string | 否 | PCF 文件名,如 pcf_159152_20260316.xml | |
| 51 | |
| 52 | ## 4. 用法 |
| 53 | |
| 54 | 通过主目录 `run.py` 调用(必填 `--date`,可选 `--page`、`--page_size`): |
| 55 | |
| 56 | ```bash |
| 57 | python <RUN_PY> etf-pcfs --date 20260309 |
| 58 | python <RUN_PY> etf-pcfs --date 20260309 --page 1 --page_size 20 |
| 59 | ``` |
| 60 | |
| 61 | `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON;本接口无需额外请求头。 |
| 62 | |
| 63 | ## 5. 请求示例 |
| 64 | |
| 65 | ``` |
| 66 | GET /api/v1/market/data/etf-pcf/etf-pcfs?date=20260309&page=1&page_size=20 |
| 67 | ``` |
| 68 | |
| 69 | ## 6. 注意事项 |
| 70 | |
| 71 | - `date` 为 YYYYMMDD 整型(如 20260309),需为交易日 |
| 72 | - `page_size` 最大 100 |
| 73 | - 无数据时 `items` 为空数组,`total` 为 0 |