QMT Trading Skill · 财报下载
实现状态：✅
download_financial_data.py
目标
向 Bridge 服务端 写入 财务数据缓存，供后续 GET /api/financial/data 或 fundamental-screen 使用。
何时用本 Skill（而非筛选 Skill）
| 场景 | 使用 |
|---|---|
| 用户明确要「下载/补全/刷新」财报 | 本 Skill |
| 批量标的、指定表、下载后验证 | 本 Skill |
| 按 ROE/EPS 等指标筛选 | fundamental-screen |
| 筛选时偶发缺数 | 筛选脚本默认 --if-missing；大批量仍建议先本 Skill |
脚本
# 下载每股指标表（默认 Pershareindex）
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
--host HOST --port PORT \\
--codes 600584.SH,603986.SH --table Pershareindex
# 下载后验证缓存是否有数据
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
--codes 600584.SH --verify --wait 8
# 下载全部财务表（较慢，勿对全市场使用）
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
--codes 600519.SH --all-tables --verify
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py 与上述参数相同。
推荐流程（Agent）
1. 确认用户给出的股票列表（勿擅自扩大为全市场）
2. 说明：下载会写服务端缓存，可能耗时数秒～数十秒
3. 运行 download_financial_data.py，建议加 --verify
4. 若有仍无数据的代码：加大 --wait、检查 QMT 是否登录、或换表名
5. 需要筛选时，再运行 fundamental-screen 的 screen_financial.py
主要参数
| 参数 | 说明 |
|---|---|
--codes |
必填，逗号分隔 |
--table |
默认 Pershareindex |
--all-tables |
下载全部表（慢） |
--start-time / --end-time |
可选 YYYYMMDD |
--wait |
下载后等待秒数（默认 5） |
--verify |
等待后查询缓存；仍缺数时自动再等一轮（最多 --wait 秒） |
--json |
JSON 输出 |
常用财务表
| 表名 | 含义 |
|---|---|
Pershareindex |
每股指标（ROE、EPS 等） |
Income |
利润表 |
Balance |
资产负债表 |
CashFlow |
现金流量表 |
API
| 操作 | 路径 |
|---|---|
| 下载 | POST /api/download/financial_data |
| 验证查询 | GET /api/financial/data |
| 名称 | GET /api/utility/batch_stock_name |
同步阻塞版：POST /api/download/financial_data2（本脚本未封装，需时用 REST 或客户端）。
安全
- 写操作：会触发服务端向行情源拉取并缓存数据
- 勿对「沪深 A股」等超大列表无确认地下载
- 不提供投资建议
参考
- fundamental-screen ·
[REST API](https://atorber.github.io/qmt-bridge/rest-api/)·_shared/financial_util.py