单股大单聚合查询

来源同步：/Users/mac/Projects/chatgpt-codex/doc/api_MonitorAgg.md

所属接口集：盘中监控

请求 URL

GET /v1/api/monitor/agg

认证方式

Bearer Token（详见 认证与签名）

接口概述

聚合当日盘中监控数据（买卖次数、净流量、收盘价、涨跌幅等），并可返回近端的买卖明细。数据源仅为 Redis（当天）或 MySQL（历史），不再回退数据库。支持分页、时间窗口过滤、明细最小换手率过滤、竞价/盘后/午间修补明细控制。

请求参数

参数	类型	必填	说明
day	string	否	交易日 YYYYMMDD，默认今日
codes	string	否	逗号分隔的股票代码或中文名称关键词；不提供则从 Redis 当日集合自动发现
details	int	否	返回每侧明细条数（每股买/卖/中间各返回最多 details 条），默认 0（不返回明细）
details_side	string	否	both（默认）/ buy / sell，控制返回哪一侧明细
details_order	string	否	asc（默认）/ desc，明细排序方向
from_ts	string	否	时间窗口起始，支持 HH:MM[:SS] 或完整时间 YYYY-MM-DD HH:MM:SS
to_ts	string	否	时间窗口结束，格式同 from_ts
include_closeauction	bool-like	否	包含收盘竞价明细（1/true/yes）
include_postclose	bool-like	否	包含盘后明细（1/true/yes）
include_midbreak	bool-like	否	包含午间修补/盘后修补明细（1/true/yes）
min_turnover_ratio	float	否	明细最小换手率阈值，默认 0.004（0.4%），用于过滤明细
page	int	否	页码，默认 1，最小 1
page_size	int	否	每页条数，默认 100，范围 1..100000

接口说明

• 排序与分页：后端首先按当日快照哈希的 updated_at 对股票代码降序排序；仅对当前页代码执行聚合与明细读取。结果集 items 也按 updated_at 降序返回。
• 聚合统计：仅统计常规交易时段（regular/postclose），排除盘前/竞价/午间修补等阶段。统一排除 09:25:00 逐笔记录。
• 指数排除：自动排除上证指数（000001.SH）、深证成指（399001）、创业板指（399006）、北证50（899050）等指数。
• 数据源：当天从 Redis 读取，历史从 MySQL monitor_trade_detail 读取。仅使用 Redis 数据（快照、聚合桶、明细），不再回退 MySQL；若前日快照缺失，turnover_ratio_hist 为空。

buy_details / sell_details / middle_details 字段说明

每个明细条目包含以下字段：

字段	类型	说明
ts	string	交易时间 YYYY-MM-DD HH:MM:SS
price	float	成交价格
vol	int	成交量（股）
turnover_ratio	float	单笔换手率（= vol / free_float_shares）

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "day": "20251211",
    "items": [
      {
        "stock_code": "000001.SZ",
        "stock_name": "平安银行",
        "buy_count": 12,
        "sell_count": 9,
        "middle_count": 3,
        "net_inflow": 180000,
        "close": 12.34,
        "pct_chg": 1.23,
        "updated_at": "2025-12-11 14:58:00",
        "auction_strength": 0.005,
        "auction_turnover": 0.0003,
        "auction_amount": 12345678.0,
        "auction_direction": "buy",
        "chip_buy_total_vol_today": 1200000,
        "chip_sell_total_vol_today": 800000,
        "chip_buy_total_amount_today": 15000000,
        "chip_sell_total_amount_today": 9000000,
        "chip_middle_total_vol_today": 200000,
        "chip_middle_total_amount_today": 2500000,
        "free_float_shares": 19405918000,
        "main_cost": 12.1,
        "chip_peak": 12.0,
        "chip_70": [11.8, 12.5],
        "chip_90": [11.5, 13.0],
        "concentration_70": 5.8,
        "concentration_90": 12.4,
        "cost_win_rate": 62.5,
        "buy_details": [{
          "ts": "2025-12-11 10:15:02",
          "price": 12.30,
          "vol": 50000,
          "turnover_ratio": 0.005
        }],
        "sell_details": [],
        "middle_details": []
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total_items": 1234,
      "total_pages": 13
    }
  }
}

返回状态

状态码	说明
200	成功
401	未认证
403	无权限

---