Back to Details

k-dart

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

k-dart — 금감원 DART 전자공시 조회

k-dart — 金融监督院DART电子公示查询

What this skill does

本技能的功能

API_K_DART
환경변수에 담긴 인증키로 DART OpenAPI(
https://opendart.fss.or.kr/api/
)를 직접 호출해 공시·재무·주요사항 정보를 조회한다. 프록시를 거치지 않는다.
使用
API_K_DART
环境变量中存储的认证密钥直接调用DART OpenAPI(
https://opendart.fss.or.kr/api/
)，查询公示、财务、重要事项信息。不经过代理。

When to use

使用场景

  • "삼성전자 최근 공시 보여줘"
  • "카카오 기업개황 알려줘"
  • "LG에너지솔루션 2024년 연간 재무제표"
  • "네이버 배당 현황"
  • "하이브 전환사채 발행 이력"
  • "셀트리온 소송 현황"
  • "SK하이닉스 감사의견"
  • "현대차 증자/감자 이력"
  • "삼성바이오 자기주식 취득/처분"
  • "给我看看三星电子最近的公示信息"
  • "告诉我Kakao的企业概况"
  • "LG新能源2024年度财务报表"
  • "Naver的分红情况"
  • "HYBE可转换公司债发行历史"
  • "Celltrion的诉讼情况"
  • "SK海力士的审计意见"
  • "现代汽车增资/减资历史"
  • "三星生物的股票回购/处置情况"

When not to use

不适用场景

  • 실시간 주가/호가/체결 조회 → 
    korean-stock-search
    스킬
  • 해외 기업 공시
  • 투자 자문/매수 추천
  • 实时股价/报价/成交查询 → 使用
    korean-stock-search
    技能
  • 海外企业公示信息
  • 投资咨询/买入推荐

Prerequisites

前置条件

API_K_DART
환경변수가 설정되어 있어야 한다. 키 발급: https://opendart.fss.or.kr/uss/umt/EgovMberInsertView.do
必须设置
API_K_DART
环境变量。密钥申请地址：https://opendart.fss.or.kr/uss/umt/EgovMberInsertView.do

corp_code 확보 절차

获取corp_code的步骤

DART API 대부분은 
corp_code
(8자리 고유번호)를 요구한다. 사용자가 종목명이나 종목코드(6자리)만 제공하면:
  1. 고유번호 전체 목록(
    corpCode.xml
    )을 다운로드    해 회사명 또는 종목코드로 
    corp_code
    를 조회한다:
macOS / Linux (bash):
bash
undefined
DART API的大多数接口需要
corp_code
(8位唯一编号)。如果用户仅提供公司名称或股票代码(6位)，则：
  1. 下载完整唯一编号列表(
    corpCode.xml
    )    ，通过公司名称或股票代码查询
    corp_code
    ：
macOS / Linux (bash):
bash
undefined

ZIP 다운로드 → 압축 해제 (이미 있으면 생략)

ZIP下载 → 解压（已存在则跳过）

[ -f /tmp/dart_corp/CORPCODE.xml ] || { curl -fsS -o /tmp/dart_corp.zip
"https://opendart.fss.or.kr/api/corpCode.xml?crtfc_key=$API_K_DART" mkdir -p /tmp/dart_corp && unzip -o /tmp/dart_corp.zip -d /tmp/dart_corp }
[ -f /tmp/dart_corp/CORPCODE.xml ] || { curl -fsS -o /tmp/dart_corp.zip
"https://opendart.fss.or.kr/api/corpCode.xml?crtfc_key=$API_K_DART" mkdir -p /tmp/dart_corp && unzip -o /tmp/dart_corp.zip -d /tmp/dart_corp }

회사명 또는 종목코드로 corp_code 검색 (상장사만)

通过公司名称或股票代码查询corp_code（仅上市公司）

grep -B2 -A3 '삼성전자' /tmp/dart_corp/CORPCODE.xml | awk ' /<corp_code>/{code=$0; gsub(/.<corp_code>|</corp_code>./,"",code)} /<corp_name>/{name=$0; gsub(/.<corp_name>|</corp_name>./,"",name)} /<stock_code>[0-9]/{stock=$0; gsub(/.<stock_code>|</stock_code>./,"",stock); print code, stock, name} '
grep -B2 -A3 '삼성전자' /tmp/dart_corp/CORPCODE.xml | awk ' /<corp_code>/{code=$0; gsub(/.<corp_code>|</corp_code>./,"",code)} /<corp_name>/{name=$0; gsub(/.<corp_name>|</corp_name>./,"",name)} /<stock_code>[0-9]/{stock=$0; gsub(/.<stock_code>|</stock_code>./,"",stock); print code, stock, name} '

