Pricing

Rating

Developer

Actor stats

Categories

Share

📈 Korea KRX Market Statistics — Daily Settlement, Foreign Ownership, Volume

Daily reference data for every KOSPI, KOSDAQ, and KONEX issuer — closing prices, foreign-ownership ratios (외국인 보유율), trading volumes, and market-cap rankings, delivered as clean JSON.

This actor pulls the daily KRX reference-data snapshot for Korean listed equities. It is the non-real-time statistics layer — the same daily settlement / foreign-ownership / volume table that Korean institutional desks pull at market close every day. NOT a real-time L1/L2 quote feed.

• ✅ KOSPI (유가증권시장) — large-cap main board (Samsung, SK Hynix, Hyundai, Naver, Kakao)
• ✅ KOSDAQ (코스닥) — mid/small-cap growth board (Ecopro BM, Celltrion Healthcare, SM Entertainment)
• ✅ KONEX (코넥스) — small-cap board (via per-ticker pull)
• ✅ Five statistic modes: settlement_prices, foreign_ownership, trading_volumes, market_cap_ranking, index_components
• ✅ Korean-language company names preserved (삼성전자, SK하이닉스, 현대차) + English mapping where known
• ✅ Date-range queries against day-history (back 1–3 months of daily close + open + high + low + volume)
• ✅ Single-ticker mode via 6-digit KRX code (e.g. 005930 Samsung Electronics)

What you get

Each record contains:

Use cases

• Korean equity quants — factor research (size, momentum, foreign-flow) joining daily close + foreign-ownership ratios with KOSPI200 / KOSDAQ150 membership
• Foreign-flow tracking desks — daily monitoring of foreign-ownership-ratio shifts on bellwether KOSPI names (Samsung, SK Hynix, Hyundai, Naver) as a Korea EM-flow signal
• Korean ETF analysts — daily NAV reconciliation for KODEX 200 / TIGER 200 / KOSEF 200 by pulling the index constituents + market-cap rank
• APAC long/short PMs — daily Korean-equity settlement layer for pair trades and basket rebalancing
• Compliance / KYC — daily-close marks for Korean equity exposures held by foreign investors

Statistic modes

The snapshot modes (foreign_ownership, trading_volumes, market_cap_ranking) return a single row per ticker dated today (the daily reference value as of last KRX market close). The settlement_prices mode iterates per-ticker day-history and returns one row per (ticker × trading-day) within [date_from, date_to].

Input

Examples

Settlement prices, KOSPI, last 5 days

{
"stat_type":"settlement_prices",
"market":"KOSPI",
"date_from":"2026-05-26",
"date_to":"2026-05-30",
"max_records":100
}

Foreign ownership snapshot — full KOSPI + KOSDAQ

{
"stat_type":"foreign_ownership",
"market":"all",
"max_records":500
}

Single ticker (Samsung Electronics) — 90-day day-history

{
"stat_type":"settlement_prices",
"ticker_filter":"005930",
"date_from":"2026-03-01",
"date_to":"2026-05-30",
"max_records":90
}

Example output (one row)

{
"market":"KOSPI",
"date":"2026-05-29",
"ticker":"005930",
"company_name":"삼성전자",
"company_name_en":"Samsung Electronics",
"closing_price":317000,
"opening_price":309500,
"high":319000,
"low":305500,
"volume_shares":37241537,
"value_KRW":11805567229000,
"foreign_ownership_pct":48.29,
"share_change_pct":5.85,
"shares_outstanding":5846279000,
"stat_type":"settlement_prices",
"data_source":"naver_finance_krx_mirror",
"source_url":"https://finance.naver.com/item/main.naver?code=005930"
}

📊 Sample Output

👁 Sample output preview

Data source & legal posture

This actor pulls daily KRX reference data via Naver Finance (finance.naver.com) — Korea's largest portal-financial mirror of the KRX daily settlement / foreign-ownership / volume snapshot. The same architecture used by nexgendata/kospi-stock-screener.

Why Naver, not data.krx.co.kr directly? KRX's institutional data.krx.co.kr portal historically served the daily statistics anonymously. As of mid-2026 KRX has gated anonymous browsing on data.krx.co.kr (anonymous requests to /mdiLoader/index.cmd get an alert('로그인 또는 회원가입이 필요합니다.') redirect to login). The data.krx.co.kr/contents/COM/GenerateOTP.jspx bulk-CSV path returns 403 for unauthenticated sessions. Naver Finance carries the same daily reference values under Korea's ECN reference-data agreement (publicly mirrored). The kind.krx.co.kr real-time announcement board is Akamai-walled and remains out of scope by design — this actor is daily reference data, not L1/L2 quotes.

• KRX operates under Korean FSCMA mandate; daily settlement prices, market-cap rankings, and foreign-ownership rates are explicitly public reference data.
• Naver Finance honors KRX's Information Disclosure Service Terms permitting non-real-time data redistribution for research and commercial use.
• This actor sends a politely-identified User-Agent (NexGenData KRX Actor hello@thenextgennexus.com) and rate-limits at ≤3 requests/sec.
• For real-time L1/L2 quotes or order-book depth, use KRX's licensed market-data feed directly (not in scope here).

