跳到主要内容

波动控制规则

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

按滚动参考价判定、推不出当日涨跌停价的波动控制规则（美股 LULD、港股市场波动调节机制、期货动态熔断等）。命中范围且当日属于所引用集合的标的，按 control_type 与价格档恰好匹配一条，给出参考窗口、带宽、触发动作与冷静期参数。静态涨跌幅仍在 ref.price_limit_rules。

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

接口​

用途方法与路径
查询数据POST /v1/datasets/ref.volatility_control_rules/query
契约与当前发布GET /v1/datasets/ref.volatility_control_rules
准备批量快照POST /v1/datasets/ref.volatility_control_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是规则失效日，不含该日；为空表示至今有效。
control_type控制类型string否limit_up_limit_down 价格上下限，volatility_interruption 波动中断（冷静期），dynamic_circuit_breaker 动态熔断。
reference_price_basis参考价基准string否滚动参考价的取法：last_trade_before_window 窗口前最后一笔成交，average_price_over_window 窗口内成交均价，previous_close 前收，opening_price 开盘价。
reference_window_minutes参考窗口integer是按滚动成交价取参考价时的窗口分钟数；基准为前收或开盘价时为空。
price_from价格档下限decimal是按参考价分档的价格档下限（含），以标的的计价币种表示；为空表示不分档。
price_to价格档上限decimal是按参考价分档的价格档上限（不含），以标的的计价币种表示；为空表示无上限。
band_ratio带宽比例decimal是参考价上下浮动的带宽比例（0.10 即 10%）；按金额设置带宽时为空。
band_amount带宽金额decimal是参考价上下浮动的带宽金额；按比例设置带宽时为空。
band_amount_currency带宽金额币种string是带宽金额的币种码；按比例设置带宽时为空。
trigger_action触发动作string否cooling_off 冷静期后恢复，limit_state_then_halt 进入限价状态、未恢复则停牌，halt 直接停牌。
action_minutes触发时长integer是冷静期或停牌的分钟数；限价状态后停牌的动作可为空。
limit_state_seconds限价状态时长integer是进入限价状态的秒数；其他触发动作为空。
applicable_phases适用阶段string是适用阶段的阶段码列表，逗号分隔，每个都是登记的阶段码；为空表示不限阶段。
not_before_time最早触发时间string是当地时间 HH:MM:SS，此前不触发；为空表示不限。
not_after_time最晚触发时间string是当地时间 HH:MM:SS，此后不触发；为空表示不限。
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
control_type枚举（allowedValues）：["limit_up_limit_down", "volatility_interruption", "dynamic_circuit_breaker"]
reference_price_basis枚举（allowedValues）：["last_trade_before_window", "average_price_over_window", "previous_close", "opening_price"]
price_from精度（precision）：38；小数位数（scale）：18
price_to精度（precision）：38；小数位数（scale）：18
band_ratio精度（precision）：38；小数位数（scale）：18；单位（unit）：ratio
band_amount精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:band_amount_currency
trigger_action枚举（allowedValues）：["cooling_off", "limit_state_then_halt", "halt"]
verification_status枚举（allowedValues）：["verified", "unverified"]

请求示例​

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

{
  "select": [
    "venue",
    "asset_class",
    "instrument_set_id",
    "control_type",
    "valid_from",
    "band_ratio"
  ],
  "where": [
    {
      "field": "venue",
      "op": "eq",
      "value": "XHKG"
    },
    {
      "field": "valid_from",
      "op": "gte",
      "value": "2016-08-22"
    },
    {
      "field": "valid_from",
      "op": "lte",
      "value": "2016-08-22"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例​

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

{
  "datasetId": "ref.volatility_control_rules",
  "fields": [
    "venue",
    "asset_class",
    "instrument_set_id",
    "control_type",
    "valid_from",
    "band_ratio"
  ],
  "data": [
    {
      "asset_class": "stock",
      "band_ratio": "0.100000000000000000",
      "control_type": "volatility_interruption",
      "instrument_set_id": "xhkg-vcm-designated",
      "valid_from": "2016-08-22",
      "venue": "XHKG"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}