FTShare-Lab ETF 公告列表
1. 接口描述
| 项目 | 说明 |
|---|---|
| 接口名称 | ETF 公告列表（etf_announcements） |
| 外部接口 | GET /api/v2/market/data/announcements/etf-announcements |
| 请求方式 | GET（query 参数） |
| 适用场景 | 按标的查单只 ETF 全部公告，或按单日日期查全市场 ETF 公告；公告正文 PDF 可按返回的 url_hash 另行下载 |
两种模式二选一：
- 按标的：传
etf_code，查单只 ETF 所有公告。 - 按日期：传
start_date（必须等于end_date，仅支持单日），查指定日期全市场 ETF 公告。
2. 请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| etf_code | string | 二选一 | ETF 代码 | 159915 | 支持裸代码/短后缀/长后缀（159915.SZ、510300.XSHG），大小写不敏感 |
| start_date | string | 二选一 | 日期 | 20260831 | YYYYMMDD；按日期查询时必填，仅支持单日 |
| end_date | string | 否 | 日期 | 20260831 | 不填默认等于 start_date，且必须等于 start_date |
| page | int | 是 | 页码 | 1 | 必填 |
| page_size | int | 是 | 每页条数 | 5 | 必填 |
| --all | - | 否 | 自动翻页拉全量 | - | 仅本子 skill 扩展参数 |
3. 响应说明
外层固定为 code / message / data。data 为分页对象：pageNum / pageSize / total / pages / records。
records 元素：
| 字段名 | 类型 | 说明 |
|---|---|---|
| etf_code | string | ETF 代码，6 位裸代码，不带交易所后缀 |
| etf_name | string | ETF 名称 |
| announcement_id | string | 公告 id |
| announcement_title | string | 公告标题 |
| announcement_time | string | 公告时间，格式 YYYY-MM-DD HH:MM:SS |
| url_hash | string | 公告文件 URL 哈希，用于下载正文文件 |
4. 调用方式
python <RUN_PY> etf-announcements --etf-code 159915 --page 1 --page-size 5
python <RUN_PY> etf-announcements --start-date 20260831 --page 1 --page-size 20
python <RUN_PY> etf-announcements --etf-code 159915 --page 1 --page-size 20 --all
<RUN_PY> 为主 SKILL.md 同级 run.py 的绝对路径。输出 JSON；HTTP 错误输出到 stderr 并以非零状态退出。
5. 注意事项
- 必须提供
etf_code或start_date之一，否则服务端报错（handler 会本地校验并拒绝）。 - 按日期查询仅支持单日：
end_date不填默认等于start_date，填了则必须相等。 - ETF 范围为场内 ETF，不含联接基金、LOF。
- 公告正文下载：
GET /api/v2/market/data/announcements/etf-announcements/{url_hash}，响应为 PDF 二进制附件；url_hash须取自本接口返回值，勿硬编码。 - 当前数据源仅覆盖深市 ETF（
159开头）；查询沪市代码会返回空列表。