主力筹码中间表查询

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

所属接口集：盘中监控

请求 URL

GET /v1/api/monitor/chip_metrics

认证方式

Bearer Token（详见 认证与签名）

接口概述

查询中间表 monitor_chip_metric_snapshot 的聚合结果，输出字段与 agg_multi.data.metrics 保持一致。支持按市场、名称模糊匹配、多字段排序、数值筛选（含操作符后缀）。

请求参数

参数	类型	必填	说明
day	string	否	交易日 YYYYMMDD，默认当天
freq	int	否	窗口天数，默认 5（建议 5/10/20/60）
codes	string	否	逗号分隔代码或中文名称关键词；支持 stock_code 别名参数
stock_code	string	否	codes 的别名参数
market	string	否	sh/sz/bj/cyb/star/all，默认 all（按 code6 前缀过滤）
stock_name_like	string	否	股票名称模糊匹配
sort	string	否	排序字段，默认 stock_code；支持所有 metrics 字段（如 close_profit、intraday_control_index、main_pos_increase、main_pos_lock）
order	string	否	asc/desc，默认 asc
page	int	否	页码，默认 1
page_size	int	否	每页条数，默认 50，最大 200
{field}_{op}	float	否	通用数值筛选，op 支持 gt/gte/lt/lte/eq。示例：close_profit_gt=0、intraday_control_index_gte=0.1、main_pos_increase_gte=-0.2

接口说明

• 主力增减仓：main_pos_increase = (main_position_5d - main_position_10d) / ABS(main_position_10d)
• 锁仓偏离：main_pos_lock = ABS(main_position_5d - main_position_10d) / ABS(main_position_10d)
• 收盘获利 vs 周期盈亏：close_profit 为相对 avg_cost 的收益率；intraday_pnl_status 为相对当前 freq 窗口 rolling_*_cost_line 的收益率
• Latest Price Rule：仅使用中间表 monitor_chip_metric_snapshot 中的 latest_price 与成本字段在接口层重算 close_profit、intraday_pnl_status（不按 Redis 实时行情回填）
• 自动回退：若请求 day 无数据，自动回退到最新可用 asof_day
• 市场前缀规则：sh→60、sz→000/001/002、bj→920、cyb→300/301、star→688

响应格式示例

{
  "code": 1,
  "message": "success",
  "data": {
    "day": "20260421",
    "freq": 5,
    "sort": "stock_code",
    "order": "asc",
    "page": 1,
    "page_size": 50,
    "total": 1234,
    "total_pages": 25,
    "metrics": [
      {
        "stock_code": "000571.SZ",
        "stock_name": "新大洲A",
        "latest_price": 5.75,
        "vol": 12683000.0,
        "pct_chg": 1.23,
        "free_float_shares": 1321578900.0,
        "buy_total_vol": 10691900.0,
        "buy_total_amount": 60795562.0,
        "sell_total_vol": 13612800.0,
        "sell_total_amount": 77615063.0,
        "net_buy_vol": -2920900.0,
        "total_vol": 24304700.0,
        "avg_cost": 5.75832825,
        "close_profit": -0.0014463,
        "main_position": -0.1201784,
        "main_control": -0.1201784,
        "main_position_float_ratio": -0.00221082,
        "rolling_5d_buy_total_vol": 10691900.0,
        "rolling_5d_buy_total_amount": 60795562.0,
        "rolling_5d_sell_total_vol": 13612800.0,
        "rolling_5d_sell_total_amount": 77615063.0,
        "rolling_5d_net_buy_vol": -2920900.0,
        "rolling_5d_total_vol": 24304700.0,
        "rolling_5d_cost_line": 5.75832825,
        "intraday_pnl_status": -0.0014463,
        "intraday_control_index": -0.1201784
      }
    ]
  }
}

返回状态

状态码	说明
200	成功
400	参数错误（day 非法、sort 不在允许列表内、数值筛选参数非法）
401	未认证
403	无权限

---