跳到主要内容

派生序列逐日映射

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

每个交易日每条派生序列对应的具体合约。交易日 T 的目标合约只用 T 之前已收盘的数据决定，日内不切换；available_at 是该决定所依据的收盘数据可知的时刻。换月日以 is_roll_date 标记。

业务主键：series_id、trading_date、available_at，每行取值唯一。

接口​

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

请求参数​

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

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

返回字段​

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

字段名中文名称类型可空说明
series_id序列标识string否ref.series_definitions 登记的序列标识。
trading_date日期date否日历所属地的自然日，包含休市日。
asset_id目标合约string否该交易日序列对应的具体合约的 asset_id（规格 063）。
is_roll_date换月日boolean否当日的目标合约与前一交易日不同为真。
available_at可知时间timestamp否该行信息的公开时刻：年度休市安排取交易所公告的发布时刻（只有转载报道时取报道时刻，作为上界），临时休市取临时公告时刻。同一日期的更正以新行表达，旧行保留。

请求示例​

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

{
  "select": [
    "series_id",
    "trading_date",
    "asset_id",
    "is_roll_date",
    "available_at"
  ],
  "where": [
    {
      "field": "series_id",
      "op": "eq",
      "value": "CCFX:IF@dominant.1"
    },
    {
      "field": "trading_date",
      "op": "gte",
      "value": "2026-10-01"
    },
    {
      "field": "trading_date",
      "op": "lte",
      "value": "2026-10-31"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "ref.series_mappings",
  "fields": [
    "series_id",
    "trading_date",
    "asset_id",
    "is_roll_date",
    "available_at"
  ],
  "data": [
    {
      "asset_id": "CCFX:IF2412",
      "available_at": "2026-10-27T07:00:00+00:00",
      "is_roll_date": false,
      "series_id": "CCFX:IF@dominant.1",
      "trading_date": "2026-10-28"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}