跳到主要内容

ETF 上市与退市事件

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

ETF 挂牌开始与终止上市事件。终止上市事件取自上海、深圳证券交易所的基金公告；每条事件带公告日期与原因，公告的封存引用保存在构建血缘中，不另列公开字段。无法取得公告或公告日期的已退市 ETF 不生成无日期事件行，列入构建证据的“退市日期未知”名单。

业务主键：asset_id、event_type、effective_date，每行取值唯一。

接口​

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

请求参数​

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

参数名类型必填说明
asset_idstring否筛选一个或多个标的标识（<场所码>:<代码>）。
security_codestring否筛选一个或多个证券代码。
start_datedate否按生效日期查询的开始日期，包含该日。
end_datedate否按生效日期查询的结束日期，包含该日。

返回字段​

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

字段名中文名称类型可空说明
asset_id标的标识string否与市场无关的标的标识，格式为 <场所码>:<代码>，场所码为 ISO 10383 MIC，例如 XSHE:000001。
security_code证券代码string否展示别名：带市场后缀的证券代码，例如 516480.SH；由 asset_id 换算，不作业务键。
market市场string否标的挂牌场所所在的市场，ISO 3166-1 alpha-2 代码，例如 CN；由 asset_id 的场所导出。
event_type事件类型string否listed 挂牌开始，delisted 终止上市。
effective_date生效日期date否事件在市场规则下生效的日期。
announcement_date公告日期date是事件首次公开披露的日期。
reason事件原因string是公开披露的事件原因。

请求示例​

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

{
  "select": [
    "asset_id",
    "security_code",
    "event_type",
    "effective_date",
    "announcement_date",
    "reason"
  ],
  "where": [
    {
      "field": "asset_id",
      "op": "eq",
      "value": "XSHG:516480"
    },
    {
      "field": "effective_date",
      "op": "gte",
      "value": "2025-10-14"
    },
    {
      "field": "effective_date",
      "op": "lte",
      "value": "2025-10-14"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "equity.listing_events",
  "fields": [
    "asset_id",
    "security_code",
    "event_type",
    "effective_date",
    "announcement_date",
    "reason"
  ],
  "data": [
    {
      "announcement_date": "2025-09-30",
      "asset_id": "XSHG:516480",
      "effective_date": "2025-10-14",
      "event_type": "delisted",
      "reason": "基金合同终止",
      "security_code": "516480.SH"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}