个股因子全市场截面快照

公开接口

A股个股 A-Share · 个股因子全市场截面快照

取某因子在某交易日的全市场截面（按代码升序分页）。``factor_name`` 必填，取值见因子目录；``trade_date`` 留空时取该因子的**最新交易日**。用于横向比较全市场某因子的分布或做筛选。

接口地址

GET /cn/stock/factors/snapshot

完整地址：https://api.databull.cn/cn/stock/factors/snapshot

接口说明

取某因子在某交易日的全市场截面（按代码升序分页）。factor_name 必填，取值见 /cn/stock/factors；trade_date 留空时取该因子的**最新交易日**。

响应为 {"code": 0, "data": {分页对象}}；无数据时在 empty_reason 标注原因（invalid_date 日期格式错 / no_data_in_range 该因子无数据）。

请求参数

参数位置类型必填默认说明

factor_name查询string是—因子名称，如 mom_20 / rsi_14 / vol_20 / 52week_position

trade_date查询string否交易日期 YYYY-MM-DD；留空取该因子最新交易日

page查询integer否1页码，从 1 开始；不小于 1

page_size查询integer否200每页条数，1~500；取值 1~500

返回字段

字段类型说明

codenumber业务状态码，0 表示成功

dataobject分页结果对象

data.itemsarray因子值记录数组，按 ticker 升序

data.items[].tickerstring个股代码（裸码），如 600519

data.items[].factor_namestring因子名称

data.items[].valuenumber|null因子值；缺失时为 null

data.items[].trade_datestring该条记录对应的交易日期，YYYY-MM-DD

data.items[].sourcestring因子来源标记

data.items[].update_timestring|null落库时间，ISO 8601

data.totalnumber满足筛选条件的总条数

data.page / data.page_sizenumber当前页码 / 每页条数

data.has_moreboolean是否还有下一页

empty_reasonstring仅当 items 为空时出现，标注为空的原因

接口示例

cURL

curl "https://api.databull.cn/cn/stock/factors/snapshot?factor_name=mom_20&trade_date=2026-10-09&page=1" \
  -H "Authorization: Bearer $DATABULL_API_KEY"

Python

from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_stock_factor_snapshot(factor_name="mom_20", trade_date="2026-10-09")
print(result)

响应示例

JSON

{
  "code": 0,
  "data": {
    "items": [
      {
        "ticker": "600000",
        "factor_name": "mom_20",
        "value": 0.0312,
        "trade_date": "2026-10-09",
        "source": "technical",
        "update_time": null
      },
      {
        "ticker": "600519",
        "factor_name": "mom_20",
        "value": 0.0854,
        "trade_date": "2026-10-09",
        "source": "technical",
        "update_time": null
      }
    ],
    "total": 2,
    "page": 1,
    "page_size": 200,
    "has_more": false
  }
}

错误码

状态码触发条件

401缺少或无效 API 凭证

429当日调用次数已用尽

403特色功能需付费套餐，升级套餐后可用

说明

``factor_name`` 为**必填**，取值必须是因子目录中的因子名。
``trade_date`` 留空时服务端自动取该因子最新交易日；传非法日期（非 YYYY-MM-DD）返回空结果并在 ``empty_reason`` 标 ``invalid_date``。
区间内无数据时 ``data.items`` 为空数组，``empty_reason`` 为 ``no_data_in_range``（该因子尚未计算到该日）。
需携带 API 凭证（Authorization: Bearer <key> 或 X-API-Key）。
该接口属于特色功能「因子查询」，需付费套餐（专业版及以上）方可调用；免费版不含该功能。