opendart-client 0.1.0__tar.gz

opendart_client-0.1.0/.github/workflows/check.yml

@@ -0,0 +1,13 @@
+name: check
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  check:
+    # The full check lives in reusable-check.yml so the release gate in
+    # publish.yml runs the identical job.
+    uses: ./.github/workflows/reusable-check.yml

opendart_client-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: publish
+
+# Publish to PyPI when a GitHub Release is published. Authentication is via PyPI
+# Trusted Publishing (OIDC): no API token or password is stored anywhere -- GitHub
+# mints a short-lived identity token that PyPI verifies against the publisher
+# registered for this repo (owner seokhoonj / repo opendart-client / this workflow /
+# environment "pypi").
+#
+# A release event fires this independently of check.yml, so a red build would
+# otherwise upload anyway. The `gate` job runs the *same* reusable check -- the full
+# 3.11/3.14 matrix, lint, types, zero-dependency and py.typed assertions -- on the
+# release commit, and `publish` needs it: a failing suite cannot reach the upload.
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  gate:
+    uses: ./.github/workflows/reusable-check.yml
+
+  publish:
+    needs: gate
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      # Naming any permission drops every unnamed one to `none`, so `contents` must
+      # be listed back or checkout cannot read the repo (fails outright on a private
+      # repo, and is the safe default for a public one).
+      contents: read
+      id-token: write   # required for OIDC; this is what replaces a stored token
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97 # v7.0.0
+        with:
+          python-version: "3.12"
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # v1.14.1

opendart_client-0.1.0/.github/workflows/reusable-check.yml

@@ -0,0 +1,73 @@
+name: reusable check
+
+# The full check -- tests, lint, types, and the packaging assertions -- factored
+# into one reusable job so both `check.yml` (on push / PR) and the release gate in
+# `publish.yml` run the *identical* thing. One definition is what makes "publish
+# gates on the full check" true; a second hand-maintained copy would drift.
+
+on:
+  workflow_call:
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        # The floor and the current release. requires-python is >=3.11, so 3.11 is
+        # the version that claim has to hold on; the upper end tracks current CPython.
+        python-version: ["3.11", "3.14"]
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+
+      - name: Install
+        run: |
+          uv venv --python ${{ matrix.python-version }}
+          uv pip install -e ".[dev]"
+          .venv/bin/python -c "import sys; print('testing on', sys.version)"
+
+      - name: Test
+        run: .venv/bin/pytest -q
+
+      - name: Lint
+        run: .venv/bin/ruff check src tests
+
+      - name: Types
+        run: .venv/bin/mypy
+
+      - name: Confirm the package still has no runtime dependencies
+        # The zero-dependency claim is in the README and pyproject; a claim nothing
+        # checks quietly stops being true. Installed into a bare environment, the
+        # package must import with nothing else present.
+        run: |
+          uv venv /tmp/bare --python ${{ matrix.python-version }}
+          uv pip install --python /tmp/bare/bin/python .
+          /tmp/bare/bin/python -c "
+          import importlib.metadata as md
+          requires = md.requires('opendart-client') or []
+          runtime = [r for r in requires if 'extra ==' not in r]
+          assert not runtime, f'runtime dependencies appeared: {runtime}'
+          import opendartclient
+          print('opendartclient', opendartclient.__version__, 'imports with no third-party packages')
+          "
+
+      - name: Confirm a user's type checker can see the hints
+        # Every hint is invisible to a user unless py.typed ships in the built wheel
+        # (PEP 561), and the source cannot answer whether it did. So ask it the way a
+        # user does: install the built package into a clean env and run their checker.
+        run: |
+          uv venv /tmp/typed --python ${{ matrix.python-version }}
+          uv pip install --python /tmp/typed/bin/python . mypy
+          cat > /tmp/user_code.py <<'PY'
+          from opendartclient import OpenDart
+
+          dart = OpenDart(api_key="x")
+          # report_code is a Literal["11011","11012","11013","11014"]; "99999" is not one.
+          dart.finance.single_accounts("00126380", fiscal_year=2025, report_code="99999")
+          PY
+          /tmp/typed/bin/mypy /tmp/user_code.py > /tmp/mypy_out 2>&1 || true
+          cat /tmp/mypy_out
+          grep -q 'Literal' /tmp/mypy_out
+          grep -q 'report_code' /tmp/mypy_out