출력: 00126380 005930 삼성전자

输出: 00126380 005930 삼성전자


**Windows (PowerShell):**

```powershell

**Windows (PowerShell):**

```powershell

ZIP 다운로드 → 압축 해제 (이미 있으면 생략)

ZIP下载 → 解压（已存在则跳过）

$dartDir = "$env:TEMP\dart_corp" if (-not (Test-Path "$dartDir\CORPCODE.xml")) { Invoke-WebRequest "https://opendart.fss.or.kr/api/corpCode.xml?crtfc_key=$env:API_K_DART" -OutFile "$dartDir.zip" New-Item -ItemType Directory -Path $dartDir -Force | Out-Null Expand-Archive "$dartDir.zip" -DestinationPath $dartDir -Force }
$dartDir = "$env:TEMP\dart_corp" if (-not (Test-Path "$dartDir\CORPCODE.xml")) { Invoke-WebRequest "https://opendart.fss.or.kr/api/corpCode.xml?crtfc_key=$env:API_K_DART" -OutFile "$dartDir.zip" New-Item -ItemType Directory -Path $dartDir -Force | Out-Null Expand-Archive "$dartDir.zip" -DestinationPath $dartDir -Force }

회사명 또는 종목코드로 corp_code 검색 (상장사만)

通过公司名称或股票代码查询corp_code（仅上市公司）

[xml]$xml = Get-Content "$dartDir\CORPCODE.xml" $xml.result.list | Where-Object { $.corp_name -like '삼성전자' -and $.stock_code.Trim() -ne '' } | Select-Object corp_code, stock_code, corp_name
[xml]$xml = Get-Content "$dartDir\CORPCODE.xml" $xml.result.list | Where-Object { $.corp_name -like '삼성전자' -and $.stock_code.Trim() -ne '' } | Select-Object corp_code, stock_code, corp_name

출력: 00126380 005930 삼성전자

输出: 00126380 005930 삼성전자


2. 획득한 `corp_code`로 나머지 API 호출

> **참고:** `/tmp/dart_corp/CORPCODE.xml`이 이미 있으면 재다운로드 없이 재사용한다. 파일은 약 30MB이며 전체 법인 목록(상장+비상장)을 포함한다. `corpCode.xml`에 회사명·종목코드·고유번호가 모두 포함되어 있으므로 별도 스킬 연계 없이 단독으로 corp_code를 확보할 수 있다.

2. 使用获取到的`corp_code`调用其他API

> **提示:** 如果`/tmp/dart_corp/CORPCODE.xml`已存在，则直接复用无需重新下载。该文件约30MB，包含所有法人列表(上市+非上市)。`corpCode.xml`中包含公司名称、股票代码、唯一编号，无需关联其他技能即可单独获取corp_code。

Supported endpoints

支持的接口

모든 요청은 
GET https://opendart.fss.or.kr/api/{endpoint}.json?crtfc_key=$API_K_DART&...
형식이다.
所有请求均为
GET https://opendart.fss.or.kr/api/{endpoint}.json?crtfc_key=$API_K_DART&...
格式。

1. 공시검색

1. 公示查询

http
GET /api/list.json?crtfc_key={key}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
     [&corp_code={code}]
     [&last_reprt_at=Y|N] [&pblntf_ty=A..J] [&pblntf_detail_ty=...]
     [&corp_cls=Y|K|N|E] [&sort=date|crp|rpt] [&sort_mth=asc|desc]
     [&page_no=1] [&page_count=10]
