跳到主要内容

标的前后继

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

代码变更、转换场所、合并换股或转换使一个可交易身份结束、另一个开始时的前后继关系，带每 1 单位前者换得的后者单位数与生效日期。前后继不得成环；板块变更不改变 asset_id，不在本表。

业务主键：predecessor_asset_id、successor_asset_id、effective_date、available_at，每行取值唯一。

接口​

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

请求参数​

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

参数名类型必填说明
start_datedate否按生效日期筛选，查询开始日期，包含该日。
end_datedate否按生效日期筛选，查询结束日期，包含该日。

返回字段​

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

字段名中文名称类型可空说明
predecessor_asset_id前者标识string否结束的标的的 asset_id。
successor_asset_id后者标识string否开始的标的的 asset_id。
effective_date生效日期date否后者开始、前者结束的日期。
succession_type前后继类型string否code_change 代码变更，venue_transfer 转换场所，merger 合并换股，conversion 转换。
quantity_ratio换算比例decimal否每 1 单位前者换得的后者单位数。
available_at可知时间timestamp否该关系首次公开可知的时刻（UTC）。
is_retracted是否撤回boolean否该行是否撤回此前同键的行。
basis_document依据文件string否该行的依据：交易所或编制方的公告、名单或来源端点。
evidence_sha256依据原件哈希string是依据原件内容的 sha256；尚未取得原件时为空。
verification_status核验状态string否verified 已有依据原件，unverified 尚未取得依据原件。

字段补充属性​

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

字段名属性
succession_type枚举（allowedValues）：["code_change", "venue_transfer", "merger", "conversion"]
quantity_ratio精度（precision）：38；小数位数（scale）：10
verification_status枚举（allowedValues）：["verified", "unverified"]

请求示例​

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

{
  "select": [
    "predecessor_asset_id",
    "successor_asset_id",
    "effective_date",
    "succession_type",
    "quantity_ratio"
  ],
  "where": [
    {
      "field": "effective_date",
      "op": "gte",
      "value": "2025-01-01"
    },
    {
      "field": "effective_date",
      "op": "lte",
      "value": "2026-10-29"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "ref.asset_successions",
  "fields": [
    "predecessor_asset_id",
    "successor_asset_id",
    "effective_date",
    "succession_type",
    "quantity_ratio"
  ],
  "data": [],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}