返回股票集合竞价分笔数据；传 `trademin` 和 `side` 可查询指定时点前后的全市场快照。
POST
/apiapiname:daily_auc_detail生产专线（默认）深圳
http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apiname | string（daily_auc_detail） | 必选 | daily_auc_detail | 固定接口名称，用于选择对应的数据能力。 |
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。 |
fields | string|null | 可选 | tradedate,symbol,time,m_price,auc_pct_chg,auc_vol,auc_amt,um_vol,um_side,auc_turnover_rate,auc_turnover,auc_to_pre_vol_pct | 需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。 |
params | any | 必选 | {"tradedate":"20260724","limit":6000,"trademin":"0925","side":"before"} | 查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。 |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
symbols | string|array<string> | 普通模式必选 | 600000,000001 | 一个或多个股票代码，支持单个代码、英文逗号分隔字符串或数组；快照模式不传时查询全市场股票。 |
tradedate | string | 可选 | 20260724 | 查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 |
startdate | string | 可选 | 20260701 | 查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。 |
enddate | string | 可选 | 20260724 | 查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。 |
recentdays | integer | 可选 | 5 | 最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 |
tradedate_offset | integer | 可选 | -1 | 相对最新交易日的单日偏移，0 表示最新交易日，-1 表示上一交易日。 |
order_dir | string（asc / desc） | 可选 | asc | 普通分笔模式按日期和时间排序，asc=升序、desc=降序。 |
limit | integer | 可选 | 500 | 返回条数。普通分笔模式默认 500，快照模式默认 6000；最大 6000。 |
offset | integer | 可选 | 0 | 偏移量，用于翻页。 |
trademin | string | 快照模式必选 | 0917 | 竞价分钟，格式 HHMM，例如 0917。普通分笔模式用于限定该分钟；快照模式与 side 组成边界条件。 |
side | string（before / after） | 快照模式必选 | before | 快照方向。before 取边界前最后一条，after 取边界后或等于边界的第一条；仅支持单个交易日。 |
start_time | string | 可选 | 09:15:00 | 普通分笔模式的起始时间，格式 HH:MM:SS，默认 09:15:00；不能与 trademin 同时传。 |
end_time | string | 可选 | 09:26:00 | 普通分笔模式的结束时间，格式 HH:MM:SS，默认 09:26:00；不能与 trademin 同时传。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
tradedate | string | 交易日期 | 20260724 | 日期格式：YYYYMMDD。 |
symbol | string | 股票代码 | 600000 | 6 位股票代码。 |
time | string | 竞价时间 | 09:25:00 | 集合竞价时段时间，格式：HH:mm:ss。 |
m_price | number|null | 竞价撮合价（元） | 10.32 | 该分笔时点的集合竞价撮合价格。 |
auc_pct_chg | number|null | 竞价涨幅（%） | 1.23 | 竞价撮合价相对上一交易日收盘价的涨幅。 |
auc_vol | number|null | 竞价成交量（手） | 562300 | 该分笔时点的竞价成交量。 |
auc_amt | number|null | 竞价金额（元） | 58000000.25 | 该分笔时点的竞价成交金额。 |
um_vol | number|null | 未匹配量（手） | 186500 | 买卖二档剩余委托量的较大值。 |
um_side | string|null | 未匹配方向 | b | b=买方、s=卖方；两侧相等、双零、双侧缺失或无法可靠判断时返回 null。 |
auc_turnover_rate | number|null | 竞价换手率（%） | 0.12 | 竞价成交量按流通股本计算的换手率。 |
auc_turnover | number|null | 真实竞价换手率（%） | 0.18 | 竞价成交量按自由流通股本计算的换手率。 |
auc_to_pre_vol_pct | number|null | 竞昨成交比（%） | 4.35 | 竞价成交量 ÷ 昨日全天成交量 × 100。 |
请求与响应样例
固定样例
{
"apiname": "daily_auc_detail",
"apikey": "YOUR_API_KEY",
"fields": "tradedate,symbol,time,m_price,auc_pct_chg,auc_vol,auc_amt,um_vol,um_side,auc_turnover_rate,auc_turnover,auc_to_pre_vol_pct",
"params": {
"tradedate": "20260724",
"limit": 6000,
"trademin": "0925",
"side": "before"
}
}{
"code": 200,
"message": "success",
"data": {
"fields": [
"tradedate",
"symbol",
"time",
"m_price",
"auc_pct_chg",
"auc_vol",
"auc_amt",
"um_vol",
"um_side",
"auc_turnover_rate",
"auc_turnover",
"auc_to_pre_vol_pct"
],
"items": [
[
"20260724",
"600000",
"09:25:00",
10.32,
1.23,
562300,
58000000.25,
186500,
"b",
0.12,
0.18,
4.35
]
]
}
}