Serennity007 QMT Trading Skill · 基本面筛选
实现状态：✅
screen_financial.py（筛选；下载见 financial-download）
目标
基于服务端 xtquant 财务报表缓存 做可验证粗筛；单只或少量标的缺数时脚本可自动补下载。
相关 Skill
| 需求 | Skill |
|---|---|
| 只下载 / 批量补缓存 / 下载后验证 | qmt-bridge-financial-download |
| 按指标筛选 | 本 Skill |
脚本（优先使用）
# 筛选（默认缺数自动 download + 等待 5s）
python skills/qmt-bridge-fundamental-screen/scripts/screen_financial.py \\
--host HOST --port PORT \\
--codes 300394.SZ,603986.SH --table Pershareindex
# ROE ≥ 5%（别名 roe → du_return_on_equity）
python skills/qmt-bridge-fundamental-screen/scripts/screen_financial.py \\
--codes 300394.SZ,603986.SH --table Pershareindex --field roe --min 5
# 关闭自动下载（需已缓存）
python skills/qmt-bridge-fundamental-screen/scripts/screen_financial.py \\
--codes 600584.SH --no-if-missing
大批量下载请先：
python skills/qmt-bridge-financial-download/scripts/download_financial_data.py \\
--codes ... --verify
推荐流程（Agent）
1. 解析股票列表与筛选条件
2. 若用户仅要「下载财报」→ 使用 financial-download，不要本脚本
3. 运行 screen_financial.py（默认 --if-missing）
4. 输出：代码 + 中文名 + 指标 + 报告期
主要参数
| 参数 | 说明 |
|---|---|
--codes |
必填 |
--table |
默认 Pershareindex |
--field |
筛选字段，支持别名 roe |
--min / --max |
数值过滤（ROE 等为百分点，5 表示 5%） |
--from-positions |
使用当前持仓代码列表 |
--if-missing / --no-if-missing |
缺数自动下载（默认开） |
--download |
查询前强制下载 |
--wait |
下载后等待秒数（默认 5） |
--json |
JSON 输出 |
常用字段（Pershareindex）
| 字段 | 含义 |
|---|---|
du_return_on_equity |
ROE（--field roe） |
s_fa_eps_basic |
基本每股收益 |
s_fa_bps |
每股净资产 |
API
| 操作 | 路径 |
|---|---|
| 查询 | GET /api/financial/data |
| 下载 | POST /api/download/financial_data（或 financial-download Skill） |
安全
- 筛选以只读查询为主；自动/强制下载会写缓存
- 不输出投资建议
参考
- financial-download ·
[REST API](https://atorber.github.io/qmt-bridge/rest-api/)