跳到主要内容

回转与交收规则

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

按「场所 × 资产类别 × 子类 × 板块 × 品种 × 生效区间」的回转与交收规则：当日买入能否当日卖出，以及资金与证券的交收天数。能否当日回转与交收周期是两件事，分别给出；尚未取得依据的项为空。

业务主键：rule_id，每行取值唯一。

接口​

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

请求参数​

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

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

返回字段​

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

字段名中文名称类型可空说明
rule_id规则标识string否规则在本数据集内的唯一标识，以场所码小写开头、以生效起始年份结尾。
venue场所string否交易场所码：ISO 10383 MIC（如 XSHG 上海证券交易所），无 MIC 的场所用 BQ 开头的登记码。
asset_class资产类别string否资产类别登记值，如 stock 股票、etf 交易型开放式基金。
asset_subclass资产子类string是资产子类登记值，如 ETF 的 equity、growth_board_equity、bond、money_market、commodity、cross_border；为空表示适用该类别全部子类。
market_segment板块string是场所内的板块登记值，如 main 主板、star 科创板、chinext 创业板、sme 中小企业板、bse 北京证券交易所；为空表示不限板块。
product_code品种代码string是衍生品所属品种的场所代码；为空表示不限品种。
instrument_set_id标的集合标识string是规则适用的标的集合标识（ref.instrument_sets）；规则只对当日属于该集合的标的生效，为空表示不限。范围其余字段相同、引用同一集合族内不同集合的两条规则不算重叠。
valid_from生效日期date否规则生效日，包含该日。
valid_to失效日期date是规则失效日，不含该日；为空表示至今有效。
intraday_round_trip当日回转string否allowed 当日买入可当日卖出，forbidden 次一交易日起才可卖出。
cash_settlement_lag_days资金交收天数integer是成交后第几个交易日完成资金交收；尚未取得依据时为空。
security_settlement_lag_days证券交收天数integer是成交后第几个交易日完成证券交收；尚未取得依据时为空。
daily_mark_to_market逐日盯市boolean否是否逐日按结算价清算盈亏。
basis_document依据文件string否规则依据的业务规则名称与条款摘要。
evidence_sha256依据原件哈希string是依据原件内容的 sha256；尚未取得原件时为空。
verification_status核验状态string否verified 已有依据原件，unverified 尚未取得依据原件。
rules_version规则表版本string否规则表全部内容的 sha256；规则表变化即版本变化，已发布数据不随之改变。

字段补充属性​

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

字段名属性
venue标准（standard）：ISO 10383
intraday_round_trip枚举（allowedValues）：["allowed", "forbidden"]
verification_status枚举（allowedValues）：["verified", "unverified"]

请求示例​

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

{
  "select": [
    "venue",
    "asset_class",
    "asset_subclass",
    "valid_from",
    "intraday_round_trip"
  ],
  "where": [
    {
      "field": "venue",
      "op": "eq",
      "value": "XSHG"
    },
    {
      "field": "valid_from",
      "op": "gte",
      "value": "1990-12-19"
    },
    {
      "field": "valid_from",
      "op": "lte",
      "value": "1990-12-19"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "ref.settlement_rules",
  "fields": [
    "venue",
    "asset_class",
    "asset_subclass",
    "valid_from",
    "intraday_round_trip"
  ],
  "data": [
    {
      "asset_class": "etf",
      "asset_subclass": "money_market",
      "intraday_round_trip": "allowed",
      "valid_from": "1990-12-19",
      "venue": "XSHG"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}