공식 가이드(DS001/2019001) 요청 인자 정리 (필수여부·기본값·허용값은 공식 표 기준, 식별자는 코드 폰트로 표기):
요청키명칭타입필수여부값설명
crtfc_key
API 인증키STRING(40)Y발급받은 인증키(40자리)
corp_code
고유번호STRING(8)N공시대상회사의 고유번호(8자리). ※ 개발가이드 > 공시정보 > 고유번호 참고
bgn_de
시작일STRING(8)Y검색시작 접수일자(YYYYMMDD). 1) 기본값: 종료일(
end_de
). 2) 고유번호(
corp_code
)가 없는 경우 검색기간은 3개월로 제한
end_de
종료일STRING(8)Y검색종료 접수일자(YYYYMMDD). 1) 기본값: 당일
last_reprt_at
최종보고서 검색여부STRING(1)N최종보고서만 검색여부(Y or N). 1) 기본값: N (정정이 있는 경우 최종정정만 검색)
pblntf_ty
공시유형STRING(1)NA=정기공시, B=주요사항보고, C=발행공시, D=지분공시, E=기타공시, F=외부감사관련, G=펀드공시, H=자산유동화, I=거래소공시, J=공정위공시
pblntf_detail_ty
공시상세유형STRING(4)N(※ 상세 유형 참조: 
pblntf_detail_ty
)
corp_cls
법인구분STRING(1)NY(유가), K(코스닥), N(코넥스), E(기타). ※ 없으면 전체조회, 복수조건 불가
sort
정렬STRING(4)N접수일자: 
date
/ 회사명: 
crp
/ 보고서명: 
rpt
. ※ 기본값: 
date
sort_mth
정렬방법STRING(4)N오름차순(
asc
), 내림차순(
desc
). ※ 기본값: 
desc
page_no
페이지 번호STRING(5)N페이지 번호 (1~n). 기본값: 1
page_count
페이지 별 건수STRING(3)N페이지당 건수 (1~100). 기본값: 10, 최대값: 100
pblntf_detail_ty
자주 쓰는 코드 예시: A001=사업보고서, A002=반기보고서, A003=분기보고서, B001=주요사항보고서, F001=감사보고서, F002=연결감사보고서, D001=주식등의대량보유상황보고서.
주의: DART OpenAPI 
list.json
의 공식 요청 파라미터 표에 
corp_name
은 존재하지 않는다. 회사명을 기준으로 특정 기업 공시만 좁혀 보려면 위 "corp_code 확보 절차"로 먼저 
corp_code
(8자리 고유번호)를 얻은 뒤 호출한다.
http
GET /api/list.json?crtfc_key={key}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
     [&corp_code={code}]
     [&last_reprt_at=Y|N] [&pblntf_ty=A..J] [&pblntf_detail_ty=...]
     [&corp_cls=Y|K|N|E] [&sort=date|crp|rpt] [&sort_mth=asc|desc]
     [&page_no=1] [&page_count=10]
官方指南(DS001/2019001)请求参数整理（必填项、默认值、允许值以官方表格为准，标识符用代码字体表示）：
请求键名称类型必填项值说明
crtfc_key
API认证密钥STRING(40)Y已申请的认证密钥(40位)
corp_code
唯一编号STRING(8)N公示对象公司的唯一编号(8位)。※ 参考开发指南 > 公示信息 > 唯一编号
bgn_de
开始日期STRING(8)Y查询起始受理日期(YYYYMMDD)。1) 默认值：结束日期(
end_de
)。2) 未提供唯一编号(
corp_code
)时，查询期限限制为3个月
end_de
结束日期STRING(8)Y查询结束受理日期(YYYYMMDD)。1) 默认值：当日
last_reprt_at
是否仅查询最终报告STRING(1)N是否仅查询最终报告(Y或N)。1) 默认值：N（存在更正时仅查询最终更正报告）
pblntf_ty
公示类型STRING(1)NA=定期公示, B=重要事项报告, C=发行公示, D=持股公示, E=其他公示, F=外部审计相关, G=基金公示, H=资产证券化, I=交易所公示, J=公平交易委员会公示
pblntf_detail_ty
公示详细类型STRING(4)N(※ 参考详细类型: 
pblntf_detail_ty
)
corp_cls
法人分类STRING(1)NY(主板), K(科斯达克), N(科斯达克创业板), E(其他). ※ 未指定则查询全部，不支持多条件
sort
排序方式STRING(4)N受理日期: 
date
/ 公司名称: 
crp
/ 报告名称: 
rpt
. ※ 默认值: 
date
sort_mth
排序顺序STRING(4)N升序(
asc
), 降序(
desc
). ※ 默认值: 
desc
page_no
页码STRING(5)N页码(1~n)。默认值: 1
page_count
每页条数STRING(3)N每页显示条数(1~100)。默认值: 10, 最大值: 100
pblntf_detail_ty
常用代码示例: A001=业务报告, A002=半年度报告, A003=季度报告, B001=重要事项报告, F001=审计报告, F002=合并审计报告, D001=大量持有股票情况报告.
注意: DART OpenAPI 
list.json
的官方请求参数表中不存在
corp_name
参数。若要仅查询特定公司的公示信息，请先通过上述“获取corp_code的步骤”获取
corp_code
(8位唯一编号)后再调用接口。

