KOSPI 韩股 Screener API:韩国主板量化研究 Pipeline 实战

核心要点。韩国综合股价指数(KOSPI)覆盖韩国交易所主板约 800 只上市股票 —— 三星电子、SK 海力士、现代汽车、LG 新能源、Naver / Kakao 互联网双雄,以及更广义的财阀生态。对于美国与东盟集群的研究台,韩国通常是非日本亚洲最大的单一配置,半导体与动力电池是主导板块暴露。韩国交易所、FnGuide / DataGuide、Quantiwise 是事实上的商业数据供应商;对于筛选、因子研究、看板,公开的 KRX 数据加上结构化聚合可以以零头的成本复现大部分工作流。本文讲清楚 KOSPI 市场结构、韩股研究真正需要的字段,以及基于 KOSPI Stock Screener Actor 的 Python 实战代码。

English version: KOSPI Stock Screener API: Korean Equities Market Data Pipeline

KOSPI 池子里有什么

KOSPI 是韩国交易所(KRX)的主板;KOSDAQ 是并行的成长板。截至 2026 年,KOSPI 有约 800 只上市股票,主导力量:

• 半导体 —— 三星电子(005930)、SK 海力士(000660)。仅这两只就常占 KOSPI 总市值约 25-30%。
• 汽车 —— 现代汽车(005380)、起亚(000270)及现代供应链。
• 动力电池 —— LG 新能源(373220)、三星 SDI(006400)、SK On(096770)。
• 互联网 —— Naver(035420)、Kakao(035720)。韩国本土互联网巨头,无 1:1 对应的西方对照。
• 银行金融 —— KB 金融(105560)、新韩(055550)、Hana(086790)。
• 钢铁与造船 —— POSCO(005490)、现代重工。
• K-content —— 主要娱乐公司在 KOSPI 与 KOSDAQ 交叉上市。

韩国财阀结构意味着集团内部交叉持股是一个重要的二阶分析维度 —— 三星电子、三星 SDI、三星生物制剂是独立上市但相互关联。任何因子模型都需要处理”集团归属”维度。

KOSPI 市场微观结构

• 交易时段 —— KST 09:00–15:30,开盘集合竞价 08:30–09:00,收盘集合竞价 15:20–15:30。
• 日涨跌幅 —— KOSPI ±30%(2015 年从 ±15% 放宽)。KOSDAQ 也是 ±30%。
• 结算 —— T+2。
• 最小交易单位 —— 多数股票 1 股(历史上是 10 股)。
• 做空规则 —— 韩国会周期性在市场压力期实施做空禁令;2023-2024 年禁令与 2024 年部分恢复是近期案例,影响任何空头回测。

境外投资者注册制度(KRX 要求境外投资者注册投资者 ID)已不再是 2023 年前的瓶颈 —— 2023 年末该要求基本被取消 —— 但对数据源归属与历史比较仍相关。

Python 实战代码

KOSPI Stock Screener Actor 返回 KOSPI(可选 KOSDAQ)股票池,含行情、KRW 计价市值、KRX 行业代码标签、财阀集团归属。curl 示例:

curl -X POST "https://api.apify.com/v2/acts/nexgendata~kospi-stock-screener/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"market": "KOSPI", "minMarketCapKRW": 1000000000000, "sectors": ["Semiconductors","EV Battery"], "maxResults": 500}'

Python —— KOSPI 大盘筛选:

import os, json, urllib.request
APIFY_TOKEN = os.environ["APIFY_TOKEN"]
ACTOR = "nexgendata~kospi-stock-screener"
payload = json.dumps({
    "market": "KOSPI",
    "minMarketCapKRW": 1_000_000_000_000,
    "includeGroupAffiliation": True,
    "maxResults": 500,
}).encode("utf-8")
url = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items?token={APIFY_TOKEN}"
req = urllib.request.Request(url, data=payload, method="POST",
                              headers={"Content-Type": "application/json"})
with urllib.request.urlopen(req, timeout=600) as r:
    stocks = json.loads(r.read())
for s in sorted(stocks, key=lambda x: -x.get("marketCapKRW", 0))[:20]:
    print(f"{s['ticker']} | {s.get('nameEn') or s['name']} | "
          f"mcap={s['marketCapKRW']/1e12:.1f}T KRW | group={s.get('group','-')}")

