FDR KRX Data Cache

KRX(韩国交易所)数据自动收集系统，将数据以CSV格式存储在Git中。包括股票行情、指数行情、上市股票详细信息、退市股票列表等。

KRX (Korea Exchange) automated data collection system stores collected data in CSV format within Git. The collected datasets cover stock quotes, index quotes, detailed information of listed stocks, lists of delisted stocks, and other relevant market data.

原始信息汇总

FDR KRX Data Cache 数据集概述

数据集简介

该数据集是一个自动收集韩国交易所（KRX）数据并以CSV格式存储于Git仓库的系统。

项目结构

• 数据目录 (data/)：自动生成的CSV数据。
  • listing/：包含上市证券行情及信息。
    • krx/：KRX上市证券行情。
    • kosdaq/：KOSDAQ上市证券行情。
    • delisting/：退市证券列表。
    • desc/：企业详细信息（行业、上市日期、代表等）。
  • index/：包含指数行情。
    • ks11/：KOSPI指数（日度）。
    • year_ks11/：KOSPI指数（年度累计）。
    • year_ks200/：KOSPI 200指数（年度累计）。
  • snap/：包含快照数据（如指数成分股）。

数据收集内容

类别	子类	描述	数据路径
listing	krx	KRX全部证券行情	data/listing/krx/
listing	kosdaq	KOSDAQ证券行情	data/listing/kosdaq/
listing	delisting	退市证券列表	data/listing/delisting/
listing	desc	企业详细信息（行业、上市日期等）	data/listing/desc/
index	ks11, kq11 等	主要指数日度行情	data/index/{symbol}/
index	year_ks11 等	主要指数年度累计行情	data/index/year_{symbol}/
snap	index_list	KRX全部指数列表	data/snap/index_list/
snap	index_stock_1001	指数成分股快照	data/snap/index_stock_1001/

数据收集与更新

• 收集方式：通过STAT/KIND API自动收集。
• 更新频率：通过GitHub Actions工作流，于平日（周一至周五）韩国标准时间（KST）09:00至17:55，每5分钟自动运行。
• 数据去重：系统会自动跳过已收集的历史日期/年度数据，以最小化API调用。
• 数据整合：合并KRX STAT API与KIND数据，提供比FinanceDataReader更详细的企业信息。

搜集汇总

数据集介绍

构建方式

在金融数据科学领域，高效且可靠的数据获取机制是研究与实践的基石。FDR KRX Data Cache数据集通过自动化流程构建，其核心依赖于GitHub Actions工作流，按照预设的日程安排，于韩国标准时间工作日每五分钟自动触发数据收集任务。该系统利用KRX STAT API与KIND数据源，通过精心编写的收集脚本获取韩国交易所的上市证券行情、指数信息及企业详情。采集到的原始数据经过合并与清洗后，被结构化管理并存储于版本控制的Git仓库中，以CSV格式按类别与时间维度进行分目录保存，确保了数据的历史可追溯性与完整性。

特点

该数据集的特点体现在其系统化的组织架构与丰富的数据维度。数据被清晰地划分为上市证券行情、指数数据及快照信息三大类别，每一类别下又进一步细分为KRX主板、KOSDAQ板块、退市企业名录以及企业描述等子集。它不仅提供KOSPI等核心指数的日频行情，还包含了按年度累积的历史序列，为长期趋势分析提供了便利。数据集通过融合多源信息，提供了比通用数据接口更为详尽的企业元数据，如所属行业与上市日期。其设计兼顾了效率，能够智能跳过已获取的历史记录，有效减少了冗余的API调用。

使用方法

对于希望利用韩国金融市场数据进行实证分析的研究者而言，该数据集提供了灵活的使用途径。用户可通过克隆Git仓库直接访问已归档的CSV数据文件，或依据项目说明在本地环境中运行主脚本，以执行完整或选择性的数据采集任务。通过命令行参数，可以便捷地指定仅收集特定类别（如上市证券或指数）的数据，或限定特定的时间范围进行增量更新。数据集与GitHub Actions的深度集成，使得用户亦可手动触发云端收集任务，或直接依赖其自动化流水线获取每日更新的市场数据，从而将数据维护的复杂性降至最低。

背景与挑战

背景概述

在金融科技与量化投资领域，高质量、结构化的市场数据是驱动研究与应用的核心基础。FDR KRX Data Cache 数据集由开源社区开发者创建，旨在通过自动化系统持续采集韩国交易所（KRX）的金融市场数据，包括股票行情、指数信息及公司详情等。该数据集依托 GitHub Actions 实现定时抓取，并利用 STAT/KIND API 整合多源信息，为研究人员和投资者提供了覆盖广泛、更新及时且易于访问的韩国市场数据资源，显著降低了获取和处理金融时间序列数据的门槛，对推动韩国市场分析、算法交易及宏观经济研究具有实质性贡献。

当前挑战

该数据集致力于解决韩国金融市场数据获取与整合的复杂性挑战，其核心问题在于如何高效、可靠地构建一个覆盖全面、历史完整的结构化数据仓库。在构建过程中，面临多重技术障碍：一是需要设计稳健的认证与爬取机制以应对 KRX 官方 API 的访问限制与频率约束；二是必须处理多源数据的模式差异与缺失值，确保跨类别数据的一致性；三是实现增量更新与历史回溯的平衡，避免重复采集并保证数据连续性。此外，维持自动化流程的长期稳定运行，防范因网站改版或接口变更导致的数据中断，亦是持续性的运维挑战。

常用场景

经典使用场景

在金融市场分析领域，FDR KRX Data Cache数据集为研究人员提供了韩国交易所（KRX）的标准化历史数据。该数据集通过自动化脚本定期收集并存储为CSV格式，涵盖了KOSPI和KOSDAQ市场的个股行情、指数走势、企业详细信息以及退市公司列表。这一结构化的数据源使得学者能够便捷地访问韩国股票市场的全面历史记录，为量化金融模型的构建与验证奠定了坚实基础。

解决学术问题

该数据集有效解决了金融实证研究中数据获取困难与标准化不足的常见问题。通过整合KRX STAT API与KIND数据源，它提供了比传统工具更丰富的企业元数据，如行业分类与上市日期。这支持了市场效率检验、资产定价模型验证以及跨市场比较研究，显著降低了数据清洗与整合的学术成本，提升了研究结果的可靠性与可复现性。

衍生相关工作

围绕该数据集衍生的经典工作主要集中在韩国市场特有的金融现象研究。例如，学者利用其连续更新的指数与个股数据，深入分析了KOSPI与KOSDAQ市场间的波动溢出效应。此外，结合企业描述信息的研究，探讨了韩国上市公司治理结构对股价长期表现的影响，这些工作深化了对新兴市场金融动力学的理解。