股票竞价分笔接口文档

返回股票集合竞价分笔数据；传 `trademin` 和 `side` 可查询指定时点前后的全市场快照。

请求参数

• apiname（string（daily_auc_detail），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（any，必选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• symbols（string|array<string>，普通模式必选）：一个或多个股票代码，支持单个代码、英文逗号分隔字符串或数组；快照模式不传时查询全市场股票。
• tradedate（string，可选）：查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。
• startdate（string，可选）：查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。 普通历史明细的日期范围跨月时，只查询结束日期所在月份：开始日期调整为该月第一天，结束日期不变；同月和单日范围不变。例如 20241225–20250403 实际查询 20250401–20250403；成功或无数据响应的 message 会说明请求和实际范围。需要完整跨月数据时，请按月分别请求并合并，分页也在各月内进行；结束月份无数据时不回退到其他月份。
• enddate（string，可选）：查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。 跨月时保留该结束日期，仅调整开始日期至结束月份第一天。
• recentdays（integer，可选）：最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 解析出的范围跨月时，仅查询结束月份第一天至结束日期，实际返回可能不足 N 个交易日。
• tradedate_offset（integer，可选）：相对最新交易日的单日偏移，0 表示最新交易日，-1 表示上一交易日。
• order_dir（string（asc / desc），可选）：普通分笔模式按日期和时间排序，asc=升序、desc=降序。
• limit（integer，可选）：返回条数。普通分笔模式默认 500，快照模式默认 6000；最大 6000。
• offset（integer，可选）：偏移量，用于翻页。
• trademin（string，快照模式必选）：竞价分钟，格式 HHMM，例如 0917。普通分笔模式用于限定该分钟；快照模式与 side 组成边界条件。
• side（string（before / after），快照模式必选）：快照方向。before 取边界前最后一条，after 取边界后或等于边界的第一条；仅支持单个交易日。
• start_time（string，可选）：普通分笔模式的起始时间，格式 HH:MM:SS，默认 09:15:00；不能与 trademin 同时传。
• end_time（string，可选）：普通分笔模式的结束时间，格式 HH:MM:SS，默认 09:26:00；不能与 trademin 同时传。

返回字段

• tradedate（string）：日期格式：YYYYMMDD。
• symbol（string）：6 位股票代码。
• time（string）：集合竞价时段时间，格式：HH:mm:ss。
• m_price（number|null）：该分笔时点的集合竞价撮合价格。
• auc_pct_chg（number|null）：竞价撮合价相对上一交易日收盘价的涨幅。
• auc_vol（number|null）：该分笔时点的竞价成交量。
• auc_amt（number|null）：该分笔时点的竞价成交金额。
• um_vol（number|null）：买卖二档剩余委托量的较大值。
• um_side（string|null）：b=买方、s=卖方；两侧相等、双零、双侧缺失或无法可靠判断时返回 null。
• auc_turnover_rate（number|null）：竞价成交量按流通股本计算的换手率。
• auc_turnover（number|null）：竞价成交量按自由流通股本计算的换手率。
• auc_to_pre_vol_pct（number|null）：竞价成交量 ÷ 昨日全天成交量 × 100。