get_valuation_data

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "market",
        "wacc",
        "peers"
      ],
      "description": "What to fetch — market=시세·지수·금리 time series / wacc=WACC components + CAPM build-up / peers=동업종(KSIC) peer multiples·무차입β·자본구조. Each kind takes a different argument set; an argument that does not apply is reported as an error naming every argument that kind DOES accept, never silently ignored. An unrecognized key is rejected the same way (additionalProperties:false), so a typo surfaces instead of being dropped."
    },
    "corp": {
      "description": "회사명·종목코드·corp_code. market=individual 종목 시세 (kind=market requires exactly one of corp | index | rate_series), wacc=REQUIRED (the subject company), peers=target (동업종 auto-selected). The legacy keys `code`/`stock_code` are absorbed into this argument",
      "type": "string"
    },
    "index": {
      "description": "[market] 시장지수 — kospi·kosdaq (aliases such as KOSPI/코스피 accepted). Mutually exclusive with corp·rate_series",
      "type": "string"
    },
    "rate_series": {
      "description": "[market] 시장금리 — ktb1y~ktb50y(국고채)·corp_aa_3y·corp_bbb_3y(회사채 3년)·cd91. Mutually exclusive with corp·index",
      "type": "string",
      "enum": [
        "ktb1y",
        "ktb2y",
        "ktb3y",
        "ktb5y",
        "ktb10y",
        "ktb20y",
        "ktb30y",
        "ktb50y",
        "corp_aa_3y",
        "corp_aa_pyeong_3y",
        "corp_bbb_3y",
        "cd91"
      ]
    },
    "start": {
      "description": "[market] Start date YYYYMMDD·YYYY-MM-DD (default: one year before `end`). 구 `from` 도 받는다",
      "type": "string"
    },
    "end": {
      "description": "[market] End date (default: latest 적재일). 구 `to` 도 받는다",
      "type": "string"
    },
    "freq": {
      "description": "[market] Resampling frequency of the series — daily (default)·weekly (금요일 마감)·monthly (월말). Resampled rows drop flt_rt and carry period_return_pct instead (flt_rt compounded over the bucket, %), so returns still come from that field, never from close deltas",
      "type": "string",
      "enum": [
        "daily",
        "weekly",
        "monthly"
      ]
    },
    "beta_spec": {
      "description": "[wacc] β spec — 2w=2년 주간 (default, 실무 관행), 5m=5년 월간",
      "type": "string",
      "enum": [
        "2w",
        "5m"
      ]
    },
    "rf_tenor": {
      "description": "[wacc] Rf(무위험이자율) tenor (default 10y)",
      "type": "string",
      "enum": [
        "3y",
        "5y",
        "10y"
      ]
    },
    "credit_rating": {
      "description": "[wacc] 신용등급 used to derive Kd (무보증 공모회사채, 금투협 시가평가 전 등급). Mid-notches are written with 0, NOT bare: AA0·A0·BBB0. If omitted the 정기보고서 공시등급 is picked up automatically; where none is disclosed Kd is left uncomputed rather than assumed",
      "type": "string",
      "enum": [
        "AAA",
        "AA+",
        "AA0",
        "AA-",
        "A+",
        "A0",
        "A-",
        "BBB+",
        "BBB0",
        "BBB-"
      ]
    },
    "kd_tenor": {
      "description": "[wacc] Kd(타인자본비용) tenor (default 5y)",
      "type": "string",
      "enum": [
        "1y",
        "2y",
        "3y",
        "5y",
        "7y",
        "10y"
      ]
    },
    "kd": {
      "description": "[wacc] Kd given directly (annual %, 세전) — overrides credit_rating·kd_tenor",
      "type": "number"
    },
    "mrp": {
      "description": "[wacc] MRP override (decimal, e.g. 0.08). Default 0.08 = midpoint of the 한국공인회계사회 가이던스 range (7~9%)",
      "type": "number"
    },
    "srp_scheme": {
      "description": "[wacc] 규모위험 프리미엄(SRP) 분위체계 (default quintile)",
      "type": "string",
      "enum": [
        "quintile",
        "tercile",
        "none"
      ]
    },
    "srp": {
      "description": "[wacc] SRP override (decimal) — bypasses 분위 판정",
      "type": "number"
    },
    "target_de": {
      "description": "[wacc] Target 자본구조 D/E (시가). If omitted, the snapshot's 실측 value is used",
      "type": "number"
    },
    "equity_basis": {
      "description": "[wacc] Definition of E(자기자본 시가) (default outstanding_plus_nci)",
      "type": "string",
      "enum": [
        "listed",
        "outstanding",
        "outstanding_plus_nci"
      ]
    },
    "include_pref": {
      "description": "[wacc] Add 우선주 시총 into E (default true)",
      "type": "boolean"
    },
    "ksic": {
      "description": "[peers] KSIC 업종코드 given directly (instead of corp — useful for 비상장 targets). e.g. '26410'",
      "type": "string"
    },
    "exclude": {
      "description": "[peers] Exclusion rules — spac·reit (default)·loss(LTM 순손실)·financial(KSIC 64~66). A bare string is also accepted",
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "size_band": {
      "description": "[peers] Multiple range around the target's 시총 (e.g. 10 = 1/10~10x; min 2). Only honoured when corp is given",
      "type": "number"
    },
    "yq": {
      "description": "[wacc·peers] 평가기준 분기 (e.g. 2026Q2 — lowercase q accepted). Default: latest snapshot",
      "type": "string"
    },
    "tax_rate": {
      "description": "[wacc·peers] 한계법인세율 (default 0.264 = 24%×1.1)",
      "type": "number"
    },
    "limit": {
      "description": "[market·peers] Return cap — market default 600 (1~3000), peers default 15 (3~50)",
      "type": "number"
    }
  },
  "required": [
    "kind"
  ],
  "additionalProperties": false
}