每日涨跌停价

数据集标识：ref.daily_price_limits；证券对象标识示例：XSHE:000001

每个标的逐交易日的涨停价与跌停价，跨资产类别同一形状：同时给出按涨跌幅规则推导的值与来源行情快照的观察值，有观察值时以观察值为准并标注两者是否一致；当日不设涨跌幅或规则无法判定时如实标注原因，不以默认比例代替。观察值从开始采集行情快照的交易日起才有，此前的行只有推导值。

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

接口

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

请求参数

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

参数名	类型	必填	说明
`asset_id`	`string`	否	筛选一个或多个标的标识（<场所码>:<代码>）。
`market`	`string`	否	市场代码；中文客户端默认 CN。
`start_date`	`date`	否	按交易日筛选，查询开始日期，包含该日。
`end_date`	`date`	否	按交易日筛选，查询结束日期，包含该日。

返回字段

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

字段名	中文名称	类型	可空	说明
`asset_id`	标的标识	`string`	否	与市场无关的标的标识，格式为 <场所码>:<代码>，场所码为 ISO 10383 MIC，例如 XSHE:000001。
`security_code`	证券代码	`string`	是	展示别名：带市场后缀的证券代码，例如 000001.SZ；由 asset_id 换算，场所没有展示后缀时为空，不作业务键。
`venue`	场所	`string`	否	标的挂牌的交易场所码（ISO 10383 MIC，如 XSHG），由 asset_id 导出。
`market`	市场	`string`	否	标的挂牌场所所在的市场，ISO 3166-1 alpha-2 代码，例如 CN；由 asset_id 的场所导出。
`trading_date`	交易日期	`date`	否	按交易场所本地时区确定的交易日。
`price_currency`	价格币种	`string`	否	本行各价格字段的币种：标的的计价币种。标的主数据就绪前取场所登记的唯一计价币种，场所登记多个或没有时构建报错。
`previous_close_price`	前收盘价	`decimal`	是	推导所用的前收盘价，不复权；为空表示来源未给出。
`limit_up_price`	涨停价	`decimal`	是	当日涨停价：有来源观察值时取观察值，否则取推导值；无涨跌幅限制或无法判定时为空。
`limit_down_price`	跌停价	`decimal`	是	当日跌停价：有来源观察值时取观察值，否则取推导值；无涨跌幅限制或无法判定时为空。
`limit_type`	涨跌幅类型	`string`	是	当日匹配到的涨跌幅规则的类型：ratio 按比例，absolute 按金额，none 不设涨跌幅（新上市或市场熔断等情形）；规则无法匹配时为空，原因写 unresolved_reason。
`limit_condition`	适用条件	`string`	是	推导所用的涨跌幅规则条件：regular 常规，risk_warning 风险警示，new_listing 上市初期；规则无法匹配时为空。
`unresolved_reason`	无法判定原因	`string`	是	推导无法给出涨跌停价的原因，例如 no_matching_rule（无匹配规则）、listing_day_unknown、listing_date_unknown、risk_warning_unknown、reference_price_missing；推导成功时为空。
`limit_value_basis`	涨跌停取值依据	`string`	是	observed 取自来源观察值，derived 按涨跌幅规则推导；两者都没有时为空。
`derived_limit_up_price`	推导涨停价	`decimal`	是	按交易规则表推导的涨停价：前收盘价乘以涨幅比例，按最小价格变动单位四舍五入。
`derived_limit_down_price`	推导跌停价	`decimal`	是	按交易规则表推导的跌停价：前收盘价乘以跌幅比例，按最小价格变动单位四舍五入，不低于一个最小变动单位。
`observed_limit_up_price`	观察涨停价	`decimal`	是	来源行情快照给出的当日涨停价；没有观察值的日期为空。
`observed_limit_down_price`	观察跌停价	`decimal`	是	来源行情快照给出的当日跌停价；没有观察值的日期为空。
`derivation_matches`	推导与观察一致	`boolean`	是	推导值与观察值是否完全相等；任一侧缺失时为空。不一致时以观察值为准，差异保留。
`rule_id`	涨跌幅规则标识	`string`	是	推导所用的涨跌幅规则（涨跌幅规则数据集中的一条）；规则无法匹配时为空。
`rules_version`	交易规则版本	`string`	否	推导所用规则表全部内容的 sha256；规则表变化即版本变化，已发布数据不随之改变。
`available_at`	可得时间	`timestamp`	是	平台取得该行全部输入的时间（来源请求的采集时间，取各输入中最晚者），与行情时间分开、不互相推算；为空表示至少一项输入的取得时间未核验。

字段补充属性

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

字段名	属性
`venue`	标准（`standard`）：ISO 10383
`price_currency`	标准（`standard`）：ISO 4217
`previous_close_price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`limit_up_price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`limit_down_price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`limit_type`	枚举（`allowedValues`）：["ratio", "absolute", "none"]
`limit_value_basis`	枚举（`allowedValues`）：["observed", "derived"]
`derived_limit_up_price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`derived_limit_down_price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`observed_limit_up_price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`observed_limit_down_price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency

请求示例

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

{
  "select": [
    "asset_id",
    "security_code",
    "trading_date",
    "previous_close_price",
    "limit_up_price",
    "limit_down_price",
    "limit_type",
    "limit_value_basis"
  ],
  "where": [
    {
      "field": "asset_id",
      "op": "eq",
      "value": "XSHE:000001"
    },
    {
      "field": "trading_date",
      "op": "gte",
      "value": "2026-10-28"
    },
    {
      "field": "trading_date",
      "op": "lte",
      "value": "2026-10-28"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例

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

{
  "datasetId": "ref.daily_price_limits",
  "fields": [
    "asset_id",
    "security_code",
    "trading_date",
    "previous_close_price",
    "limit_up_price",
    "limit_down_price",
    "limit_type",
    "limit_value_basis"
  ],
  "data": [
    {
      "asset_id": "XSHE:000001",
      "limit_down_price": "10.320000000000000000",
      "limit_type": "ratio",
      "limit_up_price": "12.620000000000000000",
      "limit_value_basis": "observed",
      "previous_close_price": "11.470000000000000000",
      "security_code": "000001.SZ",
      "trading_date": "2026-10-28"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}

接口​

请求参数​

返回字段​

字段补充属性​

请求示例​

响应示例​

接口

请求参数

返回字段

字段补充属性

请求示例

响应示例