2. 기업개황

2. 企业概况

http
GET /api/company.json?crtfc_key={key}&corp_code={code}
http
GET /api/company.json?crtfc_key={key}&corp_code={code}

3. 재무제표 (단일회사 전체 재무제표)

3. 财务报表（单一公司完整财务报表）

http
GET /api/fnlttSinglAcntAll.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}&fs_div={OFS|CFS}
reprt_code
: 11013(1분기), 11012(반기), 11014(3분기), 11011(사업보고서) 
fs_div
: OFS(개별), CFS(연결)
http
GET /api/fnlttSinglAcntAll.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}&fs_div={OFS|CFS}
reprt_code
: 11013(第一季度), 11012(半年度), 11014(第三季度), 11011(业务报告) 
fs_div
: OFS(个别), CFS(合并)

4. 증자(감자) 현황

4. 增资(减资)情况

http
GET /api/irdsSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}
http
GET /api/irdsSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

5. 배당에 관한 사항

5. 分红相关事项

http
GET /api/alotMatter.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}
http
GET /api/alotMatter.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

6. 자기주식 취득 및 처분 현황

6. 股票回购及处置情况

http
GET /api/tesstkAcqsDspsSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}
http
GET /api/tesstkAcqsDspsSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

7. 회계감사인의 명칭 및 감사의견

7. 审计师名称及审计意见

http
GET /api/accnutAdtorNmNdAdtOpinion.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}
http
GET /api/accnutAdtorNmNdAdtOpinion.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}

8. 직원 현황

8. 员工情况

http
GET /api/empSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}
부문별·성별 정규직/계약직 인원수, 평균 근속연수, 1인 평균 급여 등을 반환한다.
http
GET /api/empSttus.json?crtfc_key={key}&corp_code={code}&bsns_year={YYYY}&reprt_code={code}
返回按部门、性别划分的正式员工/合同员工人数、平均工龄、人均平均薪资等信息。

9. 유무상증자 결정

9. 有偿无偿增资决定

http
GET /api/pifricDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
주의: 
pifricDecsn.json
은 유무상증자 결정 전용 endpoint다. 유상증자만 따로 조회하려면 
piicDecsn.json
(유상증자 결정), 무상증자만 따로 조회하려면 
fricDecsn.json
(무상증자 결정)을 호출한다.
http
GET /api/pifricDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
注意: 
pifricDecsn.json
是有偿无偿增资决定专用接口。若仅查询有偿增资，请调用
piicDecsn.json
（有偿增资决定）；仅查询无偿增资，请调用
fricDecsn.json
（无偿增资决定）。

10. 소송 등의 제기

10. 诉讼等提起情况

http
GET /api/lwstLg.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
http
GET /api/lwstLg.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

11. 해외 증권시장 주권등 상장 결정

11. 海外证券市场上市决定

http
GET /api/ovLstDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
http
GET /api/ovLstDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

12. 해외 증권시장 주권등 상장폐지 결정

12. 海外证券市场退市决定

http
GET /api/ovDlstDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
http
GET /api/ovDlstDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

13. 전환사채권 발행결정

13. 可转换公司债发行决定

http
GET /api/cvbdIsDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
http
GET /api/cvbdIsDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

14. 교환사채권 발행결정

14. 交换公司债发行决定

http
GET /api/exbdIsDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
http
GET /api/exbdIsDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

15. 회사분할합병 결정

15. 公司分割合并决定

http
GET /api/cmpDvmgDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}
http
GET /api/cmpDvmgDecsn.json?crtfc_key={key}&corp_code={code}&bgn_de={YYYYMMDD}&end_de={YYYYMMDD}

Example requests

请求示例

공시검색 (특정 기업, 삼성전자):
bash
undefined
公示查询（特定企业，三星电子）：
bash
undefined

1. 먼저 위 "corp_code 확보 절차"로 corp_code(예: 삼성전자=00126380) 획득

1. 先通过上述“获取corp_code的步骤”获取corp_code（示例：三星电子=00126380）

2. corp_code로 기간 내 공시 조회

