集合竞价记录

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

交易所权益类标的每个交易日的开盘与收盘集合竞价：撮合时刻、唯一成交价、成交量与成交额，与 1 分钟 K 线共用当日序号。竞价窗口内撮合之前报出的成交不是竞价成交，不并入，按 K 线定义归连续竞价最后一根 K 线；盘后固定价格成交不在本数据集。成员资产类别：股票（stock）与 ETF（etf），两者每个字段的含义与单位相同；指数不在内。本数据集与 1 分钟 K 线同一次构建产出，只经批量交付提供，不支持逐行查询。

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

接口

用途	方法与路径
查询数据	`POST /v1/datasets/equity.auction_trades/query`
契约与当前发布	`GET /v1/datasets/equity.auction_trades`
准备批量快照	`POST /v1/datasets/equity.auction_trades/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`	否	按交易场所本地时区确定的交易日。
`auction_type`	竞价类型	`string`	否	opening 开盘集合竞价，closing 收盘集合竞价。当日交易时段没有收盘集合竞价（如上交所 2018-08-20 前）时没有该行。
`executed_at`	撮合时刻	`timestamp`	否	集合竞价的撮合时刻（该竞价最后一个阶段的结束时刻），带场所时区；按 UTC 返回。
`seq`	序号	`integer`	是	与 1 分钟 K 线同一序列的序号；停牌中的竞价不编号，为空。
`price`	成交价	`decimal`	是	集合竞价的唯一成交价；无成交或停牌时为空。
`volume`	成交量	`decimal`	否	成交数量，单位见 quantity_unit；无成交时为 0。
`turnover`	成交金额	`decimal`	否	成交金额，币种见 price_currency；无成交时为 0。取自来源的分钟金额，不是交易所逐笔精确值；当日常规时段合计与交易所日成交额相差在后者的十万分之一（10 ppm）以内，当日才判为完整。
`price_currency`	价格币种	`string`	否	本行价格与成交金额的币种：标的的计价币种。标的主数据就绪前取场所登记的唯一计价币种，场所登记多个或没有时构建报错。
`quantity_unit`	数量单位	`string`	否	成交量的基础数量单位；股票为股，ETF 为份，统一代码 share。
`trade_status`	成交状态	`string`	否	trading 有成交，no_trade 未停牌但未成交，halted 撮合时刻处于停牌中。
`bar_definition_version`	K 线定义版本	`string`	否	解释本行所用 K 线定义的版本；定义原文与 sha256 见 K 线定义登记。
`available_at`	可得时间	`timestamp`	是	平台取得该行全部来源输入的时间（各来源请求的采集时间中最晚者），与行情时间分开、不互相推算；为空表示至少一项输入的取得时间未核验。

字段补充属性

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

字段名	属性
`venue`	标准（`standard`）：ISO 10383
`auction_type`	枚举（`allowedValues`）：["opening", "closing"]
`price`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`volume`	精度（`precision`）：38；小数位数（`scale`）：18
`turnover`	精度（`precision`）：38；小数位数（`scale`）：18；单位（`unit`）：currency_field:price_currency
`price_currency`	标准（`standard`）：ISO 4217
`quantity_unit`	枚举（`allowedValues`）：["share"]
`trade_status`	枚举（`allowedValues`）：["trading", "no_trade", "halted"]

请求示例

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

{
  "select": [
    "asset_id",
    "trading_date",
    "auction_type",
    "executed_at",
    "seq",
    "price",
    "volume",
    "turnover",
    "trade_status"
  ],
  "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": "equity.auction_trades",
  "fields": [
    "asset_id",
    "trading_date",
    "auction_type",
    "executed_at",
    "seq",
    "price",
    "volume",
    "turnover",
    "trade_status"
  ],
  "data": [
    {
      "asset_id": "XSHE:000001",
      "auction_type": "opening",
      "executed_at": "2026-10-28T01:25:00Z",
      "price": "11.430000000000000000",
      "seq": 1,
      "trade_status": "trading",
      "trading_date": "2026-10-28",
      "turnover": "22451949.000000000000000000",
      "volume": "1964300.000000000000000000"
    }
  ],
  "page": {
    "nextCursor": null,
    "complete": true
  }
}

接口​

请求参数​

返回字段​

字段补充属性​

请求示例​

响应示例​

接口

请求参数

返回字段

字段补充属性

请求示例

响应示例