---
title: "选股（因子 / 标签 / 排行 / 策略 / 事件）"
method: GET
path: "/v1/screen"
tags: ["pro"]
---

# 选股（因子 / 标签 / 排行 / 策略 / 事件）

`GET /v1/screen`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/screen`
- Auth: none declared

按条件筛出股票清单。**五个模式，用 `mode` 选**（默认 condition）：

**`mode=condition`（默认）** 因子选股：`expr` 多因子交集，如 `intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])`；或用 `preset` 从 22 个官方预设里选（大小写/下划线不敏感：`low_pe` = `LowPE`）。常用因子：PE_TTM/PB/PS_TTM/TotalMV/DividendRatioTTM（估值）· ROE/ROETTM/ROIC/GrossIncomeRatioTTM/NetProfitRatioTTM（盈利）· OperatingRevenueGrowRate/NPParentCompanyYOY（成长）· CurrentRatio/DebtAssetsRatio/NAPS（负债）· NetOperateCashFlowTTM/FCFF（现金流）· ClosePrice/OpenPrice/HighPrice/LowPrice/ChangePCT/Chg5D/Chg20D/Chg60D、MA_5/MA_20/MA_60、MainNetFlow、TurnoverRate（价量资金）。
⚠️ **`TotalMV` 单位是「元」不是「亿元」** —— 200 亿要写 `TotalMV < 20000000000`；写成 `TotalMV < 200` 会**零结果**（不是报错，容易误判成「没有符合的票」）。
⚠️ **港股/美股** 的市盈率字段是 **`PeTTM`**（不是 `PE_TTM`，两者大小写敏感）；A 股专有字段（ROETTM/MainNetFlow/DividendRatioTTM…）在港美股不可用。
⚠️ 语法只认 `intersect([...])`（且）/ `union([...])`（或），**不支持 `AND` / `&&` / `&`**。

**`mode=label`** 按**属性标签**选：央企/国企/民企/QFII、ST/退市/破发、破净、亏损、现金流结构、上市时间、市值档位…（共 **108 个标签**）；`asset=etf` 切 ETF 主题池。

**`mode=ranking`** 全市场**排行**：综合/资金/基本面/风险/技术评分、两融余额及日周月季年变动、主力与散户资金流入、北向活跃度、涨跌停天数…（`type` 指定指标，默认 `CompScore`）。

**`mode=strategy`** **技术/风格策略**：MACD金叉、KDJ金叉、突破年线、首次涨停、连板、高股息、高盈利价值、大师策略（巴菲特/格雷厄姆/费雪…）共 **98 个策略**。

**`mode=event`** **事件驱动**：分红预案/决案/实施/除权、业绩预告/快报/披露、定增上市前后、董监高变更与增减持、大宗交易、解禁…（共 **42 个事件**）。

⭐ **不知道有哪些取值？`list=true` 直接列出全部**（带中文名与分组）——各模式都支持，⛔ 不要凭猜去填 `type`。`list` 时可传 `type` 作为**分组过滤**（如 `type=股东属性`），也可以留空取全部。

**返回**：`data` 是排版好的表格；程序化读取用 `structured`（第一张表）。⚠️ 多标签/多策略时会**分多段返回**（每个取值一段表）⇒ 用 **`tables`** 取全部段。

**翻页**：`limit`（上限 200）+ `offset`。

## Query parameters

- `mode` string: condition 因子 / label 标签 / ranking 排行 / strategy 策略 / event 事件
- `list` boolean: true=列出该模式全部可用取值（带中文名与分组）
- `expr` string: [condition] 因子表达式，如 intersect([PE_TTM > 0, ROETTM > 15])
- `preset` string: [condition] 预设名（与 expr 二选一）：LowPE/LowPB/HighDividend/PEG/HighROE 等 22 个
- `type` string: [label/ranking/strategy/event] 取值；list=true 时作分组过滤
- `limit` integer: 返回条数，默认 20（上限 200）
- `offset` integer: 跳过前 N 条（翻页）
- `orderby` string: [condition] 排序字段（如 ROETTM）
- `desc` boolean: [condition] True 降序 / False 升序
- `date` string: [label/ranking/strategy] 查询日期 YYYY-MM-DD（留空=最新交易日）
- `start` string: [label/strategy] 区间起始日 YYYY-MM-DD
- `end` string: [label/strategy] 区间结束日 YYYY-MM-DD
- `asset` string: [label/ranking] 资产类别：stock 股票（默认）/ etf
- `universe` string: [condition] 限定股票池，传**个股代码**（如 sh600519）；⚠️ 传板块代码会报错
- `market` string: [condition] 市场：hs 沪深 / hk 港股 / us 美股（留空=沪深）。⚠️ 港美股市盈率字段用 PeTTM，不是 PE_TTM

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `fc57bdcb13d5`: 1 info
  - added the new optional `query` request parameter `universe`

[Operation history](https://skmtc.dev/ashareapi/apis/a-api/changes/v1/screen/get.md)

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)