API 接口文档

因子分析与量化选股

多因子标准化库、横截面因子排名、回测宽表、多因子选股与多股对比分析。

因子分析与量化选股 API

多因子标准化库、横截面因子排名、回测宽表、多因子选股与多股对比分析。

接口清单汇总(共 7 项)

接口端点请求方法关键查询参数功能说明
/v1/factors/backtest-dataGETsymbol, date, start_date, end_date, limitGet Backtest Data
/v1/factors/industriesGET—因子库行业列表
/v1/factors/libraryGETsymbol, date, start_date, end_date, industry, fields, limitGet Factor Library
/v1/factors/performanceGETstart_date, end_date, factor因子绩效统计 (IC/IR)
/v1/factors/rankingGETfactor, date, industry, top_n, limit, order, neutralizeGet Factor Ranking
/v1/stocks/compareGETsymbols, date, fields多股对比
/v1/stocks/screenGETpe_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 策略)。

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (如: sz.000001, sh.600519) (可选)
datestring否—交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
limitinteger否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 维 + 综合得分)。

请求参数

参数名类型必填默认值描述
symbolstring否—股票代码 (如: sz.000001, sh.600519) (可选, 不填返回全市场)
datestring否—交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)
start_datestring否—开始日期 (YYYY-MM-DD) (可选)
end_datestring否—结束日期 (YYYY-MM-DD) (可选)
industrystring否—申万一级行业过滤 (可选)
fieldsstring否—返回字段, 逗号分隔 (默认精简集, ’*’ 返回全量)
limitinteger否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_datestring否—开始日期 (YYYY-MM-DD)
end_datestring否—结束日期 (YYYY-MM-DD)
factorstring否—单因子列名 (不填返回全部)

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 的股票。

请求参数

参数名类型必填默认值描述
factorstring否composite_score排名依据 (27 项: composite_score, value_score, f_momentum_1m_rank, …)
datestring否—交易日 (YYYY-MM-DD) (可选, 不填返回最新交易日)
industrystring否—申万一级行业过滤 (可选)
top_ninteger否50返回前 N 名
limitstring否—返回条数 (兼容通用 limit 参数;设置后优先于 top_n)
orderstring否desc排序方向: asc (升序) / desc (降序)
neutralizestring否—中性化: 设为 ‘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

多股对比

对比多只股票在同一天的因子得分。

请求参数

参数名类型必填默认值描述
symbolsstring否—逗号分隔的股票代码 (如 sh.600519,sz.000858)
datestring否—交易日 (默认最新)
fieldsstring否—返回字段 (默认精简集)

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_maxstring否—PE 排名上限 (越小越便宜)
pb_rank_maxstring否—PB 排名上限
roic_rank_minstring否—ROIC 排名下限 (越高越好)
roe_rank_minstring否—ROE 排名下限
momentum_1m_minstring否—1月动量排名下限
momentum_12m_minstring否—12月动量排名下限
beta_rank_maxstring否—Beta 排名上限 (越小代表越低风险)
composite_score_minstring否—综合得分下限
industrystring否—申万一级行业过滤
sortstring否—排序字段 (如 -composite_score)
datestring否—交易日 (默认最新)
fieldsstring否—返回字段 (默认精简集, ’*’ 返回全量)
weightsstring否—自定义7维权重,逗号分隔: value,quality,momentum,capital,risk,expectation,governance (如: 0.30,0.30,0.15,0.10,0.05,0.05,0.05)
limitinteger否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())