dartlab-data

무엇인가요?

DartLab이 한국 DART 전자공시와 미국 SEC EDGAR 공시를 종목코드 하나로 비교 가능한 표로 가공해 Parquet으로 올려둔 데이터셋입니다.

한국 전 상장사(약 2,700사)와 미국 주요 상장사(약 1,000사)의 재무제표, 사업보고서 본문, 정형 공시, 주가, 거시지표가 들어 있습니다.

이 데이터셋은 DartLab의 데이터 층입니다. dartlab.Company("005930")을 호출하면 라이브러리가 필요한 parquet을 여기서 자동으로 내려받습니다. 숫자는 원문 그대로 보존합니다(반올림·추정·보간 없음).

코드 없이도 바로 씁니다

Python을 몰라도 됩니다. 웹에서 데이터를 고르고 미리본 다음, CSV·엑셀(.xlsx)로 바로 받거나 구글시트·Python·curl이 읽는 라이브 API로 가져갈 수 있습니다.

데이터 센터에서는 종목·항목을 고른 뒤 컬럼 선택, 최근/처음 N행, 일·주·월·분기·연 주기 다운샘플까지 골라 받을 수 있습니다. 구글시트 한 칸에 =IMPORTDATA(...) 한 줄이면 약 1시간마다 자동으로 갱신됩니다.

데이터 구조

각 파일은 회사 1곳입니다: {종목코드}.parquet (시세·거시 등 일부는 날짜·시리즈 단위).

dart/        한국 DART 공시
├── panel/       공시 수평화 (회사당 17-col, 본문 + XBRL 한 표)
├── finance/     재무제표 (K-IFRS XBRL: BS·IS·CF)
├── report/      정형 공시 (28종 API: 배당·임원·지분 등)
└── scan/        전 상장사 횡단 프리빌드 (비율·이익의 질·공시 변경 등)

edgar/       미국 SEC EDGAR
├── panel/       공시 수평화 (회사당 16-col, cross-market)
├── financeStmt/ 재무제표 (DART finance 와 동형 표준화)
├── prices/      회사별 일별 OHLCV
└── tickers/     ticker↔CIK 맵

gov/ · krx/  시세·지수 (공공데이터·KRX)
├── prices/company/   회사별 일별 OHLCV + 시가총액
├── prices/date/      일별 전종목 (날짜 샤딩)
└── indices/          KOSPI·KOSDAQ 등 지수 일별

macro/       거시경제 시계열
├── fred/        미국 FRED (금리·물가 등)
├── ecos/        한국은행 ECOS
└── customs/     관세청 월별 수출입

research/
└── brokerage/   증권사 리서치 메타 인덱스 (제목·링크·발간일, 본문 없음)

dart/panel · 공시 수평화

DART 정기보고서를 회사 단위 패널로 수평화합니다. 서술 본문과 XBRL 연결 표가 한 artifact 에 함께 들어가, 뷰어·검색·비교가 같은 출처를 씁니다.

dart/finance · 재무제표

DART OpenAPI(fnlttSinglAcntAll) 기반 XBRL 재무 데이터.

dart/report · 정형 공시

지배구조, 보수, 지분, 배당 등을 다루는 DART API 28종.

28종 API: dividend, employee, executive, majorHolder, treasuryStock, capitalChange, auditOpinion, stockTotal, outsideDirector, corporateBond 등.

그 외 데이터

Python 으로 쓰기

라이브러리가 필요한 parquet 을 자동으로 내려받고 로컬에 캐시합니다. API 키가 필요 없습니다.

import dartlab

c = dartlab.Company("005930")   # 삼성전자, HF 에서 자동 다운로드
c.panel()                       # 공시 항목 × 기간 전체 격자
c.panel("IS")                   # 손익계산서 (finance 정규화 숫자)
c.panel("사업")                  # 사업 개요 등 공시 본문 행 검색

parquet 을 직접 읽기

종목코드별 parquet URL 을 어떤 도구로든 바로 읽을 수 있습니다.

import polars as pl
url = "https://huggingface.co/datasets/eddmpython/dartlab-data/resolve/main/dart/finance/005930.parquet"
df = pl.read_parquet(url)

import duckdb
duckdb.sql(f"SELECT * FROM read_parquet('{url}')")

엑셀 365: 데이터 → 데이터 가져오기 → 파일에서 → Parquet 에서 → 위 URL. 또는 데이터 센터에서 CSV·엑셀로 바로 받기.

데이터 출처

• DART (한국): dart.fss.or.kr · 금융감독원 전자공시시스템
• EDGAR (미국): sec.gov/edgar · SEC 전자공시 시스템
• 시세·지수: 공공데이터포털·KRX
• 거시: 미국 FRED, 한국은행 ECOS, 관세청

모두 공개된 정부·공공 공시 시스템에서 가져온 데이터입니다. 재무 수치는 원문 그대로 보존합니다(반올림·추정·보간 없음). 뉴스 본문은 언론사 저작권 때문에 데이터셋에 포함하지 않습니다.

갱신 주기

GitHub Actions 로 매일 자동 갱신됩니다. 최근 공시를 증분으로 확인·수집합니다.

라이선스

Apache 2.0 · DartLab 과 동일.

더 보기

• GitHub · github.com/eddmpython/dartlab
• 시작하기 · DartLab 쉽게 시작하기
• 문서 · eddmpython.github.io/dartlab
• 블로그 · 한국 공시 분석 글 120+편
• YouTube · @eddmpython

후원

DartLab 이 도움이 되셨다면 프로젝트를 후원해주세요.

• GitHub Issues · 버그 신고, 기능 제안