kimpremium API

韩国散户杠杆监控 · 公开只读 · 无需 key · CORS 开放

JSON · READ-ONLY · NO AUTH

基于官方日频统计（KOFIA FreeSIS · KSD SEIBro · Naver Finance）。研究性可视化，非投资建议。

← 看板 Agent 版文档 (Markdown) 机器清单 (JSON) OpenAPI 3.1

核心端点 · /api/v1/summary

Agent 只需轮询这一个。返回当前状态 + alert 告警块。

curl -s https://kimpremium.com/api/v1/summary

{
 "asof": "20260730",
 "leverage_thermometer": { "value": 50.2, "unit": "percent", "anchor": "2024-01-02" },
 "r2_financing_ratio": { "value": 30.7, "pct_rank_10y": 16.4 },
 "alert": {
  "level": "critical",              // normal | warning | critical
  "value": 50.2,
  "thresholds": { "warning": 40, "critical": 45 },
  "message": "KR杠杆温度计 50.2% — 高位报警(>45)"
 },
 "freshness": { "stale_days": 1 }
}

告警规则

level	条件	含义
critical	温度计 > 45%	高杠杆报警
warning	温度计 > 40%	抬升
normal	≤ 40%	正常

level=="critical" 时触发，或 level 相对上次轮询发生变化时触发；另外 freshness.stale_days > 10 说明管道可能卡住。

全部端点

端点	用途
`GET /api/v1/summary`	当前状态 + 告警等级（agents 轮询这个）
`GET /api/v1/health`	存活 + 数据新鲜度（stale_days, level）
`GET /api/v1/meta`	KPI 快照 + 数据范围（meta.json）
`GET /api/v1/thermo`	杠杆温度计明细 + ETF universe（约 38 只）
`GET /api/v1/series`	R2 全历史 7,100+ 交易日；?fields=d,r2&since=YYYYMMDD 可裁剪
`GET /data/{series,meta,etf}.json`	前端原始载荷（向后兼容）

裁剪历史

curl -s 'https://kimpremium.com/api/v1/series?fields=d,r2,kospi&since=20250101'

交给 Agent 监控（一键）

Avibe harness（本机推荐）：

vibe watch add --name kimpremium-thermo --interval 1d \
  --message 'KR 杠杆温度计进入 critical，见 https://kimpremium.com' \
  -- bash -c 'curl -s https://kimpremium.com/api/v1/summary | jq -e ".alert.level==\"critical\""'

任意环境（cron + jq）：

curl -s https://kimpremium.com/api/v1/summary \
  | jq '{asof, level: .alert.level, thermo: .alert.value, msg: .alert.message}'

或直接把这句话丢给你的 agent：
监控 https://kimpremium.com/api/v1/summary，每天查一次，alert.level 变成 critical 或发生变化时通知我。文档见 https://kimpremium.com/api/agent.md