2. 使用corp_code查询指定期限内的公示信息

curl -fsS --get 'https://opendart.fss.or.kr/api/list.json'
--data-urlencode "crtfc_key=$API_K_DART"
--data-urlencode 'corp_code=00126380'
--data-urlencode 'bgn_de=20260101'
--data-urlencode 'end_de=20260419'
--data-urlencode 'page_count=5'

공시검색 (전체 시장 최근 공시, corp_code 미지정 — 공식 spec상 검색 기간 ≤ 3개월):

```bash
curl -fsS --get 'https://opendart.fss.or.kr/api/list.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'bgn_de=20260301' \
  --data-urlencode 'end_de=20260419' \
  --data-urlencode 'pblntf_ty=A' \
  --data-urlencode 'corp_cls=Y' \
  --data-urlencode 'page_count=10'
기업개황:
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/company.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380'
재무제표 (연결, 사업보고서):
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/fnlttSinglAcntAll.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011' \
  --data-urlencode 'fs_div=CFS'
배당 현황:
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/alotMatter.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011'
직원 현황 (사업보고서 기준):
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/empSttus.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011'
유무상증자 결정 (
pifricDecsn.json
— 유상증자만 보려면 
piicDecsn.json
):
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/pifricDecsn.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bgn_de=20200101' \
  --data-urlencode 'end_de=20260419'
전환사채 발행결정:
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/cvbdIsDecsn.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bgn_de=20200101' \
  --data-urlencode 'end_de=20260419'
curl -fsS --get 'https://opendart.fss.or.kr/api/list.json'
--data-urlencode "crtfc_key=$API_K_DART"
--data-urlencode 'corp_code=00126380'
--data-urlencode 'bgn_de=20260101'
--data-urlencode 'end_de=20260419'
--data-urlencode 'page_count=5'

公示查询（全市场最新公示，未指定corp_code — 官方规范中查询期限≤3个月）：

```bash
curl -fsS --get 'https://opendart.fss.or.kr/api/list.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'bgn_de=20260301' \
  --data-urlencode 'end_de=20260419' \
  --data-urlencode 'pblntf_ty=A' \
  --data-urlencode 'corp_cls=Y' \
  --data-urlencode 'page_count=10'
企业概况：
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/company.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380'
财务报表（合并，业务报告）：
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/fnlttSinglAcntAll.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011' \
  --data-urlencode 'fs_div=CFS'
分红情况：
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/alotMatter.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011'
员工情况（基于业务报告）：
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/empSttus.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bsns_year=2024' \
  --data-urlencode 'reprt_code=11011'
有偿无偿增资决定（
pifricDecsn.json
— 仅查看有偿增资请调用
piicDecsn.json
）：
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/pifricDecsn.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bgn_de=20200101' \
  --data-urlencode 'end_de=20260419'
可转换公司债发行决定：
bash
curl -fsS --get 'https://opendart.fss.or.kr/api/cvbdIsDecsn.json' \
  --data-urlencode "crtfc_key=$API_K_DART" \
  --data-urlencode 'corp_code=00126380' \
  --data-urlencode 'bgn_de=20200101' \
  --data-urlencode 'end_de=20260419'

Response shape

响应格式

DART 공통 응답 구조

DART通用响应结构

모든 응답은 
status
와 
message
필드를 포함한다:
json
{
  "status": "000",
  "message": "정상",
  "list": [ ... ]
}
所有响应均包含
status
和
message
字段：
json
{
  "status": "000",
  "message": "정상",
  "list": [ ... ]
}

상태코드

状态码

status의미
000정상
010등록되지 않은 키
011사용할 수 없는 키
012접근할 수 없는 IP
013조회된 데이터 없음
014파일이 존재하지 않음
020요청 제한 초과 (공식 가이드: 일반적으로 20,000건 이상 요청 시 발생. 키별 별도 한도가 설정된 경우에도 동일 코드가 반환될 수 있음)
021조회 가능한 회사 개수 초과 (최대 100개)
100필드 오류 (필드의 부적절한 값)
800원천 시스템 점검 중
900정의되지 않은 오류
status含义
000正常
010未注册的密钥
011不可使用的密钥
012无法访问的IP
013未查询到数据
014文件不存在
020请求超出限制（官方指南：通常请求超过20,000次时触发。若密钥设置了单独限制，也可能在其他阈值触发）
021查询的公司数量超出限制（最多100家）
100字段错误（字段值不合法）
800源系统维护中
900未定义的错误

