跳到主要内容

标的盘中临时停牌

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

单个标的的盘中临时停牌区间：每个被部分停牌的交易日一行；全天停牌见每日交易状态，场所、板块或品种级的中断不在本数据集。来源只标出当日有临时停牌而不给时刻时，时刻为空并标为时刻未核实，不编造时刻，也不写成无停牌。某交易日没有行，只有在当日停复牌公告查询已覆盖时才表示无盘中停牌，否则为未核实，见每日交易参照的 intraday_halt_status。

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

接口​

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

请求参数​

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

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

返回字段​

列名保持契约原名，可直接用于 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否按交易场所本地时区确定的交易日。
halt_seq临停序号integer否标的当日盘中临时停牌的序号，按停牌开始时刻从 1 编号；来源不给时刻的临停当日只有一条，序号为 1。
halt_start_at停牌开始时刻timestamp是盘中停牌开始时刻；"开市起停牌"取当日开盘集合竞价开始时刻。来源只标出临时停牌而不给时刻时为空。
halt_end_at复牌时刻timestamp是复牌时刻，停牌区间为 [停牌开始时刻, 复牌时刻)；来源未给出时为空。
time_status时刻核验状态string否observed 开始与复牌时刻均来自来源；end_unknown 来源未给出复牌时刻；time_unverified 来源只标出当日有临时停牌、不给时刻。
halt_reason停牌原因类别string否停牌原因的归类：regulatory 监管要求，volatility_interruption 异常波动或盘中临时停牌，circuit_breaker 熔断，news_pending 待披露重要事项，technical 技术故障，weather 天气等不可抗力，other 其他；原文见 halt_reason_text。
halt_reason_text停牌原因原文string是来源公告给出的停牌原因原文；来源未给出时为空。
source公告来源string否停复牌公告的来源：szse 深圳证券交易所停复牌提示，sse 上海证券交易所停复牌信息。
available_at可得时间timestamp是平台取得该行全部输入的时间（来源请求的采集时间，取各输入中最晚者），与行情时间分开、不互相推算；为空表示至少一项输入的取得时间未核验。

字段补充属性​

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

字段名属性
venue标准（standard）：ISO 10383
time_status枚举（allowedValues）：["observed", "end_unknown", "time_unverified"]
halt_reason枚举（allowedValues）：["regulatory", "volatility_interruption", "circuit_breaker", "news_pending", "technical", "weather", "other"]
source枚举（allowedValues）：["szse", "sse"]

请求示例​

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

{
  "select": [
    "asset_id",
    "trading_date",
    "halt_start_at",
    "halt_end_at",
    "time_status",
    "halt_reason"
  ],
  "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.trading_halts",
  "fields": [
    "asset_id",
    "trading_date",
    "halt_start_at",
    "halt_end_at",
    "time_status",
    "halt_reason"
  ],
  "data": [
    {
      "asset_id": "XSHE:000001",
      "halt_end_at": "2026-10-28T11:00:00+08:00",
      "halt_reason": "volatility_interruption",
      "halt_start_at": "2026-10-28T10:30:00+08:00",
      "time_status": "observed",
      "trading_date": "2026-10-28"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}