申报规则

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

按「场所 × 资产类别 × 子类 × 板块 × 品种 × 生效区间」的申报规则：价格档位表、申报数量的下限与递增单位、零股卖出方式与申报价格有效范围。同一标的同一交易日恰好匹配一条；尚未取得依据的项为空，不以默认值代替。

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

接口

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

请求参数

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

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

返回字段

列名保持契约原名，可直接用于 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`	是	规则失效日，不含该日；为空表示至今有效。
`tick_schedule_id`	价格档位表	`string`	否	适用的价格档位表标识，见价格档位表数据集。
`quantity_basis`	数量依据	`string`	否	fixed 按本规则的数量，instrument_lot 按标的主数据的每手数量。
`min_order_quantity`	最小申报数量	`integer`	是	单笔买入申报的最小数量，单位为标的的数量单位（股、份、张）；按标的每手数量时为空。
`order_quantity_step`	申报递增单位	`integer`	是	超出最小申报数量部分的递增单位；按标的每手数量时为空。
`max_order_quantity`	最大申报数量	`integer`	是	单笔申报的最大数量；尚未取得依据时为空。
`odd_lot_sell`	零股卖出	`string`	否	whole_remainder 不足最小数量的余额一次性卖出，odd_lot_market 在零股市场卖出，unrestricted 不限。
`price_band_reference`	申报价格基准	`string`	是	申报价格有效范围的基准：none 不设范围，last_price 最新成交价，best_quote 最优报价，reference_price 参考价；尚未取得依据时为空。
`price_band_ratio`	申报价格范围比例	`decimal`	是	申报价格相对基准的最大偏离比例；不适用或尚未取得依据时为空。
`price_band_ticks`	申报价格范围档数	`integer`	是	申报价格相对基准的最大偏离档数；不适用或尚未取得依据时为空。
`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
`quantity_basis`	枚举（`allowedValues`）：["fixed", "instrument_lot"]
`odd_lot_sell`	枚举（`allowedValues`）：["whole_remainder", "odd_lot_market", "unrestricted"]
`price_band_reference`	枚举（`allowedValues`）：["none", "last_price", "best_quote", "reference_price"]
`price_band_ratio`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：ratio
`verification_status`	枚举（`allowedValues`）：["verified", "unverified"]

请求示例

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

{
  "select": [
    "venue",
    "market_segment",
    "valid_from",
    "tick_schedule_id",
    "min_order_quantity",
    "order_quantity_step"
  ],
  "where": [
    {
      "field": "venue",
      "op": "eq",
      "value": "XSHG"
    },
    {
      "field": "valid_from",
      "op": "gte",
      "value": "2019-07-22"
    },
    {
      "field": "valid_from",
      "op": "lte",
      "value": "2019-07-22"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例

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

{
  "datasetId": "ref.order_rules",
  "fields": [
    "venue",
    "market_segment",
    "valid_from",
    "tick_schedule_id",
    "min_order_quantity",
    "order_quantity_step"
  ],
  "data": [
    {
      "market_segment": "star",
      "min_order_quantity": 200,
      "order_quantity_step": 1,
      "tick_schedule_id": "xshg-stock-1996",
      "valid_from": "2019-07-22",
      "venue": "XSHG"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}

接口​

请求参数​

返回字段​

字段补充属性​

请求示例​

响应示例​

接口

请求参数

返回字段

字段补充属性

请求示例

响应示例