跳到主要内容

价格档位表

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

按价格分段的最小价格变动单位：每张表由一段或多段组成，价格区间左闭右开；单一档位的表只有一段。最小价格变动单位也是涨跌停价的取整单位。

业务主键：tick_schedule_id、valid_from、price_from，每行取值唯一。

接口​

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

请求参数​

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

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

返回字段​

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

字段名中文名称类型可空说明
tick_schedule_id价格档位表标识string否价格档位表的唯一标识。
valid_from生效日期date否本段生效日，包含该日。
valid_to失效日期date是本段失效日，不含该日；为空表示至今有效。
price_from价格下限decimal否本段适用的价格下限，包含该值。
price_to价格上限decimal是本段适用的价格上限，不含该值；为空表示无上限。
tick_size最小价格变动单位decimal否本段申报价格的最小变动单位。
price_currency价格币种string否价格区间与变动单位的币种。
basis_document依据文件string否规则依据的业务规则名称与条款摘要。
evidence_sha256依据原件哈希string是依据原件内容的 sha256；尚未取得原件时为空。
verification_status核验状态string否verified 已有依据原件，unverified 尚未取得依据原件。
rules_version规则表版本string否规则表全部内容的 sha256；规则表变化即版本变化，已发布数据不随之改变。

字段补充属性​

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

字段名属性
price_from精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
price_to精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
tick_size精度（precision）：38；小数位数（scale）：18；单位（unit）：currency_field:price_currency
price_currency标准（standard）：ISO 4217
verification_status枚举（allowedValues）：["verified", "unverified"]

请求示例​

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

{
  "select": [
    "tick_schedule_id",
    "valid_from",
    "price_from",
    "price_to",
    "tick_size",
    "price_currency"
  ],
  "where": [
    {
      "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.tick_schedules",
  "fields": [
    "tick_schedule_id",
    "valid_from",
    "price_from",
    "price_to",
    "tick_size",
    "price_currency"
  ],
  "data": [
    {
      "price_currency": "CNY",
      "price_from": "0.000000000000000000",
      "price_to": null,
      "tick_schedule_id": "xshg-etf-1990",
      "tick_size": "0.001000000000000000",
      "valid_from": "1990-12-19"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}