竞价分笔
根据服务、资产与周期选择本接口。先核对请求参数,再用响应字段和单位解释结果。
正式接口(竞价分笔) · 正式接口(竞价分笔) · meoz 接口目录
返回股票集合竞价分笔数据;传 trademin 和 side 可查询指定时点前后的全市场快照。
接口名称 daily_auc_detail
请求方法 POST /api
- https://sz.meoz.cn:6688
- https://sh.meoz.cn:6688
返回字段
| 字段 | 名称 | 类型 | 描述 | 单位 |
|---|---|---|---|---|
| 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。 |
请求
{"content":{"application/json":{"example":{"apikey":"","apiname":"daily_auc_detail","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":{"limit":6000,"side":"before","tradedate":"20260724","trademin":"0925"}},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"apiname":{"default":"daily_auc_detail","description":"接口名称","enum":["daily_auc_detail"],"type":"string"},"fields":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"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","description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `tradedate` | `string` | 交易日期 | `20260724` | 日期格式:YYYYMMDD。 |\n| `symbol` | `string` | 股票代码 | `600000` | 6 位股票代码。 |\n| `time` | `string` | 竞价时间 | `09:25:00` | 集合竞价时段时间,格式:HH:mm:ss。 |\n| `m_price` | `number\\|null` | 竞价撮合价(元) | `10.32` | 该分笔时点的集合竞价撮合价格。 |\n| `auc_pct_chg` | `number\\|null` | 竞价涨幅(%) | `1.23` | 竞价撮合价相对上一交易日收盘价的涨幅。 |\n| `auc_vol` | `number\\|null` | 竞价成交量(手) | `562300` | 该分笔时点的竞价成交量。 |\n| `auc_amt` | `number\\|null` | 竞价金额(元) | `58000000.25` | 该分笔时点的竞价成交金额。 |\n| `um_vol` | `number\\|null` | 未匹配量(手) | `186500` | 买卖二档剩余委托量的较大值。 |\n| `um_side` | `string\\|null` | 未匹配方向 | `b` | b=买方、s=卖方;两侧相等、双零、双侧缺失或无法可靠判断时返回 null。 |\n| `auc_turnover_rate` | `number\\|null` | 竞价换手率(%) | `0.12` | 竞价成交量按流通股本计算的换手率。 |\n| `auc_turnover` | `number\\|null` | 真实竞价换手率(%) | `0.18` | 竞价成交量按自由流通股本计算的换手率。 |\n| `auc_to_pre_vol_pct` | `number\\|null` | 竞昨成交比(%) | `4.35` | 竞价成交量 ÷ 昨日全天成交量 × 100。 |"},"params":{"anyOf":[{"required":["symbols"]},{"required":["trademin","side"]}],"default":{"limit":6000,"side":"before","tradedate":"20260724","trademin":"0925"},"description":"| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbols` | `string\\|array` | 普通模式必选 | `600000,000001` | 一个或多个股票代码,支持单个代码、英文逗号分隔字符串或数组;快照模式不传时查询全市场股票。 |\n| `tradedate` | `string` | 可选 | `20260724` | 查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 |\n| `startdate` | `string` | 可选 | `20260701` | 查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。 普通历史明细的日期范围跨月时,只查询结束日期所在月份:开始日期调整为该月第一天,结束日期不变;同月和单日范围不变。例如 20241225–20250403 实际查询 20250401–20250403;成功或无数据响应的 message 会说明请求和实际范围。需要完整跨月数据时,请按月分别请求并合并,分页也在各月内进行;结束月份无数据时不回退到其他月份。 |\n| `enddate` | `string` | 可选 | `20260724` | 查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。 跨月时保留该结束日期,仅调整开始日期至结束月份第一天。 |\n| `recentdays` | `integer` | 可选 | `5` | 最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 解析出的范围跨月时,仅查询结束月份第一天至结束日期,实际返回可能不足 N 个交易日。 |\n| `tradedate_offset` | `integer` | 可选 | `-1` | 相对最新交易日的单日偏移,0 表示最新交易日,-1 表示上一交易日。 |\n| `order_dir` | `string` | 可选 | `asc` | 普通分笔模式按日期和时间排序,asc=升序、desc=降序。 |\n| `limit` | `integer` | 可选 | `500` | 返回条数。普通分笔模式默认 500,快照模式默认 6000;最大 6000。 |\n| `offset` | `integer` | 可选 | `0` | 偏移量,用于翻页。 |\n| `trademin` | `string` | 快照模式必选 | `0917` | 竞价分钟,格式 HHMM,例如 0917。普通分笔模式用于限定该分钟;快照模式与 side 组成边界条件。 |\n| `side` | `string` | 快照模式必选 | `before` | 快照方向。before 取边界前最后一条,after 取边界后或等于边界的第一条;仅支持单个交易日。 |\n| `start_time` | `string` | 可选 | `09:15:00` | 普通分笔模式的起始时间,格式 HH:MM:SS,默认 09:15:00;不能与 trademin 同时传。 |\n| `end_time` | `string` | 可选 | `09:26:00` | 普通分笔模式的结束时间,格式 HH:MM:SS,默认 09:26:00;不能与 trademin 同时传。 |","properties":{"end_time":{"description":"普通分笔模式的结束时间,格式 HH:MM:SS,默认 09:26:00;不能与 trademin 同时传。","example":"09:26:00","type":"string"},"enddate":{"description":"查询区间结束日期,格式:YYYYMMDD;仅传该参数时按该交易日查询。 跨月时保留该结束日期,仅调整开始日期至结束月份第一天。","example":"20260724","pattern":"^\\d{8}$","type":"string"},"limit":{"description":"返回条数。普通分笔模式默认 500,快照模式默认 6000;最大 6000。","example":500,"maximum":6000,"minimum":1,"type":"integer"},"offset":{"default":0,"description":"偏移量,用于翻页。","example":0,"minimum":0,"type":"integer"},"order_dir":{"default":"asc","description":"普通分笔模式按日期和时间排序,asc=升序、desc=降序。","enum":["asc","desc"],"example":"asc","type":"string"},"recentdays":{"description":"最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 解析出的范围跨月时,仅查询结束月份第一天至结束日期,实际返回可能不足 N 个交易日。","example":5,"minimum":1,"type":"integer"},"side":{"description":"快照方向。before 取边界前最后一条,after 取边界后或等于边界的第一条;仅支持单个交易日。","enum":["before","after"],"example":"before","type":"string"},"start_time":{"description":"普通分笔模式的起始时间,格式 HH:MM:SS,默认 09:15:00;不能与 trademin 同时传。","example":"09:15:00","type":"string"},"startdate":{"description":"查询区间开始日期,格式:YYYYMMDD;仅传该参数时查询至最新交易日。 普通历史明细的日期范围跨月时,只查询结束日期所在月份:开始日期调整为该月第一天,结束日期不变;同月和单日范围不变。例如 20241225–20250403 实际查询 20250401–20250403;成功或无数据响应的 message 会说明请求和实际范围。需要完整跨月数据时,请按月分别请求并合并,分页也在各月内进行;结束月份无数据时不回退到其他月份。","example":"20260701","pattern":"^\\d{8}$","type":"string"},"symbols":{"description":"一个或多个股票代码,支持单个代码、英文逗号分隔字符串或数组;快照模式不传时查询全市场股票。","example":"600000,000001","oneOf":[{"description":"单个或多个逗号分隔股票代码","type":"string"},{"description":"股票代码数组","items":{"type":"string"},"type":"array"}]},"tradedate":{"description":"查询单个交易日,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。","example":"20260724","pattern":"^\\d{8}$","type":"string"},"tradedate_offset":{"description":"相对最新交易日的单日偏移,0 表示最新交易日,-1 表示上一交易日。","example":-1,"maximum":0,"type":"integer"},"trademin":{"description":"竞价分钟,格式 HHMM,例如 0917。普通分笔模式用于限定该分钟;快照模式与 side 组成边界条件。","example":"0917","type":"string"}},"type":"object"}},"required":["apikey","apiname","params"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apiname` | `string` | 必选 | `daily_auc_detail` | 接口名称 |\n| `apikey` | `string` | 必选 | [访问个人中心获取](/console) | 访问密钥 |","required":true}
响应
{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"竞价明细返回数据","nullable":true,"properties":{"fields":{"description":"返回字段名列表,顺序与 items 中每一列一一对应","example":["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":{"type":"string"},"type":"array"},"items":{"description":"二维数组数据,每一行代表一条竞价分笔明细记录","example":[["20260724","600000","09:25:00",10.32,1.23,562300,58000000.25,186500,"b",0.12,0.18,4.35]],"items":{"items":{},"type":"array"},"type":"array"}},"required":["fields","items"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}