{
 "name": "kimpremium",
 "title": "Korea Retail Leverage Monitor",
 "description": "Public read-only API for the Korean retail-leverage / kimchi-premium dashboard: leverage thermometer, R2 financing ratio, forced-liquidation, ETF flows. Official daily statistics (KOFIA / KSD SEIBro / Naver).",
 "base_url": "https://kimpremium.com",
 "auth": "none",
 "cors": true,
 "poll": {
  "recommended_endpoint": "/api/v1/summary",
  "cadence": "1/day; poll shortly after 14:20 Beijing time (06:20 UTC) for that day's fullest data",
  "refresh_times_beijing": [
   "09:40",
   "14:16",
   "21:30"
  ],
  "refresh_times_utc": [
   "01:40",
   "06:16",
   "13:30"
  ],
  "best_daily_poll_beijing": "14:16",
  "timezone_note": "Beijing = UTC+8; the summary 'generated' field is in Beijing time",
  "alert_on": "alert.level == 'critical', OR any change in alert.level vs the last poll"
 },
 "alert_metric": {
  "field": "leverage_thermometer / alert",
  "thresholds": {
   "warning": 40,
   "critical": 45,
   "unit": "percent"
  },
  "meaning": "ETF leverage thermometer = (margin balance + leveraged-ETF cumulative net creation @cost) / investor deposits, anchored 2024-01-02"
 },
 "endpoints": [
  {
   "route": "GET /api/v1/summary",
   "desc": "current state + alert level (agents poll this)"
  },
  {
   "route": "GET /api/v1/health",
   "desc": "liveness + freshness (stale_days, level)"
  },
  {
   "route": "GET /api/v1/meta",
   "desc": "KPI snapshot + data range (meta.json)"
  },
  {
   "route": "GET /api/v1/thermo",
   "desc": "thermometer detail + ETF universe (~38)"
  },
  {
   "route": "GET /api/v1/series",
   "desc": "R2 full history 7,100+ days; ?fields=d,r2&since=YYYYMMDD to filter"
  },
  {
   "route": "GET /data/{series,meta,etf}.json",
   "desc": "raw front-end payloads (backward compat)"
  }
 ],
 "docs": {
  "human": "https://kimpremium.com/api",
  "agent": "https://kimpremium.com/api/agent.md",
  "openapi": "https://kimpremium.com/api/openapi.json"
 },
 "monitoring_recipes": {
  "generic_bash": "curl -s https://kimpremium.com/api/v1/summary | jq '{asof, level: .alert.level, thermo: .alert.value, msg: .alert.message}'"
 },
 "disclaimer": "Research visualization of public market statistics. Not investment advice."
}