跳到主要内容

分红、拆分与配股

数据集标识：stock.corporate_actions；证券对象标识示例：XSHE:000001

股票分红、拆分、配股和其他公司事件的观察记录；第一批按预案公告日期提供来源观察快照，不承诺稳定事件 ID、完整修订史或 PIT 语义。

接口​

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

请求参数​

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

参数名类型必填说明
asset_idstring否筛选一个或多个标的标识（<场所码>:<代码>）。
security_codestring否筛选一个或多个证券代码。
marketstring否市场代码；中文客户端默认 CN。
start_datedate否按预案公告日期筛选，查询开始日期，包含该日。
end_datedate否按预案公告日期筛选，查询结束日期，包含该日。

返回字段​

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

字段名中文名称类型可空说明
asset_id标的标识string否与市场无关的标的标识，格式为 <场所码>:<代码>，场所码为 ISO 10383 MIC，例如 XSHE:000001。
security_code证券代码string否展示别名：带市场后缀的证券代码，例如 000001.SZ；由 asset_id 换算，不作业务键。
market市场string否标的挂牌场所所在的市场，ISO 3166-1 alpha-2 代码，例如 CN；由 asset_id 的场所导出。
reporting_period_end分红年度date是分红年度；第一批不供数：来源不提供分红年度
announcement_date公告日期date是预案公告日期；第一批按该日期提供观察窗口、默认查询日期与分区。
action_status实施进度string是实施进度；第一批不供数：来源不提供实施进度
stock_distribution_per_share每股送转decimal是每股送转
bonus_share_ratio每股送股比例decimal是每股送股比例
capitalization_share_ratio每股转增比例decimal是每股转增比例
net_cash_dividend_per_share每股分红decimal是每股分红（税后）；第一批不供数：来源税后每股分红为多值文本（对应多种税率口径），不挑单一口径
gross_cash_dividend_per_share每股分红decimal是每股分红（税前）
record_date股权登记日date是股权登记日
ex_date除权除息日date是除权除息日
pay_date派息日date是派息日
distributed_share_listing_date红股上市日date是分配股份开始上市交易的业务日期。
implementation_announcement_date实施公告日date是实施公告日
base_date基准日date是基准日；第一批不供数：来源不提供基准日
base_share_count基准股本decimal是公司行动计算使用的基准股本，单位为股，不使用万股缩放。第一批不供数：来源不提供基准股本

字段补充属性​

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

字段名属性
stock_distribution_per_share精度（precision）：38；小数位数（scale）：18
bonus_share_ratio精度（precision）：38；小数位数（scale）：18
capitalization_share_ratio精度（precision）：38；小数位数（scale）：18
net_cash_dividend_per_share精度（precision）：38；小数位数（scale）：18
gross_cash_dividend_per_share精度（precision）：38；小数位数（scale）：18
base_share_count精度（precision）：38；小数位数（scale）：18

请求示例​

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

{
  "select": [
    "asset_id",
    "security_code",
    "reporting_period_end",
    "announcement_date",
    "action_status",
    "stock_distribution_per_share",
    "bonus_share_ratio",
    "capitalization_share_ratio",
    "net_cash_dividend_per_share"
  ],
  "where": [
    {
      "field": "asset_id",
      "op": "eq",
      "value": "XSHE:000001"
    },
    {
      "field": "market",
      "op": "eq",
      "value": "CN"
    },
    {
      "field": "announcement_date",
      "op": "gte",
      "value": "1991-03-03"
    },
    {
      "field": "announcement_date",
      "op": "lte",
      "value": "1991-03-03"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "stock.corporate_actions",
  "fields": [
    "asset_id",
    "security_code",
    "reporting_period_end",
    "announcement_date",
    "action_status",
    "stock_distribution_per_share",
    "bonus_share_ratio",
    "capitalization_share_ratio",
    "net_cash_dividend_per_share"
  ],
  "data": [
    {
      "action_status": null,
      "announcement_date": "1991-03-03",
      "asset_id": "XSHE:000001",
      "bonus_share_ratio": "0.400000000000000000",
      "capitalization_share_ratio": null,
      "net_cash_dividend_per_share": null,
      "reporting_period_end": null,
      "security_code": "000001.SZ",
      "stock_distribution_per_share": "0.400000000000000000"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}