한국어 설명

한국거래소(KRX) 일일 정산가격 / 외국인보유율 / 거래량 데이터를 KOSPI, KOSDAQ, KONEX 종목에 대해 수집합니다. KRX의 공식 데이터 포털인 data.krx.co.kr은 2026년 중반부터 비로그인 익명 조회가 제한되어 있어, 본 액터는 동일한 KRX 일일 참조 데이터를 미러링하는 네이버 금융(finance.naver.com) 경로를 통해 안정적으로 수집합니다. 이는 한국 ECN 참조데이터 협약에 따른 합법적 미러링입니다.

주요 통계 유형

• 정산가격 (settlement_prices) — 종목별 일별 종가 / 시가 / 고가 / 저가 / 거래량 (날짜 범위 조회)
• 외국인 보유율 (foreign_ownership) — 종목별 외국인 투자자 보유율(%) 스냅샷
• 거래량 (trading_volumes) — 종목별 일일 거래량 / 거래대금 스냅샷
• 시가총액 순위 (market_cap_ranking) — KOSPI + KOSDAQ 시총 순위 스냅샷
• 지수 구성종목 (index_components) — KOSPI200 / KOSDAQ150 / KRX300 구성 종목 메타데이터

주요 용도

• 한국 주식 정량 분석 (팩터 리서치: 규모, 모멘텀, 외국인 자금흐름)
• 외국인 보유율 변동 모니터링 (한국 신흥시장 자금흐름 신호)
• ETF 분석 (KODEX 200 / TIGER 200 일일 NAV 정합성)
• APAC 롱숏 포트폴리오의 한국 종목 일일 정산
• 외국 투자자의 한국 주식 익스포저 컴플라이언스 일일 마크

입력

• stat_type — 통계 유형 선택
• market — 시장 선택 (KOSPI / KOSDAQ / KONEX / all)
• date_from / date_to — 조회 기간 (기본 최근 30일)
• ticker_filter — 6자리 KRX 종목코드 (예: 005930 삼성전자, 000660 SK하이닉스, 005380 현대차)
• max_records — 최대 결과 수 (1–2000, 기본 200)

데이터 출처

본 액터는 한국거래소(KRX) 공시 정보를 미러링하는 네이버 금융을 통해 데이터를 수집합니다. 실시간 호가/체결 데이터가 아닌 일일 참조 데이터입니다. 자본시장법(FSCMA) 및 KRX 정보 공시 서비스 약관에 따라 비실시간 데이터의 연구·상업적 재배포가 허용됩니다.

FAQ

Q. Is this real-time tick data? No. This is daily reference data — the settlement-price / foreign-ownership / volume snapshot published by KRX after market close, plus per-ticker day-history going back several months. For real-time L1/L2, you need a licensed KRX feed (out of scope).

Q. Why don't I see KONEX names in the snapshot modes? Naver Finance's market-summary view (sise_market_sum.naver) covers KOSPI (sosok=0) and KOSDAQ (sosok=1) only. KONEX coverage works in single-ticker mode — pass a 6-digit KONEX code via ticker_filter and the day-history pull will work normally.

Q. The foreign_ownership_pct looks rounded to 2 decimal places — is that the official KRX precision? Yes. KRX's published foreign-ownership ratio is rounded to 2 decimal places (e.g. 48.29 for Samsung Electronics). The underlying KSD custody value is exact, but the daily public reference value is the rounded figure.

Q. Why is value_KRW an approximation rather than the official KRX trading-value column? The Naver market-summary view does not expose 거래대금 (trading value) directly — it exposes 거래량 (volume) only. We approximate value_KRW as volume_shares × closing_price, which is within ~0.5% of the official KRX figure for liquid names (KOSPI200 / KOSDAQ150). For exact 거래대금 you need a licensed KRX OpenAPI key.

Q. What ticker format does Korea use? 6 digits, zero-padded. Examples: 005930 (Samsung Electronics), 000660 (SK Hynix), 005380 (Hyundai Motor), 035420 (Naver Corp), 035720 (Kakao). KOSPI tickers usually start with 0, KOSDAQ tickers commonly start with 0 or 1–3.

Q. Trading-day calendar — what about Korean holidays? Naver returns day-history rows only for actual trading days, so weekends and Korean public holidays are auto-skipped by the upstream. Lunar New Year (설날), Chuseok (추석), and Liberation Day (8/15) are the highest-impact closures.

Related Actors — APAC Markets & Disclosures

Additional Korea + APAC cluster siblings exist in the NexGenData fleet (korea-dart-opendart-filings, korea-kind-disclosures, hkex-news-announcements) — they will appear in this table once flipped public.

Built by NexGenData

Production-grade Apify actors for finance, IP, and regulatory data across APAC. See all actors →