OPEN DART (전자공시)

Name: apitree
Author: apitree

금융감독원 OPEN DART API를 apitree 프록시로 호출합니다. 기업 재무제표, 사업보고서, 공시 목록, 대주주 변동 등 한국 금융 공시 데이터를 Agent가 직접 조회할 수 있습니다.

Quick Start

# 삼성전자 기업 기본정보
curl "https://apitree.ai/api/v1/proxy/kr-dart-disclosure/company.json?corp_code=00126380" \
  -H "Authorization: Bearer YOUR_APITREE_TOKEN"

# 최근 공시 목록
curl "https://apitree.ai/api/v1/proxy/kr-dart-disclosure/list.json?corp_code=00126380&bgn_de=20260101&page_count=5" \
  -H "Authorization: Bearer YOUR_APITREE_TOKEN"

주요 엔드포인트

• /company.json — 기업 기본정보 (종목코드, 대표자, 업종)
• /list.json — 공시 목록 (기간, 유형별 필터)
• /fnlttSinglAcntAll.json — 전체 재무제표 (연결/개별)
• /fnlttMultiAcnt.json — 다중회사 재무비교

인증

DART API 키가 apitree 시스템에 등록되어 있으면 자동 주입됩니다. 별도 키 관리 불필요 — apitree 토큰만 있으면 호출 가능합니다.

BYOK(Bring Your Own Key)도 지원: /settings에서 직접 DART 키를 등록하면 시스템 키 대신 사용됩니다.

캐싱

공시 데이터는 1시간 캐시 (TTL 3600s). 동일 요청 반복 시 크레딧 0 차감 + 즉시 응답.

SDK

const apitree = new ApitreeClient('YOUR_TOKEN');

// 삼성전자 기업정보
const company = await apitree.call('kr-dart-disclosure', {
  path: '/company.json',
  params: { corp_code: '00126380' },
});
console.log(company.data.corp_name); // "삼성전자"