opendart-client

English | 한국어

Read disclosure data from Korea's OpenDART (the Financial Supervisory Service's electronic disclosure system).

Company profiles and filing lists, financial statements and key ratios, dividends and capital changes, largest / minority shareholders, officers, employees and their pay, major decisions like mergers, spin-offs, business transfers and treasury-stock buybacks, ownership filings (the 5% rule), and securities-registration statements.

1. Install

pip install opendart-client

Get a free API key (40 chars) at https://opendart.fss.or.kr. The key is read from OpenDart(api_key=...), the OPENDART_API_KEY environment variable, then a config file — in that order.

Config file (all platforms, recommended) — create ~/.config/opendart-client/credentials.json with:

{ "api_key": "..." }

Environment variable — shell-specific. macOS/Linux (bash/zsh):

export OPENDART_API_KEY=...

On Windows PowerShell use setx OPENDART_API_KEY "..." (persistent) or $env:OPENDART_API_KEY = "..." (current session).

2. Quickstart

from opendart_client import OpenDart

dart = OpenDart(api_key="...")          # or set OPENDART_API_KEY in the environment

# resolve a name / ticker / initials / typo -> corp_code
code = dart.resolver().resolve("삼성전자")          # "00126380"

# disclosures filed in a date window
rows = dart.disclosure.search(
    corp_code=code, begin_date="20260101", end_date="20260131",
)

# financial statements, and any corporate event
dart.finance.single_accounts(code, fiscal_year=2025)
dart.event.paid_in_capital_increase(
    corp_code=code, begin_date="20260101", end_date="20260131",
)

A corp_code resolves from a full name, ticker, initial consonants (ㅅㅅㅈㅈ), or a typo (dart.resolver().resolve(...)). A query with no matching data comes back empty.

Returns are list[dict], so pandas / polars build a DataFrame directly.

import pandas as pd
import polars as pl

pd.DataFrame(rows)   # or pl.DataFrame(rows)

3. API

Top-level helpers — find a company, or list them all.

report_code — the period shared by the periodic-report and finance methods (defaults to 11011).

disclosure

report (periodic-report key items)

All take (corp_code, *, fiscal_year, report_code="11011").

finance

ownership

event (major-event reports)

All take (corp_code, *, begin_date, end_date).

registration (securities-registration statements)

All take (corp_code, *, begin_date, end_date).

4. Terminal

Installing puts an opendart command on your PATH (also python -m opendart_client). The key is read from --api-key, the environment, or the config file.

opendart resolve 삼성전자                    # name / ticker / initials / typo -> corp_code (+ candidates)
opendart search  삼성전자 --begin 20260101   # filings in a date window
opendart company 삼성전자                    # company profile
opendart finance 삼성전자 --year 2024        # key accounts (revenue, operating & net income, assets/liabilities/equity)

Main options:

The <company> argument takes a name, ticker, initials, typo, or an 8-digit corp_code — it resolves to a corp_code internally. Each command prints a readable summary by default; --json prints the full result. See --help for the rest.

resolve lists corp_code, ticker, then name; an unlisted company shows ------ for the ticker.

$ opendart resolve 삼성전자
00126380  005930  삼성전자
00252074  ------  삼성전자판매
00366997  ------  삼성전자로지텍

finance heads the key accounts with the company and report name (--separate for the separate statements).

$ opendart finance 삼성전자 --year 2024
삼성전자 (00126380)  2024 사업보고서  (CFS 연결)
매출액       300,870,903,000,000
영업이익      32,725,961,000,000
당기순이익    34,451,351,000,000
자산총계     514,531,948,000,000
부채총계     112,339,878,000,000
자본총계     402,192,070,000,000

5. AI coding agents

This repo doubles as a plugin marketplace for Claude Code and Codex — it ships resolve, search, company, and finance as skills that call the opendart command. Install the package and set an API key first (above).

5.1. Claude Code

/plugin marketplace add seokhoonj/opendart-client
/plugin install opendart@opendart-client

Then just ask ("find Samsung Electronics' corp_code", "show 삼성전자's recent filings"), or call a skill directly — /opendart:resolve 삼성전자, /opendart:finance 삼성전자 --year 2024.

5.2. Codex

codex plugin marketplace add seokhoonj/opendart-client
codex plugin add opendart@opendart-client

The resolve, search, company, and finance skills react to a company name or ticker, and you can always run opendart <command> <company> directly.

Prefer not to install the plugin? Symlink a skill into your skills directory and call it without the opendart: prefix, as /resolve:

ln -s "$PWD/plugins/opendart/skills/resolve" ~/.claude/skills/resolve

6. License

MIT © Seokhoon Joo