{"openapi":"3.0.3","info":{"title":"kr-adjust — Korean corporate-action adjustment factors","version":"0.1.0","description":"Survivorship-free adjustment factors for KOSPI/KOSDAQ stocks (incl. delisted), each citing its OpenDART filing. Factors only: no prices are stored or redistributed; /v1/adjust applies factors to prices the caller sends."},"servers":[{"url":"https://adjust.pokt-agent.com"}],"paths":{"/v1/factors":{"get":{"summary":"Adjustment events and factors for one stock","parameters":[{"name":"stock_code","in":"query","schema":{"type":"string","pattern":"^[0-9A-Z]{6}$"},"description":"6-character KRX short code (e.g. 005930). Either stock_code or corp_code."},{"name":"corp_code","in":"query","schema":{"type":"string","pattern":"^\\d{8}$"},"description":"OpenDART 8-digit corp_code"},{"name":"from","in":"query","schema":{"type":"string","format":"date"},"description":"ex_date >= from"},{"name":"to","in":"query","schema":{"type":"string","format":"date"},"description":"ex_date <= to"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"factors":{"type":"array","items":{"type":"object","properties":{"ex_date":{"type":"string","format":"date","nullable":true},"record_date":{"type":"string","format":"date","nullable":true},"type":{"type":"string","enum":["bonus_issue","rights_offering","bonus_rights_combined","stock_split","reverse_split","capital_reduction","stock_dividend"]},"ratio":{"type":"number","nullable":true,"description":"As filed: new shares per old share (bonus/rights/stock dividend) or shares after/before (split/merge/reduction)"},"share_multiplier":{"type":"number","nullable":true},"factor":{"type":"number","nullable":true,"description":"Multiply prices dated before ex_date by this. null when it depends on the cum-rights close (rights offerings): use POST /v1/adjust or the formula/params."},"cumulative_factor_to_today":{"type":"number","nullable":true},"price_dependent":{"type":"boolean"},"adjusts":{"type":"boolean"},"status":{"type":"string","enum":["effective","scheduled","unknown_date"]},"formula":{"type":"string"},"params":{"type":"object"},"notes":{"type":"array","items":{"type":"string"}},"filing":{"type":"object","properties":{"rcept_no":{"type":"string","description":"Effective (latest) DART receipt number in the correction chain"},"url":{"type":"string"},"corrected":{"type":"boolean","description":"true when a later [기재정정]/[발행조건확정] filing superseded the original"},"original_rcept_no":{"type":"string"},"chain":{"type":"array","items":{"type":"string"}},"report_nm":{"type":"string"}}}}}}}}}}},"404":{"description":"stock not covered"}}}},"/v1/adjust":{"post":{"summary":"Adjust caller-supplied closes (backward: last price unchanged; forward: first price unchanged)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["stock_code","prices"],"properties":{"stock_code":{"type":"string"},"prices":{"type":"array","maxItems":20000,"items":{"type":"object","required":["date","close"],"properties":{"date":{"type":"string","format":"date"},"close":{"type":"number"}}}},"method":{"type":"string","enum":["backward","forward"],"default":"backward"}}}}}},"responses":{"200":{"description":"adjusted series + applied/unresolved events"},"400":{"description":"bad input"}}}},"/v1/delisted":{"get":{"summary":"Delisted KOSPI/KOSDAQ stocks by delisting (or last trading) date","parameters":[{"name":"from","in":"query","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"OK"}}}},"/v1/health":{"get":{"summary":"Readiness","responses":{"200":{"description":"{status: ok}"}}}},"/v1/version":{"get":{"summary":"Service, data version and rules","responses":{"200":{"description":"OK"}}}}}}