返回结构:

{
  "ticker": "005930",
  "isin": "KR7005930003",
  "name": "삼성전자",
  "nameEn": "Samsung Electronics Co., Ltd.",
  "market": "KOSPI",
  "krxIndustry": "Electrical, electronic equipment",
  "sector": "Semiconductors",
  "group": "Samsung",
  "lastPrice": 78400,
  "marketCapKRW": 467500000000000,
  "peTTM": 14.6,
  "pbMRQ": 1.4,
  "dividendYieldTTM": 2.0,
  "foreignOwnershipPct": 53.2,
  "tradingStatus": "NORMAL"
}

成本对比:KOSPI 数据源

FnGuide / DataGuide 在韩国卖方与机构买方仍是事实上的标准 —— 尤其是前瞻预测数据(“一致预期” feed,本地分析师在用)与韩国独有的基本面覆盖。但对于无需前瞻预测依赖的筛选、因子研究、看板,公开 KRX 派生的栈足够用。

能做什么

• 板块看板 —— 三星 + SK 海力士跟踪半导体周期、LGES + 三星 SDI + SK On 跟踪动力电池周期、Naver + Kakao 跟踪互联网
• KOSPI 因子研究 —— 价值、质量、动量因子组合,带财阀集团调整
• 外资持股监控 —— KRX 每日发布外资持股百分比;在个股层级追踪 delta 是韩股策略的有效资金流信号
• 东盟集群区域看板 —— 把 KOSPI 与PSE Edge 及更广义的区域披露 feed 配套

KOSPI vs KOSDAQ 实务处理

韩股基金通常把两个板块作为一个研究池子配置,按板块加权构建。KOSPI 主导大盘;KOSDAQ 主导 K-content、生物科技、动力电池中小盘。Actor 支持两者任一或全选 —— 多数用例两者都拉。

与披露数据配套

对韩股做任何时效敏感的研究工作流,只有行情与基本面不够 —— 相关新闻流来自KIND 披露。完整的韩国研究 pipeline 用 KOSPI Screener 拉静态股票池 + 基本面,再用 KIND 拉持仓的实时事件流。配套 feed:用于韩国 ADR 美股上市的 SEC Event Router(规模较小但在增长)、用于韩港二次上市的港交所。

一个执行注意点

韩国对 KOSPI 卖出征收证券交易税(目前合并约 0.18%,有进一步下调时间表),对任何高换手回测都有重大影响。韩股因子轮动策略应在价差之外明确建模税收。月度再平衡的多头因子组合影响较小;日度或周度轮动策略中,这是主导成本。

外资持股上限与 FIR 制度

境外投资者注册证书要求虽于 2023 年末基本取消,但 KOSPI 若干板块在韩国法下仍有法定外资持股上限 —— 电信、广播、国防相关、部分公用事业仍有明确上限,从 25% 到 49% 不等。对持有受限板块股票的任何韩国策略,”上限剩余空间”(当前外资持股 vs 法定上限)是一等数据字段。KRX 每日发布外资持股统计,流入 Actor 的 foreignOwnershipPct 字段;上限感知的研究工作流在受限板块过滤、筛选剩余空间低的股票,以识别可能触发强制平仓的标的。

财阀交叉持股与归属字段

KRX 根据《垄断规制及公平交易法》给发行人打”大型企业集团”归属标签 —— 包括三星集团、现代汽车集团、SK 集团、LG 集团、乐天集团,以及其他约 75 个。归属对任何因子模型都有用 —— 三星电子与三星 SDI 的两两相关性高于两只不相关的半导体股票 —— 对治理质量因子也有用。Actor 返回 group 字段,让你能构建”组别中性”因子组合,或反过来构建”组别集中”筛选。

开始使用:在 KOSPI Stock Screener Actor 页面免费跑第一次筛选。

系列相关阅读

中国/亚太系列:

• 韩国 KIND 披露 API:KOSPI/KOSDAQ 公司公告
• PSE Edge 披露 API:菲律宾证券交易所公告
• 港交所上市公司公告 API:港股披露监控

English version: KOSPI Stock Screener API: Korean Equities Market Data Pipeline

The Next Gen Nexus

We cover AI agents, automation, and the tools that make them work. Our mission is to make AI accessible to everyone.