opendart_client-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+# AI coding agents
+CLAUDE.md
+.claude/
+AGENTS.md
+AGENT.md
+.codex/
+GEMINI.md
+.gemini/
+
+dev/
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/

opendart_client-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seokhoon Joo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

opendart_client-0.1.0/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: opendart-client
+Version: 0.1.0
+Summary: A clean, sync, typed Python client for Korea's OpenDART (전자공시) disclosure API.
+Project-URL: Homepage, https://github.com/seokhoonj/opendart-client
+Project-URL: Repository, https://github.com/seokhoonj/opendart-client
+Author-email: Seokhoon Joo <seokhoonj@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: dart,disclosure,finance,fss,korea,opendart,전자공시
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# opendart-client
+
+[![check](https://github.com/seokhoonj/opendart-client/actions/workflows/check.yml/badge.svg)](https://github.com/seokhoonj/opendart-client/actions/workflows/check.yml)
+[![PyPI](https://img.shields.io/pypi/v/opendart-client)](https://pypi.org/project/opendart-client/)
+[![Python](https://img.shields.io/pypi/pyversions/opendart-client)](https://pypi.org/project/opendart-client/)
+[![License](https://img.shields.io/pypi/l/opendart-client)](https://github.com/seokhoonj/opendart-client/blob/main/LICENSE)
+
+**English** | [한국어](https://github.com/seokhoonj/opendart-client/blob/main/README.ko.md)
+
+A clean, typed Python client for Korea's **OpenDART** (전자공시) — the Financial
+Supervisory Service's electronic disclosure system.
+
+Zero dependencies. Sync. Returns plain `dict` / `list[dict]`, so you frame it your way.
+
+## Install
+
+```bash
+pip install opendart-client
+```
+
+Get a free API key (40 chars) at <https://opendart.fss.or.kr>.
+
+## Quickstart
+
+```python
+from opendartclient import OpenDart
+
+dart = OpenDart(api_key="...")          # or set OPENDART_API_KEY in the environment
+
+# resolve a name / ticker / 초성 / 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",
+)
+
+# want a DataFrame? returns are list[dict], which the constructors take directly
+import pandas as pd
+pd.DataFrame(rows)
+# or
+import polars as pl
+pl.DataFrame(rows)
+```
+
+## Features
+
+- **All 85 OpenDART endpoints** across six groups — disclosure, periodic reports,
+  financial statements, ownership, major-event reports, securities registration —
+  as readable methods (`dart.event.convertible_bond(...)`, not `cvbdIsDecsn`).
+- **Company resolver** — name / ticker / 초성 (`ㅅㅅㅈㅈ`) / typo → `corp_code`.
+- **Zero runtime dependencies** — the standard library carries it all. Rows come back
+  as `list[dict]`, which `pandas.DataFrame` / `polars.DataFrame` accept directly, so
+  no DataFrame adapter is needed.
+- **Fully typed**, ships `py.typed`; closed vocabularies are `Literal`s, so a bad code
+  fails the type checker, not the API.
+- **Raw returns** — `list[dict]` (flat), `dict[str, list[dict]]` (grouped), `bytes`
+  (zip endpoints). `status 013` (no data) is an empty result; other errors raise a
+  typed `DartError`.
+
+## API
+
+Top level: `dart.corp_codes()` (all corp_code ↔ name / ticker), `dart.resolver()` →
+`CorpResolver.resolve(query)` / `.search(query)`.
+
+`report_code` defaults to `"11011"` (annual report). Others: `11012` half-year,
+`11013` Q1, `11014` Q3.
+
+### disclosure
+
+| Method | Description |
+|---|---|
+| `search(corp_code=…, begin_date=…, end_date=…, …)` | Filings matching the window / filters (auto-paginated) |
+| `company(corp_code)` | Company profile (name, ceo, address, industry, …) |
+| `document(rcept_no)` | Original filing as raw zip `bytes` |
+
+### report (periodic-report key items)
+
+All take `(corp_code, *, fiscal_year, report_code="11011")`.
+
+| Method | Description |
+|---|---|
+| `total_shares` | Total number of shares |
+| `treasury_shares` | Treasury stock acquired and disposed |
+| `dividends` | Dividends |
+| `capital_changes` | Capital increase / reduction history |
+| `debt_securities_issued` | Debt securities issuance record |
+| `commercial_paper_outstanding` | Commercial paper outstanding balance |
+| `short_term_bond_outstanding` | Short-term bond outstanding balance |
+| `corporate_bond_outstanding` | Corporate bond outstanding balance |
+| `hybrid_security_outstanding` | Hybrid capital security outstanding balance |
+| `contingent_capital_outstanding` | Contingent capital security outstanding balance |
+| `public_offering_fund_usage` | Use of public-offering proceeds |
+| `private_placement_fund_usage` | Use of private-placement proceeds |
+| `audit_opinion` | External auditor name and audit opinion |
+| `audit_service_contracts` | Audit service contracts |
+| `non_audit_service_contracts` | Non-audit service contracts with the auditor |
+| `outside_directors` | Outside (independent) directors and changes |
+| `largest_shareholders` | Largest shareholder |
+| `largest_shareholder_changes` | Largest shareholder changes |
+| `minority_shareholders` | Minority shareholders |
+| `executives` | Officers / executives |
+| `employees` | Employees |
+| `unregistered_executive_pay` | Unregistered-executive compensation |
+| `director_pay_approved` | Director & auditor pay (AGM-approved amount) |
+| `director_pay_total` | Director & auditor pay (total paid) |
+| `director_pay_by_type` | Director & auditor pay (by type) |
+| `individual_pay` | Individual director/auditor pay (>= 500M KRW) |
+| `individual_pay_v2` | Individual pay (>= 500M KRW) Ver2.0 — filings after 2026-05, grouped |
+| `top5_individual_pay` | Top-5 individual pay (>= 500M KRW) |
+| `top5_individual_pay_v2` | Top-5 individual pay Ver2.0 — filings after 2026-05, grouped |
+| `equity_investments` | Investments in other corporations |
+
+### finance
+
+| Method | Description |
+|---|---|
+| `single_accounts(corp_code, *, fiscal_year, report_code)` | Key accounts, one company |
+| `multi_accounts(corp_codes, *, fiscal_year, report_code)` | Key accounts, several companies |
+| `full_statements(corp_code, *, fiscal_year, statement_div, report_code)` | Full statements (every BS/IS/CIS/CF line) |
+| `single_indicators(corp_code, *, fiscal_year, index_class, report_code)` | Key financial ratios, one company |
+| `multi_indicators(corp_codes, *, fiscal_year, index_class, report_code)` | Key financial ratios, several companies |
+| `xbrl_document(rcept_no, *, report_code)` | Raw XBRL zip for one filing (`bytes`) |
+| `xbrl_taxonomy(*, statement_kind)` | Standard XBRL account taxonomy |
+
+### ownership
+
+| Method | Description |
+|---|---|
+| `insider_holdings(corp_code)` | Insider (officer / major-shareholder) ownership filings |
+| `five_percent_holdings(corp_code)` | 5%-rule large-holding filings |
+
+### event (major-event reports)
+
+All take `(corp_code, *, begin_date, end_date)`.
+
+| Method | Description |
+|---|---|
+| `default_occurrence` | Default (부도) occurrence |
+| `business_suspension` | Business suspension |
+| `rehabilitation_filing` | Rehabilitation-procedure filing |
+| `dissolution_cause` | Dissolution cause occurrence |
+| `paid_in_capital_increase` | Paid-in capital increase decision |
+| `bonus_issue` | Bonus issue (free capital increase) decision |
+| `combined_capital_increase` | Combined paid-in / bonus increase decision |
+| `capital_reduction` | Capital reduction decision |
+| `creditor_management_start` | Creditor-bank management-procedure start |
+| `creditor_management_stop` | Creditor-bank management-procedure stop |
+| `litigation` | Litigation filed |
+| `overseas_listing_decision` | Overseas listing decision |
+| `overseas_delisting_decision` | Overseas delisting decision |
+| `overseas_listing` | Overseas listing |
+| `overseas_delisting` | Overseas delisting |
+| `convertible_bond` | Convertible bond (CB) issuance decision |
+| `bond_with_warrant` | Bond with warrant (BW) issuance decision |
+| `exchangeable_bond` | Exchangeable bond (EB) issuance decision |
+| `contingent_convertible_bond` | Write-down contingent capital security issuance decision |
+| `treasury_acquisition` | Treasury stock acquisition decision |
+| `treasury_disposal` | Treasury stock disposal decision |
+| `treasury_trust_contract` | Treasury-stock trust-contract decision |
+| `treasury_trust_termination` | Treasury-stock trust-termination decision |
+| `asset_transaction` | Asset transfer (other) / put-back option |
+| `business_acquisition` | Business acquisition decision |
+| `business_transfer` | Business transfer decision |
+| `tangible_asset_acquisition` | Tangible asset acquisition decision |
+| `tangible_asset_transfer` | Tangible asset transfer decision |
+| `equity_stake_acquisition` | Acquisition of another company's shares / equity |
+| `equity_stake_transfer` | Transfer of another company's shares / equity |
+| `equity_bond_acquisition` | Acquisition of share-related bonds |
+| `equity_bond_transfer` | Transfer of share-related bonds |
+| `merger` | Company merger decision |
+| `spinoff` | Company split (spin-off) decision |
+| `split_merger` | Split-merger decision |
+| `stock_exchange` | Stock exchange / transfer decision |
+
+### registration (securities-registration statements)
+
+All take `(corp_code, *, begin_date, end_date)`.
+
+| Method | Description |
+|---|---|
+| `equity_securities` | Equity securities |
+| `debt_securities` | Debt securities |
+| `depositary_receipts` | Depositary receipts |
+| `merger` | Merger |
+| `stock_exchange` | Comprehensive stock exchange / transfer |
+| `division` | Division |
+
+## License
+
+MIT © Seokhoon Joo

opendart_client-0.1.0/README.ko.md

@@ -0,0 +1,195 @@
+# opendart-client
+
+[![check](https://github.com/seokhoonj/opendart-client/actions/workflows/check.yml/badge.svg)](https://github.com/seokhoonj/opendart-client/actions/workflows/check.yml)
+[![PyPI](https://img.shields.io/pypi/v/opendart-client)](https://pypi.org/project/opendart-client/)
+[![Python](https://img.shields.io/pypi/pyversions/opendart-client)](https://pypi.org/project/opendart-client/)
+[![License](https://img.shields.io/pypi/l/opendart-client)](https://github.com/seokhoonj/opendart-client/blob/main/LICENSE)
+
+[English](https://github.com/seokhoonj/opendart-client/blob/main/README.md) | **한국어**
+
+한국 **OpenDART**(금융감독원 전자공시시스템) API를 위한 깔끔한 타입드 파이썬 클라이언트.
+미국 SEC EDGAR에 해당하는 그 전자공시죠.
+
+의존성 0개, 동기(sync), `dict` / `list[dict]` 그대로 반환 — DataFrame은 원하는 대로.
+
+## 설치
+
+```bash
+pip install opendart-client
+```
+
+무료 API 키(40자리)는 <https://opendart.fss.or.kr> 에서 발급.
+
+## 빠른 시작
+
+```python
+from opendartclient import OpenDart
+
+dart = OpenDart(api_key="...")          # 또는 환경변수 OPENDART_API_KEY
+
+# 이름 / 티커 / 초성 / 오타 -> corp_code
+code = dart.resolver().resolve("삼성전자")          # "00126380"
+
+# 기간 내 공시 목록
+rows = dart.disclosure.search(
+    corp_code=code, begin_date="20260101", end_date="20260131",
+)
+
+# 재무제표, 그리고 모든 주요사항(이벤트)
+dart.finance.single_accounts(code, fiscal_year=2025)
+dart.event.paid_in_capital_increase(
+    corp_code=code, begin_date="20260101", end_date="20260131",
+)
+
+# DataFrame이 필요하면 — 반환이 list[dict]이라 생성자에 그대로 넣으면 됩니다
+import pandas as pd
+pd.DataFrame(rows)
+# 또는
+import polars as pl
+pl.DataFrame(rows)
+```
+
+## 특징
+
+- **OpenDART 85개 엔드포인트 전부** — 공시정보 · 정기보고서 · 재무정보 · 지분공시 ·
+  주요사항보고서 · 증권신고서 6그룹을, **읽히는 메서드명**으로
+  (`dart.event.convertible_bond(...)`, `cvbdIsDecsn` 아님).
+- **회사 리졸버** — 이름 / 티커 / 초성(`ㅅㅅㅈㅈ`) / 오타 → `corp_code`.
+- **런타임 의존성 0개** — 표준 라이브러리만. 반환이 `list[dict]`이라 `pandas.DataFrame` ·
+  `polars.DataFrame` 생성자에 바로 넣으면 됩니다(어댑터 불필요).
+- **완전 타입드**, `py.typed` 동봉. 닫힌 어휘는 `Literal`이라 잘못된 코드는 API가
+  아니라 타입체커가 잡음.
+- **raw 반환** — `list[dict]`(flat) · `dict[str, list[dict]]`(grouped) · `bytes`(zip
+  엔드포인트). `status 013`(데이터 없음)은 빈 결과, 그 외 에러는 타입드 `DartError`.
+
+## API
+
+최상위: `dart.corp_codes()` (전체 corp_code↔이름/티커), `dart.resolver()` →
+`CorpResolver.resolve(query)` / `.search(query)`.
+
+`report_code` 기본값 `"11011"`(사업보고서). 다른 값: `11012` 반기, `11013` 1분기,
+`11014` 3분기.
+
+### disclosure — 공시정보
+
+| 메서드 | 설명 |
+|---|---|
+| `search(corp_code=…, begin_date=…, end_date=…, …)` | 공시검색: 기간·필터에 맞는 모든 공시 (자동 페이지네이션) |
+| `company(corp_code)` | 기업개황 (상호·대표·주소·업종 등) |
+| `document(rcept_no)` | 공시서류 원본파일 (zip `bytes`) |
+
+### report — 정기보고서 주요정보
+
+모두 `(corp_code, *, fiscal_year, report_code="11011")`.
+
+| 메서드 | 설명 |
+|---|---|
+| `total_shares` | 주식의 총수 현황 |
+| `treasury_shares` | 자기주식 취득 및 처분 현황 |
+| `dividends` | 배당에 관한 사항 |
+| `capital_changes` | 증자(감자) 현황 |
+| `debt_securities_issued` | 채무증권 발행실적 |
+| `commercial_paper_outstanding` | 기업어음증권 미상환 잔액 |
+| `short_term_bond_outstanding` | 단기사채 미상환 잔액 |
+| `corporate_bond_outstanding` | 회사채 미상환 잔액 |
+| `hybrid_security_outstanding` | 신종자본증권 미상환 잔액 |
+| `contingent_capital_outstanding` | 조건부 자본증권 미상환 잔액 |
+| `public_offering_fund_usage` | 공모자금의 사용내역 |
+| `private_placement_fund_usage` | 사모자금의 사용내역 |
+| `audit_opinion` | 회계감사인의 명칭 및 감사의견 |
+| `audit_service_contracts` | 감사용역체결현황 |
+| `non_audit_service_contracts` | 회계감사인과의 비감사용역 계약체결 현황 |
+| `outside_directors` | 독립(사외)이사 및 그 변동현황 |
+| `largest_shareholders` | 최대주주 현황 |
+| `largest_shareholder_changes` | 최대주주 변동현황 |
+| `minority_shareholders` | 소액주주 현황 |
+| `executives` | 임원 현황 |
+| `employees` | 직원 현황 |
+| `unregistered_executive_pay` | 미등기임원 보수현황 |
+| `director_pay_approved` | 이사·감사 전체의 보수현황(주주총회 승인금액) |
+| `director_pay_total` | 이사·감사 전체의 보수현황(보수지급금액 - 전체) |
+| `director_pay_by_type` | 이사·감사 전체의 보수현황(유형별) |
+| `individual_pay` | 이사·감사의 개인별 보수현황(5억원 이상) |
+| `individual_pay_v2` | 개인별 보수현황(5억원 이상) Ver2.0 — 2026-05 이후 제출분, grouped |
+| `top5_individual_pay` | 개인별 보수지급 금액(5억이상 상위5인) |
+| `top5_individual_pay_v2` | 개인별 보수지급(상위5인) Ver2.0 — 2026-05 이후 제출분, grouped |
+| `equity_investments` | 타법인 출자현황 |
+
+### finance — 재무정보
+
+| 메서드 | 설명 |
+|---|---|
+| `single_accounts(corp_code, *, fiscal_year, report_code)` | 단일회사 주요계정 |
+| `multi_accounts(corp_codes, *, fiscal_year, report_code)` | 다중회사 주요계정 (여러 회사 동시) |
+| `full_statements(corp_code, *, fiscal_year, statement_div, report_code)` | 단일회사 전체 재무제표 (BS/IS/CIS/CF 전 항목) |
+| `single_indicators(corp_code, *, fiscal_year, index_class, report_code)` | 단일회사 주요 재무지표 |
+| `multi_indicators(corp_codes, *, fiscal_year, index_class, report_code)` | 다중회사 주요 재무지표 |
+| `xbrl_document(rcept_no, *, report_code)` | 재무제표 원본파일(XBRL) — zip `bytes` |
+| `xbrl_taxonomy(*, statement_kind)` | XBRL 택사노미 재무제표 양식 |
+
+### ownership — 지분공시
+
+| 메서드 | 설명 |
+|---|---|
+| `insider_holdings(corp_code)` | 임원·주요주주 소유보고 |
+| `five_percent_holdings(corp_code)` | 대량보유 상황보고 (5%룰) |
+
+### event — 주요사항보고서
+
+모두 `(corp_code, *, begin_date, end_date)`.
+
+| 메서드 | 설명 |
+|---|---|
+| `default_occurrence` | 부도발생 |
+| `business_suspension` | 영업정지 |
+| `rehabilitation_filing` | 회생절차 개시신청 |
+| `dissolution_cause` | 해산사유 발생 |
+| `paid_in_capital_increase` | 유상증자 결정 |
+| `bonus_issue` | 무상증자 결정 |
+| `combined_capital_increase` | 유무상증자 결정 |
+| `capital_reduction` | 감자 결정 |
+| `creditor_management_start` | 채권은행 등의 관리절차 개시 |
+| `creditor_management_stop` | 채권은행 등의 관리절차 중단 |
+| `litigation` | 소송 등의 제기 |
+| `overseas_listing_decision` | 해외 증권시장 주권등 상장 결정 |
+| `overseas_delisting_decision` | 해외 증권시장 주권등 상장폐지 결정 |
+| `overseas_listing` | 해외 증권시장 주권등 상장 |
+| `overseas_delisting` | 해외 증권시장 주권등 상장폐지 |
+| `convertible_bond` | 전환사채권(CB) 발행결정 |
+| `bond_with_warrant` | 신주인수권부사채권(BW) 발행결정 |
+| `exchangeable_bond` | 교환사채권(EB) 발행결정 |
+| `contingent_convertible_bond` | 상각형 조건부자본증권 발행결정 |
+| `treasury_acquisition` | 자기주식 취득 결정 |
+| `treasury_disposal` | 자기주식 처분 결정 |
+| `treasury_trust_contract` | 자기주식취득 신탁계약 체결 결정 |
+| `treasury_trust_termination` | 자기주식취득 신탁계약 해지 결정 |
+| `asset_transaction` | 자산양수도(기타), 풋백옵션 |
+| `business_acquisition` | 영업양수 결정 |
+| `business_transfer` | 영업양도 결정 |
+| `tangible_asset_acquisition` | 유형자산 양수 결정 |
+| `tangible_asset_transfer` | 유형자산 양도 결정 |
+| `equity_stake_acquisition` | 타법인 주식 및 출자증권 양수결정 |
+| `equity_stake_transfer` | 타법인 주식 및 출자증권 양도결정 |
+| `equity_bond_acquisition` | 주권 관련 사채권 양수 결정 |
+| `equity_bond_transfer` | 주권 관련 사채권 양도 결정 |
+| `merger` | 회사합병 결정 |
+| `spinoff` | 회사분할 결정 |
+| `split_merger` | 회사분할합병 결정 |
+| `stock_exchange` | 주식교환·이전 결정 |
+
+### registration — 증권신고서
+
+모두 `(corp_code, *, begin_date, end_date)`.
+
+| 메서드 | 설명 |
+|---|---|
+| `equity_securities` | 지분증권 |
+| `debt_securities` | 채무증권 |
+| `depositary_receipts` | 증권예탁증권 |
+| `merger` | 합병 |
+| `stock_exchange` | 주식의 포괄적 교환·이전 |
+| `division` | 분할 |
+
+## 라이선스
+
+MIT © Seokhoon Joo