跳到主要内容

复权因子

数据集标识：ref.adjustment_factors；证券对象标识示例：000001.SZ

按除权日给出的后复权因子：某日价格乘以 ex_date 不晚于该日的最新一行的累积因子。每个标的、每种口径在锚点日有一行，两个因子都是 1；某日之前没有任何行时读方必须拒绝，不得假定因子为 1。锚点变化时该标的的全部行在同一批内重发，时点视图内不会出现两个锚点。

业务主键：asset_id、ex_date、factor_method、available_at，每行取值唯一。

接口​

用途方法与路径
查询数据POST /v1/datasets/ref.adjustment_factors/query
契约与当前发布GET /v1/datasets/ref.adjustment_factors
准备批量快照POST /v1/datasets/ref.adjustment_factors/preparations

请求参数​

可在请求体 where 中作为 field 使用的筛选参数，名称保持契约原名。

参数名类型必填说明
asset_idstring否标的标识，例如 XSHE:000001。
start_datedate否按除权日筛选，查询开始日期，包含该日。
end_datedate否按除权日筛选，查询结束日期，包含该日。
factor_methodstring否复权口径：total_return 或 share_only。

返回字段​

列名保持契约原名，可直接用于 select、where 与结果行。

字段名中文名称类型可空说明
asset_id标的标识string否标的的 asset_id，格式为 <场所码>:<代码>，例如 XSHE:000001。
market市场string否场所所属市场码，由场所登记派生，例如 CN。
security_code展示别名string是场所登记的展示别名，例如 000001.SZ；无展示后缀的场所为空。
ex_date除权除息日date否除权除息日；锚点行为锚点日。
adjustment_factor单日因子decimal否该除权日的单日因子：前一交易日收盘价 ÷ 除权参考价；锚点行为 1。
cumulative_adjustment_factor累积因子decimal否自 anchor_date 累积到该日的因子。
factor_method复权口径string否total_return 现金与股份分配都计入，是读方默认；share_only 只计股份类事件。
anchor_date锚点日date否累积因子为 1 的日期，取覆盖起点，不取上市日。
factor_version因子版本string否输入事件集合与算法的 sha256。
ex_reference_price除权参考价decimal是计算单日因子所用的除权参考价；锚点行为空。
ex_reference_basis除权参考价依据string是公布值与标准公式推导值不同时，采用公布值的公告依据；其余为空。
price_currency价格币种string否除权参考价的币种，ISO 4217。
available_at可知时间timestamp否该行信息首次可知的时刻（UTC）。同一批重发的行取同一时刻，按查询时点取不晚于它的最新一行。
is_retracted是否撤回boolean否该行是否撤回此前同键的行；撤回行自其可知时间起使该记录在时点视图中消失。
basis_document依据文件string否该行的依据：交易所公告或来源端点。
evidence_sha256依据原件哈希string是依据原件内容的 sha256；尚未取得原件时为空。
verification_status核验状态string否verified 已有官方依据原件，unverified 尚未取得；取自第三方来源的行为 unverified。

字段补充属性​

括号中是契约描述（GET /v1/datasets/{datasetId} 的 fields）里的键名。

字段名属性
adjustment_factor精度（precision）：38；小数位数（scale）：18；单位（unit）：ratio
cumulative_adjustment_factor精度（precision）：38；小数位数（scale）：18；单位（unit）：ratio
factor_method枚举（allowedValues）：["total_return", "share_only"]
ex_reference_price精度（precision）：38；小数位数（scale）：10；单位（unit）：currency_field:price_currency
verification_status枚举（allowedValues）：["verified", "unverified"]

请求示例​

向 https://api.<环境域名>/v1/datasets/ref.adjustment_factors/query 发送 POST 请求（服务地址的替换方式见快速开始），请求头为 Authorization: Bearer <API_KEY> 与 Content-Type: application/json，请求体如下：

{
  "select": [
    "asset_id",
    "ex_date",
    "factor_method",
    "adjustment_factor",
    "cumulative_adjustment_factor",
    "anchor_date"
  ],
  "where": [
    {
      "field": "ex_date",
      "op": "gte",
      "value": "2025-01-01"
    },
    {
      "field": "ex_date",
      "op": "lte",
      "value": "2026-10-29"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

实际结果随数据更新而变化；data 为空数组表示请求范围内没有可返回的记录。

{
  "datasetId": "ref.adjustment_factors",
  "fields": [
    "asset_id",
    "ex_date",
    "factor_method",
    "adjustment_factor",
    "cumulative_adjustment_factor",
    "anchor_date"
  ],
  "data": [],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}