공시검색 응답 예시

公示查询响应示例

json
{
  "status": "000",
  "message": "정상",
  "page_no": 1,
  "page_count": 5,
  "total_count": 142,
  "total_page": 29,
  "list": [
    {
      "corp_code": "00126380",
      "corp_name": "삼성전자",
      "stock_code": "005930",
      "corp_cls": "Y",
      "report_nm": "[기재정정]사업보고서 (2024.12)",
      "rcept_no": "20250401000123",
      "flr_nm": "삼성전자",
      "rcept_dt": "20250401",
      "rm": ""
    }
  ]
}
json
{
  "status": "000",
  "message": "정상",
  "page_no": 1,
  "page_count": 5,
  "total_count": 142,
  "total_page": 29,
  "list": [
    {
      "corp_code": "00126380",
      "corp_name": "삼성전자",
      "stock_code": "005930",
      "corp_cls": "Y",
      "report_nm": "[기재정정]사업보고서 (2024.12)",
      "rcept_no": "20250401000123",
      "flr_nm": "삼성전자",
      "rcept_dt": "20250401",
      "rm": ""
    }
  ]
}

기업개황 응답 예시

企业概况响应示例

json
{
  "status": "000",
  "message": "정상",
  "corp_code": "00126380",
  "corp_name": "삼성전자",
  "corp_name_eng": "SAMSUNG ELECTRONICS CO.,LTD",
  "stock_name": "삼성전자",
  "stock_code": "005930",
  "ceo_nm": "한종희, 경계현",
  "corp_cls": "Y",
  "jurir_no": "1301110006246",
  "bizr_no": "1248100998",
  "adres": "경기도 수원시 영통구 삼성로 129",
  "hm_url": "www.samsung.com",
  "ir_url": "",
  "phn_no": "031-200-1114",
  "induty_code": "264",
  "est_dt": "19690113",
  "acc_mt": "12"
}
json
{
  "status": "000",
  "message": "정상",
  "corp_code": "00126380",
  "corp_name": "삼성전자",
  "corp_name_eng": "SAMSUNG ELECTRONICS CO.,LTD",
  "stock_name": "삼성전자",
  "stock_code": "005930",
  "ceo_nm": "한종희, 경계현",
  "corp_cls": "Y",
  "jurir_no": "1301110006246",
  "bizr_no": "1248100998",
  "adres": "경기도 수원시 영통구 삼성로 129",
  "hm_url": "www.samsung.com",
  "ir_url": "",
  "phn_no": "031-200-1114",
  "induty_code": "264",
  "est_dt": "19690113",
  "acc_mt": "12"
}

Response policy

响应规则

  • status
    가 
    "000"
    이 아니면 에러 메시지를 사용자에게 안내한다.
  • status: "013"
    (조회된 데이터 없음) 이면 기간/보고서 종류/
    corp_code
    를 재확인하도록 안내한다.
  • status: "020"
    (요청 제한 초과)이면 호출 한도 도달 가능성을 안내한다. 공식 가이드는 "일반적으로 20,000건 이상 요청 시" 발생한다고만 명시하며, 키별로 별도 한도가 설정되어 있으면 다른 임계치에서도 발생할 수 있음을 함께 알린다. 잠시 후 재시도를 권한다.
  • 종목명만 알고 있다면 위 "corp_code 확보 절차"의 
    corpCode.xml
    파싱으로 먼저 
    corp_code
    를 확보한 뒤 후속 API를 호출한다 (DART OpenAPI 
    list.json
    의 공식 요청 파라미터 표에 
    corp_name
    은 존재하지 않는다).
  • 재무제표 조회 시 
    reprt_code
    를 사용자가 지정하지 않으면 사업보고서(11011)를 기본값으로 사용한다.
  • fs_div
    를 지정하지 않으면 연결(CFS)을 기본값으로 사용한다.
  • 주요사항보고서(9~15번)는 날짜 범위가 필요하다. 사용자가 기간을 지정하지 않으면 최근 1년을 기본으로 한다.
  • 숫자는 읽기 쉬운 단위(억, 조, 주)로 풀어주되 원본 수치도 유지한다.
  • 답변 말미에 "금감원 DART 공시 데이터 기준 / 투자 조언 아님" 을 짧게 남긴다.
  • 若
    status
    不为
    "000"
    ，则向用户提示错误信息。
  • 若
    status: "013"
    （未查询到数据），则提示用户重新确认查询期限、报告类型或
    corp_code
    。
  • 若
    status: "020"
    （请求超出限制），则提示用户可能已达到调用限额。官方指南指出“通常请求超过20,000次时触发”，同时说明若密钥设置了单独限制，也可能在其他阈值触发。建议用户稍后重试。
  • 若仅知晓公司名称，请先通过上述“获取corp_code的步骤”解析
    corpCode.xml
    获取
    corp_code
    ，再调用后续API（DART OpenAPI 
    list.json
    的官方请求参数表中不存在
    corp_name
    参数）。
  • 查询财务报表时，若用户未指定
    reprt_code
    ，则默认使用业务报告(11011)。
  • 若未指定
    fs_div
    ，则默认使用合并(CFS)。
  • 重要事项报告（第9~15项）需要日期范围。若用户未指定期限，则默认查询最近1年的数据。
  • 数字转换为易读单位（亿、兆、股），但保留原始数值。
  • 在回复末尾简短标注“基于金融监督院DART公示数据 / 不提供投资建议”。

