插入接口

采集代理用 Bearer token 写入客观统计。页面本身不展示假数据；没有行时显示「暂无数据」。完整字段表见仓库docs/api.md。

认证

请求头 Authorization: Bearer <INGEST_API_TOKEN>。缺少或错误返回 401。服务端未配置令牌返回 503。

收盘 / 午盘

POST /api/v1/daily-session 按 trade_date + session 插入或更新。session 取 morning、midday、close。未出现的字段在更新时保留原值；显式 null 会清空该字段。

curl -X POST "$ORIGIN/api/v1/daily-session" \
  -H "Authorization: Bearer $INGEST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "trade_date": "2026-10-23",
    "session": "close",
    "shanghai": 3690.48,
    "shanghai_chg_pct": 0.89,
    "turnover_yi": 19563,
    "limit_up": 82,
    "limit_down": 8,
    "seal_rate_pct": 87.2
  }'

查询：GET /api/v1/daily-session?from=2026-10-20&to=2026-10-23&session=close

盘中快照

POST /api/v1/intraday-snapshot 按 trade_date + snapshot_time 插入或更新。snapshot_time 为 HH:MM。行业主力可传 inflow / outflow 数组，元素为 { "name", "net_yi" }，流出用负数。

curl -X POST "$ORIGIN/api/v1/intraday-snapshot" \
  -H "Authorization: Bearer $INGEST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "trade_date": "2026-10-26",
    "snapshot_time": "10:10",
    "shanghai_chg_pct": -0.49,
    "chinext_chg_pct": -2.70,
    "turnover_yi": 6455,
    "inflow": [{ "name": "汽车零部件", "net_yi": 7.3 }],
    "outflow": [{ "name": "电子", "net_yi": -66.6 }]
  }'

查询：GET /api/v1/intraday-snapshot?date=2026-10-26

关注板块

GET /api/v1/watched-sectors 读取采集端应持续覆盖的板块名称列表（有序）。PUT 或 POST /api/v1/watched-sectors 用 { "sectors": ["电子", "半导体"] } 整表替换；传空数组可清空。

采集建议：每次写盘中快照前先 GET 本列表；若不为空，写入 inflow / outflow 时须包含这些板块的 net_yi，避免图表缺段。

curl -sS "$ORIGIN/api/v1/watched-sectors" \
  -H "Authorization: Bearer $INGEST_API_TOKEN"

curl -sS -X PUT "$ORIGIN/api/v1/watched-sectors" \
  -H "Authorization: Bearer $INGEST_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sectors":["电子","半导体"]}'

口径

金额单位是亿元。涨跌幅是百分点，-0.60 表示 -0.60%。hsgt_turnover_yi 是沪深港通成交额，不是已停止披露的北向实时净流入。接口不接受、页面也不展示预测值。