{
 "openapi": "3.1.0",
 "info": {
  "title": "kimpremium — Korea Retail Leverage Monitor API",
  "version": "1.0.0",
  "description": "Public read-only API for the Korean retail-leverage / kimchi-premium dashboard. No auth, CORS enabled. Official daily statistics (KOFIA / KSD SEIBro / Naver). Research visualization, not investment advice."
 },
 "servers": [
  {
   "url": "https://kimpremium.com"
  }
 ],
 "paths": {
  "/api/v1/summary": {
   "get": {
    "summary": "Current state + alert level (poll this)",
    "responses": {
     "200": {
      "description": "summary"
     },
     "503": {
      "description": "no data"
     }
    }
   }
  },
  "/api/v1/health": {
   "get": {
    "summary": "Liveness + freshness",
    "responses": {
     "200": {
      "description": "health"
     }
    }
   }
  },
  "/api/v1/meta": {
   "get": {
    "summary": "KPI snapshot + data range",
    "responses": {
     "200": {
      "description": "meta"
     }
    }
   }
  },
  "/api/v1/thermo": {
   "get": {
    "summary": "Leverage thermometer detail + ETF universe",
    "responses": {
     "200": {
      "description": "thermo"
     }
    }
   }
  },
  "/api/v1/series": {
   "get": {
    "summary": "R2 full history (7,100+ trading days)",
    "parameters": [
     {
      "name": "fields",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "comma list, e.g. d,r2,kospi"
     },
     {
      "name": "since",
      "in": "query",
      "schema": {
       "type": "string"
      },
      "description": "YYYYMMDD lower bound"
     }
    ],
    "responses": {
     "200": {
      "description": "series"
     }
    }
   }
  }
 }
}