每日交易参照

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

每个在市标的每个交易日一行，跨资产类别同一形状：汇总前收盘、涨跌停价、全天停牌、风险警示、盘中停牌、当日最大序号与适用的交易规则（最小变动单位、申报数量、当日回转），供回放撮合使用。任何一项没有依据时为空并说明原因，不推测；应有而缺输入的标的交易日计为数据缺失。

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

接口

用途	方法与路径
查询数据	`POST /v1/datasets/ref.daily_trading_reference/query`
契约与当前发布	`GET /v1/datasets/ref.daily_trading_reference`
准备批量快照	`POST /v1/datasets/ref.daily_trading_reference/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 不设涨跌幅；规则无法匹配时为空。
`limit_value_basis`	涨跌停取值依据	`string`	是	observed 来源观察值，derived 规则推导。
`risk_warning_status`	风险警示状态	`string`	是	与每日交易状态同口径。当日风险警示状态：none 无，st、star_st 分别为 ST 与 ST，risk_warning 已处于风险警示但来源分不出 ST 与 ST（只有逐日标志的日子，以及名称带退市标记的退市整理期）；无依据时为空，不以当前快照回填。风险警示只适用于股票，其他资产类别为空。取值登记在参照模型的登记表中，以后可增。
`risk_warning_basis`	风险警示依据	`string`	是	与每日交易状态同口径。name 由当日证券简称判定（可区分 ST 与 *ST），daily_flag 由来源逐日风险警示标志判定；两种依据同日不一致时以简称为准；状态未知时为空。
`suspension_status`	停牌状态	`string`	是	与每日交易状态同口径。trading 当日正常交易（含无成交），suspended 全天停牌；无逐日交易状态时为空。
`intraday_halt_status`	盘中停牌状态	`string`	否	none 停复牌公告已覆盖且无盘中停牌，observed 有盘中停牌且时刻已知，time_unverified 有盘中停牌但时刻未知，unverified 当日停复牌公告未覆盖。
`intraday_halt_intervals`	盘中停牌区间	`string`	是	盘中停牌区间列表，交易所本地时间 HH:MM:SS-HH:MM:SS，多段以分号分隔；仅在时刻已知时给出，明细见标的盘中临时停牌数据集。
`last_seq`	当日最大序号	`integer`	是	当日分钟与竞价记录的最大序号：由交易时段与停牌区间决定，无成交分钟与未成交的竞价照常编号；全天停牌为 0，停牌状态或停牌时刻未知时为空。序号缺口表示数据缺失而非无成交。
`tick_size`	最小价格变动单位	`decimal`	是	前收盘价所在价格档位的最小变动单位；价格档位表有多段且当日没有前收盘价时为空。
`min_order_quantity`	最小申报数量	`integer`	是	单笔买入申报的最小数量，单位为股或份；按标的每手数量时为空。
`order_quantity_step`	申报递增单位	`integer`	是	超出最小申报数量部分的递增单位；卖出时不足最小数量的余额一次性卖出。按标的每手数量时为空。
`intraday_round_trip`	当日回转	`string`	否	allowed 当日买入可当日卖出，forbidden 次一交易日起才可卖出。
`bar_definition_version`	K 线定义版本	`string`	否	计算 last_seq 所用 K 线定义的版本。
`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"]
`risk_warning_basis`	枚举（`allowedValues`）：["name", "daily_flag"]
`suspension_status`	枚举（`allowedValues`）：["trading", "suspended"]
`intraday_halt_status`	枚举（`allowedValues`）：["none", "observed", "time_unverified", "unverified"]
`tick_size`	精度（`precision`）：38；小数位数（`scale`）：18
`intraday_round_trip`	枚举（`allowedValues`）：["allowed", "forbidden"]

请求示例

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

{
  "select": [
    "asset_id",
    "trading_date",
    "previous_close_price",
    "limit_up_price",
    "limit_down_price",
    "suspension_status",
    "intraday_halt_status",
    "last_seq",
    "tick_size"
  ],
  "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_trading_reference",
  "fields": [
    "asset_id",
    "trading_date",
    "previous_close_price",
    "limit_up_price",
    "limit_down_price",
    "suspension_status",
    "intraday_halt_status",
    "last_seq",
    "tick_size"
  ],
  "data": [
    {
      "asset_id": "XSHE:000001",
      "intraday_halt_status": "none",
      "last_seq": 243,
      "limit_down_price": "10.320000000000000000",
      "limit_up_price": "12.620000000000000000",
      "previous_close_price": "11.470000000000000000",
      "suspension_status": "trading",
      "tick_size": "0.010000000000000000",
      "trading_date": "2026-10-28"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}

接口​

请求参数​

返回字段​

字段补充属性​

请求示例​

响应示例​

接口

请求参数

返回字段

字段补充属性

请求示例

响应示例