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 说明管道可能卡住。

更新时间（北京时间 UTC+8）

每天刷新 3 次：~09:40 · ~14:16 · ~21:30。其中 14:16 那次带上当天最新的 T+2 信用数据 = 当日最全。Agent 每天在 14:20（06:20 UTC）之后轮询一次即可；generated 字段为北京时间。

全部端点

端点	用途
`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 监控（一键）

任意环境（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

kimpremium API

Korea retail-leverage monitor · public · read-only · no key · CORS

JSON · READ-ONLY · NO AUTH

Built on official daily statistics (KOFIA FreeSIS · KSD SEIBro · Naver Finance). Research visualization — not investment advice.

← Dashboard Agent doc (Markdown) Machine manifest (JSON) OpenAPI 3.1

Core endpoint · /api/v1/summary

Agents only need to poll this one. Returns current state + the alert block.

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 }
}

Alert rules

level	condition	meaning
critical	thermometer > 45%	high-leverage alert
warning	thermometer > 40%	rising
normal	≤ 40%	normal

Fire when level=="critical", or when level changes vs your last poll; also flag freshness.stale_days > 10 (pipeline may be stuck).

Update times (Beijing, UTC+8)

Refreshes 3×/day: ~09:40 · ~14:16 · ~21:30. The 14:16 run carries that day's latest T+2 credit data = fullest. Poll once a day after 14:20 (06:20 UTC); the generated field is Beijing time.

All endpoints

Endpoint	Purpose
`GET /api/v1/summary`	current state + alert level (agents poll this)
`GET /api/v1/health`	liveness + freshness (stale_days, level)
`GET /api/v1/meta`	KPI snapshot + data range (meta.json)
`GET /api/v1/thermo`	thermometer detail + ETF universe (~38)
`GET /api/v1/series`	R2 full history 7,100+ days; ?fields=d,r2&since=YYYYMMDD to filter
`GET /data/{series,meta,etf}.json`	raw front-end payloads (backward compat)

Filter history

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

Hand it to an agent (one-click)

Any environment (cron + jq):

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

Or just give your agent this line:
Monitor https://kimpremium.com/api/v1/summary, check once a day, notify me when alert.level becomes critical or changes. Docs: https://kimpremium.com/api/agent.md