指定日期 ETF PCF 列表 - 获取指定日期 ETF PCF 列表

1. 接口描述

项目	说明
接口名称	获取指定日期 ETF PCF 列表
外部接口	GET /api/v1/market/data/etf-pcf/etf-pcfs
请求方式	GET
适用场景	获取指定交易日 ETF 申购赎回清单（PCF）文件列表，支持分页，数据来自外部 PCF 服务

2. 请求参数

参数名	类型	是否必填	描述	取值示例	备注
date	int	是	日期	20260309	YYYYMMDD 整型
page	int	否	页码，从 1 开始	1	默认 1
page_size	int	否	每页记录数	20	默认 20，最大 100

3. 响应说明

返回分页的 PCF 文件列表。

{
  "total": 850,
  "page": 1,
  "page_size": 20,
  "items": [
    {
      "etf_code": 159003,
      "date": 20260309,
      "filename": "pcf_159003_20260309.xml"
    },
    {
      "etf_code": 159005,
      "date": 20260309,
      "filename": "pcf_159005_20260309.xml"
    }
  ]
}

EtfPcfItem 字段

字段名	类型	是否可为空	说明
etf_code	int	否	ETF 代码
date	int	否	日期 YYYYMMDD
filename	string	否	PCF 文件名，如 pcf_159152_20260316.xml

4. 用法

通过主目录 run.py 调用（必填 --date，可选 --page、--page_size）：

python <RUN_PY> etf-pcfs --date 20260309
python <RUN_PY> etf-pcfs --date 20260309 --page 1 --page_size 20

<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。脚本输出 JSON；本接口无需额外请求头。

5. 请求示例

GET /api/v1/market/data/etf-pcf/etf-pcfs?date=20260309&page=1&page_size=20

6. 注意事项

• date 为 YYYYMMDD 整型（如 20260309），需为交易日
• page_size 最大 100
• 无数据时 items 为空数组，total 为 0