{"openapi":"3.1.0","info":{"title":"KRX Korea Stock Exchange API","version":"1.0.0","description":"Live data for the Korean stock market (KOSPI and KOSDAQ on the Korea Exchange), with no key. Read the live quote for one or more stocks by their six-digit code (price, open/high/low, change, volume and market capitalisation, in Korean won); the live value of a market index (KOSPI, KOSDAQ, KOSPI 200); and the top stocks ranked by market capitalisation. The Korea-equities / KOSPI-index / market-cap-ranking layer for trading dashboards, screeners and research — distinct from other exchange readers, this is Korean market data. Live; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/krx-api","description":"oanor gateway"}],"tags":[{"name":"Stocks"},{"name":"Indices"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/quote":{"get":{"operationId":"get_v1_quote","tags":["Stocks"],"summary":"Live quote for one or more stocks","description":"","parameters":[{"name":"codes","in":"query","required":true,"description":"Korean stock codes, comma-separated, e.g. 005930 (Samsung), 000660 (SK Hynix)","schema":{"type":"string"},"example":"005930,000660"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The live quote for one or more KRX-listed stocks — price, open/high/low, change, volume, traded value and market cap (in KRW) each. Pass codes (comma-separate up to 10, e.g. 005930,000660 for Samsung and SK Hynix).","count":2,"quotes":[{"low":335000,"code":"005930","high":344500,"isin":"KR7005930003","name":"삼성전자","open":342500,"price":336500,"change":14000,"volume":9539232,"currency":"KRW","market_cap":1967272751592000,"market_status":"OPEN","trading_value":3231798000000,"change_percent":4.34},{"low":2265000,"code":"000660","high":2322000,"isin":"KR7000660001","name":"SK하이닉스","open":2283000,"price":2279000,"change":129000,"volume":1798439,"currency":"KRW","market_cap":1624248689835000,"market_status":"OPEN","trading_value":4128786000000,"change_percent":6}],"source":"KRX (Naver Finance)"},"meta":{"timestamp":"2026-06-15T02:10:55.281Z","request_id":"9319a592-8204-4c43-93d9-cfab50236c84"},"status":"ok","message":"Quote retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/ranking":{"get":{"operationId":"get_v1_ranking","tags":["Stocks"],"summary":"Top stocks by market cap","description":"","parameters":[{"name":"market","in":"query","required":false,"description":"KOSPI or KOSDAQ (default KOSPI)","schema":{"type":"string"},"example":"KOSPI"},{"name":"limit","in":"query","required":false,"description":"Results (1-50, default 20)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The largest KRX-listed stocks by market capitalisation for a market — each with its price, change and market cap. Pass market (KOSPI or KOSDAQ; default KOSPI) and limit (1-50, default 20). The blue-chip leaderboard of the Korean market.","count":20,"market":"KOSPI","source":"KRX (Naver Finance)","stocks":[{"code":"005930","name":"삼성전자","price":336000,"change":13500,"market_cap":19643496,"change_percent":4.19},{"code":"000660","name":"SK하이닉스","price":2279000,"change":129000,"market_cap":16242487,"change_percent":6},{"code":"402340","name":"SK스퀘어","price":1384000,"change":26000,"market_cap":1826304,"change_percent":1.91},{"code":"005935","name":"삼성전자우","price":217000,"change":10000,"market_cap":1741146,"change_percent":4.83},{"code":"009150","name":"삼성전기","price":1920000,"change":206000,"market_cap":1434119,"change_percent":12.02},{"code":"005380","name":"현대차","price":651000,"change":44000,"market_cap":1332973,"change_percent":7.25},{"code":"373220","name":"LG에너지솔루션","price":414500,"change":14500,"market_cap":969930,"change_percent":3.63},{"code":"032830","name":"삼성생명","price":415500,"change":30000,"market_cap":831000,"change_percent":7.78},{"code":"028260","name":"삼성물산","price":491500,"change":59500,"market_cap":797054,"change_percent":13.77},{"code":"329180","name":"HD현대중공업","price":701000,"change":51000,"market_cap":735778,"change_percent":7.85},{"code":"000270","name":"기아","price":171100,"change":4300,"market_cap":667997,"change_percent":2.58},{"code":"034020","name":"두산에너빌리티","price":100300,"change":7200,"market_cap":642483,"change_percent":7.73},{"code":"207940","name":"삼성바이오로직스","price":1349000,"change":54000,"market_cap":624465,"change_percent":4.17},{"code":"105560","name":"KB금융","price":174400,"change":13200,"market_cap":618575,"change_percent":8.19},{"code":"012330","name":"현대모비스","price":640000,"change":33000,"market_cap":580689,"change_percent":5.44},{"code":"012450","name":"한화에어로스페이스","price":1115000,"change":37000,"market_cap":574932,"change_percent":3.43},{"code":"055550","name":"신한지주","price":109900,"change":10300,"market_cap":521645,"change_percent":10.34},{"code":"034730","name":"SK","price":656000,"change":63000,"market_cap":475618,"change_percent":10.62},{"code":"006400","name":"삼성SDI","price":562000,"change":23000,"market_cap":452891,"change_percent":4.27},{"code":"267260","name":"HD현대일렉트릭","price":1145000,"change":15000,"market_cap":412740,"change_percent":1.33}]},"meta":{"timestamp":"2026-06-15T02:10:57.479Z","request_id":"41ba2f43-86f8-4435-b676-d987aefe6d84"},"status":"ok","message":"Ranking retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/index":{"get":{"operationId":"get_v1_index","tags":["Indices"],"summary":"Live value of a market index","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"KOSPI, KOSDAQ or KOSPI200 (default KOSPI)","schema":{"type":"string"},"example":"KOSPI"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"low":8450.24,"high":8603.48,"name":"코스피","note":"The live value of a Korean market index — current level, open, day high/low, change and percent change. Pass name (KOSPI, KOSDAQ or KOSPI200; default KOSPI).","open":8526.12,"index":"KOSPI","value":8529.02,"change":405.4,"source":"KRX (Naver Finance)","market_status":"OPEN","change_percent":4.99,"trading_volume":298304000},"meta":{"timestamp":"2026-06-15T02:10:57.795Z","request_id":"54710aed-38af-465c-a7ca-7178ef7ca192"},"status":"ok","message":"Index retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoints & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"kospi":8529.02},"source":"Naver Finance public quote feed (finance.naver.com), keyless","indexes":["KOSPI","KOSDAQ","KOSPI200"],"service":"krx-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/index":"Live value of a market index (name).","GET /v1/quote":"Live quote for one or more stocks (codes).","GET /v1/ranking":"Top stocks by market cap (market, limit)."},"description":"Live data for the Korean stock market (KOSPI & KOSDAQ on the Korea Exchange) with no key: the live quote for one or more stocks by code (price, open/high/low, change, volume, market cap in KRW), the live value of a market index (KOSPI, KOSDAQ, KOSPI 200), and the top stocks ranked by market capitalisation. The Korea-equities / KOSPI-index / market-cap-ranking layer for trading dashboards and screeners. Distinct from other exchange readers — Korean market data. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-15T02:10:57.880Z","request_id":"40c5529f-6b30-4051-bff6-8cb3254c5bc5"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":14500,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1620,"monthly_call_quota":290000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4280,"monthly_call_quota":1680000,"rps_limit":20,"hard_limit":true},{"slug":"enterprise","name":"Enterprise","price_cents_month":10150,"monthly_call_quota":8450000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/krx-api"}