API 接口文档
因子分析与量化选股
多因子标准化库、横截面因子排名、回测宽表、多因子选股与多股对比分析。
因子分析与量化选股 API
多因子标准化库、横截面因子排名、回测宽表、多因子选股与多股对比分析。
接口清单汇总(共 7 项)
| 接口端点 | 请求方法 | 关键查询参数 | 功能说明 |
|---|---|---|---|
/v1/factors/backtest-data | GET | symbol, date, start_date, end_date, limit | Get Backtest Data |
/v1/factors/industries | GET | — | 因子库行业列表 |
/v1/factors/library | GET | symbol, date, start_date, end_date, industry, fields, limit | Get Factor Library |
/v1/factors/performance | GET | start_date, end_date, factor | 因子绩效统计 (IC/IR) |
/v1/factors/ranking | GET | factor, date, industry, top_n, limit, order, neutralize | Get Factor Ranking |
/v1/stocks/compare | GET | symbols, date, fields | 多股对比 |
/v1/stocks/screen | GET | pe_rank_max, pb_rank_max, roic_rank_min, roe_rank_min, momentum_1m_min, momentum_12m_min, beta_rank_max, composite_score_min, industry, sort, date, fields, weights, limit | 多条件选股 |
详细接口规范与调用示例
GET /v1/factors/backtest-data
Get Backtest Data
导出回测因子宽表数据 (行情 + 标准化因子 + 前瞻收益 + 市场体制)。
含前瞻收益数据且数据量大, 默认适用 Max 计划门禁 (见 access_control 策略)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选) |
date | string | 否 | — | 交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
limit | integer | 否 | 500 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/factors/backtest-data?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/factors/backtest-data"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/factors/industries
因子库行业列表
返回因子库中所有申万一级行业名称 (供筛选参考)。
(无需查询参数)
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/factors/industries" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/factors/industries"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
response = requests.get(url, headers=headers)
print(response.json())
GET /v1/factors/library
Get Factor Library
获取多因子标准化库数据 (价值/质量/动量/资金/风险/预期/治理 7 维 + 综合得分)。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbol | string | 否 | — | 股票代码 (如: sz.000001, sh.600519) (可选, 不填返回全市场) |
date | string | 否 | — | 交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日) |
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) (可选) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) (可选) |
industry | string | 否 | — | 申万一级行业过滤 (可选) |
fields | string | 否 | — | 返回字段, 逗号分隔 (默认精简集, ’*’ 返回全量) |
limit | integer | 否 | 200 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/factors/library?symbol=sz.000001&date=2026-06-18&start_date=2026-01-01" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/factors/library"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbol": "sz.000001",
"date": "value",
"start_date": "2026-01-01"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/factors/performance
因子绩效统计 (IC/IR)
返回因子 Rank IC 均值、IC_IR、胜率统计。
基于 fwd_return_20d 计算横截面 Rank IC。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
start_date | string | 否 | — | 开始日期 (YYYY-MM-DD) |
end_date | string | 否 | — | 结束日期 (YYYY-MM-DD) |
factor | string | 否 | — | 单因子列名 (不填返回全部) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/factors/performance?start_date=2026-01-01&factor=composite_score" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/factors/performance"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"start_date": "2026-01-01",
"end_date": "value",
"factor": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/factors/ranking
Get Factor Ranking
按指定因子获取横截面排名前 N 的股票。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
factor | string | 否 | composite_score | 排名依据 (27 项: composite_score, value_score, f_momentum_1m_rank, …) |
date | string | 否 | — | 交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日) |
industry | string | 否 | — | 申万一级行业过滤 (可选) |
top_n | integer | 否 | 50 | 返回前 N 名 |
limit | string | 否 | — | 返回条数 (兼容通用 limit 参数;设置后优先于 top_n) |
order | string | 否 | desc | 排序方向: asc (升序) / desc (降序) |
neutralize | string | 否 | — | 中性化: 设为 ‘industry’ 进行行业内排名 (扣除行业均值) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/factors/ranking?factor=composite_score&date=2026-06-18&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/factors/ranking"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"factor": "value",
"date": "value",
"industry": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/compare
多股对比
对比多只股票在同一天的因子得分。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
symbols | string | 否 | — | 逗号分隔的股票代码 (如 sh.600519,sz.000858) |
date | string | 否 | — | 交易日 (默认最新) |
fields | string | 否 | — | 返回字段 (默认精简集) |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/compare?date=2026-06-18" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/compare"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"symbols": "value",
"date": "value",
"fields": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
GET /v1/stocks/screen
多条件选股
按因子排名范围、行业等多条件筛选股票。
请求参数
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
pe_rank_max | string | 否 | — | PE 排名上限 (越小越便宜) |
pb_rank_max | string | 否 | — | PB 排名上限 |
roic_rank_min | string | 否 | — | ROIC 排名下限 (越高越好) |
roe_rank_min | string | 否 | — | ROE 排名下限 |
momentum_1m_min | string | 否 | — | 1月动量排名下限 |
momentum_12m_min | string | 否 | — | 12月动量排名下限 |
beta_rank_max | string | 否 | — | Beta 排名上限 (越小代表越低风险) |
composite_score_min | string | 否 | — | 综合得分下限 |
industry | string | 否 | — | 申万一级行业过滤 |
sort | string | 否 | — | 排序字段 (如 -composite_score) |
date | string | 否 | — | 交易日 (默认最新) |
fields | string | 否 | — | 返回字段 (默认精简集, ’*’ 返回全量) |
weights | string | 否 | — | 自定义7维权重,逗号分隔: value,quality,momentum,capital,risk,expectation,governance (如: 0.30,0.30,0.15,0.10,0.05,0.05,0.05) |
limit | integer | 否 | 50 | 返回条数 |
cURL 调用示例
curl -X GET "https://tickerlab.org/v1/stocks/screen?date=2026-06-18&limit=10" \
-H "X-API-Key: $TICKERLAB_API_KEY"
Python 调用示例
import requests
url = "https://tickerlab.org/v1/stocks/screen"
headers = {"X-API-Key": "$TICKERLAB_API_KEY"}
params = {
"pe_rank_max": "value",
"pb_rank_max": "value",
"roic_rank_min": "value"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())