股票停复牌状态

数据集标识：stock.trading_status；证券对象标识示例：XSHE:000004

股票逐日交易状态快照：每个交易日每只证券一行，suspend_type 说明当日是否处于停牌状态。

接口

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

请求参数

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

参数名	类型	必填	说明
asset_id	string	否	筛选一个或多个标的标识（<场所码>:<代码>）。
security_code	string	否	筛选一个或多个证券代码。
start_date	date	否	查询开始日期，包含该日。
end_date	date	否	查询结束日期，包含该日。

返回字段

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

字段名	中文名称	类型	可空	说明
asset_id	标的标识	string	否	与市场无关的标的标识，格式为 <场所码>:<代码>，场所码为 ISO 10383 MIC，例如 XSHE:000001。
security_code	证券代码	string	否	展示别名：带市场后缀的证券代码，例如 000001.SZ；由 asset_id 换算，不作业务键。
market	市场	string	否	标的挂牌场所所在的市场，ISO 3166-1 alpha-2 代码，例如 CN；由 asset_id 的场所导出。
trading_date	交易日期	date	否	按交易场所本地时区确定的交易日。
suspend_timing	日内停牌时间段	string	是	日内停牌时间段；第一批不供数：来源不提供日内停牌时段
suspend_type	停复牌类型	string	否	trading 正常交易，suspended 停牌。

字段补充属性

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

字段名	属性
suspend_type	枚举（allowedValues）：["trading", "suspended"]

请求示例

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

{
  "select": [
    "asset_id",
    "security_code",
    "trading_date",
    "suspend_timing",
    "suspend_type"
  ],
  "where": [
    {
      "field": "asset_id",
      "op": "eq",
      "value": "XSHE:000004"
    },
    {
      "field": "trading_date",
      "op": "gte",
      "value": "2026-04-28"
    },
    {
      "field": "trading_date",
      "op": "lte",
      "value": "2026-04-28"
    }
  ],
  "page": {
    "limit": 1000,
    "cursor": null
  }
}

响应示例

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

{
  "datasetId": "stock.trading_status",
  "fields": [
    "asset_id",
    "security_code",
    "trading_date",
    "suspend_timing",
    "suspend_type"
  ],
  "data": [
    {
      "asset_id": "XSHE:000004",
      "security_code": "000004.SZ",
      "suspend_timing": null,
      "suspend_type": "suspended",
      "trading_date": "2026-04-28"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}