---
title: "量化因子库（88 因子 + 50 筛选入口 + 预设模板）"
method: GET
path: "/v1/factors"
tags: ["pro"]
---

# 量化因子库（88 因子 + 50 筛选入口 + 预设模板）

`GET /v1/factors`

## 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/factors`
- Auth: none declared

⭐ **量化因子库 / 筛选能力字典**：列出全部可用于筛选的因子与入口。

**包含**：
- **88 个因子**（估值 6 / 行情 2 / 盈利 34 / 资产负债 33 / 现金流 13）—— 代码 / 中文名 / 单位 / 说明
- **50 个非因子筛选入口**：排行 18 · 标签 21 · 事件 11（⭐ 含排雷类：`risk_st` ST股 / `risk_delisting` 退市 / `fin_unhealthy_growth` 增收不增利 / `shareunlock_next_90` 未来90天解禁 …）
- **22 个预设**（`--preset` 调用，含中文说明）
- **14 个策略模板**（可直接复制的完整表达式）
- **8 条使用铁律** + **12 条易错写法对照** + **后缀命名规则**

**怎么用**：把因子写成表达式传给 `/v1/screen`，例如
`intersect([PE_TTM > 0, PE_TTM < 20, ROETTM > 15])`

**语法**：多条件用 `intersect([...])` 取交集（AND）；比较符仅支持 `> < >= <= = !=`；⛔ 不支持 `between` / `in` / `OR`。

⭐ **支持历史截面**：`/v1/screen?date=YYYY-MM-DD` 可取**任意历史交易日**的因子值（实测 2016-08-08 起有数据）⇒ 可串成 `因子 → 筛选 → 回测` 的完整研究链路。

⚠️ **最常见的一条坑**：`PE_TTM > 0` 必须前置（亏损股 PE 为负，会被当成『低 PE』选入）。

⚠️ 本端点是**静态清单**（不含重型额度）。
⚠️ 属**付费层**（需 API Key）—— 门槛 **`standard`（¥29.9）及以上**。

## Query parameters

- `category` string: 按分类过滤：估值/行情/盈利/资产负债/现金流（省略=全部）
- `kind` string: 只看筛选入口：排行/标签/事件（省略=不限）

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[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)