Keep the answer compact

保持回复简洁

  • 공시검색: 공시명 / 접수일 / 제출인 위주로 최근 5~10건
  • 기업개황: 회사명 / 대표자 / 업종 / 주소 / 결산월
  • 재무제표: 매출액 / 영업이익 / 당기순이익 / 자산총계 / 부채총계 / 자본총계 핵심 항목
  • 주요사항보고서: 핵심 결정 내용과 일자를 요약
  • 公示查询：重点展示公示名称 / 受理日期 / 提交人，最多显示最近5~10条
  • 企业概况：公司名称 / 法人代表 / 行业 / 地址 / 结算月
  • 财务报表：销售额 / 营业利润 / 当期净利润 / 总资产 / 总负债 / 总资本等核心项目
  • 重要事项报告：核心决定内容及日期摘要

Failure modes

失败场景

  • API_K_DART
    환경변수 미설정 → 키 발급 안내 후 중단
  • status
    ≠ 
    "000"
    → 상태코드표 참고해 에러 안내
  • corp_code
    를 찾을 수 없음 → 회사명 재확인 요청
  • 해당 기간/보고서에 데이터 없음 → 기간 또는 
    reprt_code
    변경 안내
  • 未设置
    API_K_DART
    环境变量 → 提示用户申请密钥后终止操作
  • status
    ≠ 
    "000"
    → 参考状态码表提示错误信息
  • 无法找到
    corp_code
    → 请求用户重新确认公司名称
  • 指定期限/报告类型无数据 → 提示用户调整期限或
    reprt_code

Done when

完成标准

  • API_K_DART
    존재를 확인했다.
  • 사용자 요청에 맞는 endpoint를 호출해 결과를 정리했다.
  • 필요 시 
    corp_code
    를 먼저 확보한 뒤 후속 조회를 수행했다.
  • 금감원 DART 공시 데이터 기준임을 짧게 남겼다.
  • 已确认
    API_K_DART
    存在。
  • 已调用与用户请求匹配的接口并整理结果。
  • 必要时已先获取
    corp_code
    再进行后续查询。
  • 已简短标注“基于金融监督院DART公示数据”。

Notes

注意事项

  • 공식 데이터 출처: DART OpenAPI
  • 이 스킬은 read-only 조회 전용이다.
  • DART API 요청 한도: 공식 가이드(
    020
    메시지 설명)는 "일반적으로 20,000건 이상의 요청 에 대해 
    020
    (요청 제한 초과)이 발생하며, 키별로 별도 한도가 설정된 경우 다른 임계치에서도 동일 코드가 반환될 수 있다"고 명시한다. 분당 throttle 등 세부 제약 수치는 공개 가이드에 별도로 게시되어 있지 않다. 본인 키의 정확한 사용 현황은 로그인 후 OpenDART 이용현황 페이지에서 확인할 수 있다.
  • 官方数据来源：DART OpenAPI
  • 本技能仅支持只读查询。
  • DART API请求限额：官方指南（
    020
    消息说明）指出“通常请求超过20,000次时会触发
    020
    （请求超出限制），若密钥设置了单独限制，也可能在其他阈值触发”。分频率限制等具体约束数值未在公开指南中发布。用户可登录后在OpenDART使用状态页面查看自身密钥的准确使用情况。