---
title: "集合竞价（当日分时 / 历史逐笔 / 竞价量额）"
method: GET
path: "/v1/auction"
tags: ["pro"]
---

# 集合竞价（当日分时 / 历史逐笔 / 竞价量额）

`GET /v1/auction`

## Request

- Base URL: `https://api.ashareapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ashareapi.com/v1/auction`
- Auth: none declared

**短线集合竞价**：个股 9:15–9:25 集合竞价数据，含**「竞价触及涨停」判定**。

`mode` 取值：
· `stock` **当日竞价分时**（默认）—— 09:15–09:25 逐笔（分钟级 tick）；每行 `time` 时间 / `price` 价 / `stage` 行情源标记位（**语义未公开，请勿依赖**；如需区分可撤单 / 不可撤单段请直接用 `time`：09:15–09:20 可撤单 · 09:20–09:25 不可撤单）/ `volume` 累计量
· `stock-history` **历史竞价分时**（**秒级**逐笔）—— 需 `date`（YYYY-MM-DD，真实交易日）；每行 `time`（含秒）/ `price` / `volume`
· `volume` **当日竞价量 / 资金净额**（单点）—— 返回 1 行：`bid_volume` 竞价量（手）/ `bid_amount` 竞价净额（元）

⭐ **`is_limit_up`（顶层 `meta`）= 「竞价触及涨停」判定** —— 判据 = 竞价段最高价 ≥ 涨停价（**涨停价取自行情源原始字段，非推算** ⇒ 主板 10% / 创业板科创 20% / ST 5% / 北交所 30% 差异自动正确）。
`meta` 另含 `up_px` 涨停价 / `down_px` 跌停价 / `open_px` 09:25 撮合价（开盘价）/ `preclose_px` 昨收 / `hprice` 竞价段最高价。

⚠️ **`mode=stock` 仅当日**（上游限制）；历史请用 `mode=stock-history`。
⚠️ **`mode=stock` 的点数因标的与市场而异**（同一时段不同票点数不同，由行情节奏决定）—— 需要票与票之间**颗粒度统一**时，请**按分钟取最后一条**自行归一（09:15–09:24 每票 ≤10 点）。
⚠️ 9:15–9:25 为竞价时段；**盘前/盘后** `mode=stock` 仍可取（竞价时段结束后数据保留）。
⚠️ `data` 恒为**行数组**（可直接落 DataFrame）；标的级信息在顶层 `meta`。

## Query parameters

- `mode` string: stock 当日分时 / stock-history 历史逐笔（需 date）/ volume 竞价量额
- `code` string, required: 股票代码：sh600667 或 600667（裸码/带前缀均可）
- `date` string: 历史日期（YYYY-MM-DD）；仅 mode=stock-history 必填

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ashareapi/apis/a-api.md) · [All operations](https://skmtc.dev/ashareapi/apis/a-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ashareapi/apis/a-api/revisions/fc57bdcb13d5?raw)