因子分析接口

因子与回测数据

多因子标准化库、因子排名和回测宽表接口。

方法	端点	说明
GET	/v1/factors/library	因子库查询
GET	/v1/factors/ranking	因子排名
GET	/v1/factors/industries	行业列表
GET	/v1/factors/performance	因子绩效 (IC/IR)
GET	/v1/factors/backtest-data	回测数据导出
GET	/v1/stocks/screen	多因子选股
GET	/v1/stocks/compare	多股因子对比

---

1. 因子库查询

方法	端点
GET	/v1/factors/library

获取多因子标准化库数据，覆盖价值、质量、动量、资金、风险、预期、治理 7 个维度及综合得分。每个因子已做横截面百分位标准化 (0-100)，NULL 默认为中性 50。

参数	类型	必填	说明
symbol	string	-	股票代码 (如 sz.000001)，不填返回全市场
date	string	-	交易日 (YYYY-MM-DD)，不填返回最新
start_date	string	-	开始日期
end_date	string	-	结束日期
industry	string	-	申万一级行业过滤 (如 银行)
fields	string	-	返回字段，逗号分隔。默认精简集 (10 个得分列)，* 返回全量 51 列
limit	int	-	返回条数 (默认 200, 最大 5000)

GET/v1/factors/library

API Key

Parameters

symbol

date

limit

Try It

---

2. 因子排名

方法	端点
GET	/v1/factors/ranking

按指定因子 (或综合得分) 获取横截面排名前 N 的股票。支持全部 19 个单因子排名列 + 8 个维度得分列。

参数	类型	必填	说明
factor	string	-	排名依据 (默认 composite_score)。可选: composite_score, value_score, quality_score, momentum_score, capital_score, risk_score, expectation_score, governance_score, f_value_pe_rank, f_value_pb_rank, f_value_fcf_rank, f_quality_roic_rank, f_quality_roe_rank, f_quality_fcf_growth_rank, f_quality_margin_rank, f_momentum_1m_rank, f_momentum_3m_rank, f_momentum_6m_rank, f_momentum_12m_rank, f_capital_main_rank, f_capital_north_rank, f_risk_beta_rank, f_risk_vol_rank, f_risk_drawdown_rank, f_expectation_revision_rank, f_governance_shareholder_rank, f_governance_inst_rank
date	string	-	交易日 (YYYY-MM-DD)，不填返回最新
industry	string	-	申万一级行业过滤 (可选)
top_n	int	-	返回前 N 名 (默认 50, 最大 500)

GET/v1/factors/ranking

API Key

Parameters

factor

date

top_n

Try It

---

3. 回测数据导出

方法	端点
GET	/v1/factors/backtest-data

导出回测因子宽表数据，含行情、标准化因子、前瞻收益 (1d/5d/20d/60d) 和市场体制标签。

:::caution 含前瞻收益数据且数据量大，默认适用 Max 计划门禁 (credit cost 8)。 :::

参数	类型	必填	说明
symbol	string	-	股票代码 (可选，不填返回全市场)
date	string	-	交易日 (YYYY-MM-DD)，不填返回最新
start_date	string	-	开始日期
end_date	string	-	结束日期
limit	int	-	返回条数 (默认 500, 最大 5000)

GET/v1/factors/backtest-data

API Key

Parameters

symbol

date

limit

Try It

---

4. 行业列表

方法	端点
GET	/v1/factors/industries

返回因子库中所有申万一级行业名称，用于 library 与 ranking 端点的 industry 筛选参数发现。

GET/v1/factors/industries

API Key

Try It

---

5. 因子绩效统计

方法	端点
GET	/v1/factors/performance

计算各因子的 Rank IC 均值、IC 信息比率 (IC_IR)、胜率与样本数，基于 ads_backtest_factor_wide 的 fwd_return_20d 进行横截面相关性分析。

参数	类型	必填	说明
start_date	string	-	样本开始日期
end_date	string	-	样本结束日期
factor	string	-	单因子列名 (不填返回全部 20 个)

每行返回：factor、mean_ic、ic_ir、win_rate、obs。

GET/v1/factors/performance

API Key

Try It

---

6. 多因子选股

方法	端点
GET	/v1/stocks/screen

按因子排名阈值、行业、自定义权重等多条件筛选股票，支持 27 个因子列与 JSON 格式的灵活过滤条件。

参数	类型	必填	说明
filters	string (JSON)	-	过滤条件，键为因子别名，值为 [op, threshold]。例 {"value_score": ["gt", 0.7]}
industry	string	-	申万一级行业
sort	string	-	排序列 (前缀 - 表示降序)
trade_date	string	-	交易日 (默认最新)
weights	string	-	7 维自定义权重，逗号分隔：val,qual,mom,cap,risk,exp,gov
fields	string	-	返回字段，* 为全量
limit	int	-	返回条数 (默认 50)

支持的算子：gt、gte、lt、lte。提供 weights 时返回动态计算的 custom_score 列。

GET/v1/stocks/screen

API Key

Parameters

sort

limit

Try It

---

7. 多股因子对比

方法	端点
GET	/v1/stocks/compare

横向对比多只股票（最多 20 只）在同一交易日的因子得分，便于快速横向评估持仓组合。

参数	类型	必填	说明
symbols	string	✓	逗号分隔的股票代码 (如 sh.600519,sz.000858)
date	string	-	交易日 (默认最新)
fields	string	-	返回字段，* 为全量

GET/v1/stocks/compare

API Key

Parameters

symbols

Try It