选股 Universe（Screener）
选股 Universe（Screener）接口用于返回标准化股票基础面与筛选数据，适合做跨市场候选池构建和分页拉取。
HTTP 方法与路径：GET /api/v1/stock/screener/universe
接口定位与边界
- 返回的是研究用数据视图，不是交易建议或自动信号。
- 与
selection接口相比，本接口更强调标准化字段和分页能力，适合程序化拉取。 - 推荐和以下文档配套阅读：
/signal-client/methodology/indicator-guide/signal-client/methodology/filter-presets/signal-client/guides/stock-screener
入参
Path
| 路径参数 | 无 |
Query
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
market | ’CN_A' | 'HK’ | 否 |
page | number | 否 | 默认 1 |
pageSize | number | 否 | 默认 100，最大 500 |
filter | string | 否 | 附加筛选 |
字段与状态语义
| 字段 | 含义 | 研究建议 |
|---|---|---|
items | 当前页样本数据 | 先做样本质量检查，再进入筛选 |
capability | 字段能力状态（如 partial） | 为 partial 时，避免把缺失字段当负面结论 |
degradeReasons | 降级原因列表 | 用于判断哪些策略规则暂不适用 |
pagination.clientMustPageUntilTotal | 是否必须翻页拉全 | 需要全市场样本时请循环拉取到 total |
note | 口径和归一化说明 | 消费端应持久化，便于复盘口径变化 |
关于 degradeReasons
- 该字段用于说明“哪些能力或字段暂不可用”。
- 推荐在策略层将其视为“证据不完整”而不是“自动否定样本”。
响应
响应外壳：成功时 JSON 含
success、data、可选message，见 统一响应体。
响应示例
对应请求 GET /api/v1/stock/screener/universe。字段以线上为准。
{
"success": true,
"data": {
"market": "CN_A",
"total": 76,
"page": 1,
"pageSize": 100,
"items": [
{
"code": "000906",
"name": "浙商中拓",
"market": "CN_A",
"secucode": "000906.SZ",
"industry": "物流",
"listDate": "19990707",
"close": 6.36,
"pe": 20.77166823,
"pb": 0.91161118,
"dv": 2.0440251572,
"marketCap": 4513.457818,
"turnover": 8.31,
"debtRatio": 81.6119246552,
"grossMargin": 1.1161651986,
"roe": 3.4,
"netProfit": 186.99999563,
"revenue": 56086.43358008,
"ocf": -9329.291003309825,
"fcfYield": 170.75992140029456
},
"..."
],
"capability": "partial",
"degradeReasons": [
"tier2_pledge_ratio_not_in_selection_feed",
"..."
],
"pagination": {
"mode": "offset_page",
"maxPageSize": 500,
"clientMustPageUntilTotal": true,
"description": "单页仅返回一页标的；需要全市场时请递增 page 直至已拉取条数 ≥ total（pageSize ≤ maxPageSize）。"
},
"note": "Tier1 字段已按百万元/YYYYMMDD/% 归一；Tier2 硬否决与部分因子字段见 degradeReasons"
}
}请求示例
curl -sS -H "Authorization: Bearer <API_KEY>" "http://localhost:4000/api/v1/stock/screener/universe"实践建议
- 分页拉取时优先保证口径一致，再比较跨页结果。
- 对
capability=partial的结果，建议降级处理而非直接剔除。 - 将
degradeReasons与筛选版本一并记录，保证可追溯性。
Last updated on