금융감독원

DART 전자공시 OpenAPI

기업 공시·재무제표·기업코드를 조회하는 금융감독원 DART 전자공시시스템 공식 API. 모든 상장사의 공시 정보를 제공한다.

에이전트가 얻을 수 있는 정보

공시목록(제목·접수일·공시유형), 기업고유번호·기업명·종목코드, 재무제표(자산·부채·자본·매출·영업이익·순이익 등)
기업 분석, 재무 건전성 평가, 공시 모니터링, 투자 의사결정 지원, 경쟁사 분석

활용 사례

특정 기업의 최근 공시 조회
재무제표 기반 기업 분석
기업코드·종목코드 검색
공시 유형별 검색 (분기보고서·사업보고서 등)
재무비율 산출

등록 API (3)

공시목록 조회 list.json

접수일 기준 공시 목록. 유형·기간으로 필터링

pblntf_de 필수 — 접수일 YYYYMMDD 예: 20261001
pblntf_ty 옵션 — 공시유형 (C=정기공시, B=주요사항보고, A=발행공시 등) 예: C
bgn_de 옵션 — 검색 시작일 예: 20260101
end_de 옵션 — 검색 종료일 예: 20261010
page_no 옵션 예: 1
page_count 옵션 예: 10

출력: corp_code(기업고유번호), corp_name, stock_code(종목코드), report_nm(공시명), rcept_no(접수번호), rcept_dt(접수일자), flr_nm(제출인), rm(참고)

호출 한도: 일 100,000회 (DART 공식 한도. 프록시에서 더 엄격하게 제한)

기업코드 조회 corpCode.json

기업명으로 고유번호·종목코드 검색

corp_name 필수 — 기업명 (부분검색 가능) 예: 삼성전자
corp_code 옵션 — 고유번호 (정확검색) 예: 00126380
full_code 옵션 — 전체코드

출력: corp_code(고유번호), corp_name, stock_code(종목코드), modify_date

호출 한도: 일 100,000회

재무제표(전체) 조회 fnlttSinglAcntAll.json

기업고유번호+사업연도로 재무제표 전체 항목 조회

corp_code 필수 — 기업고유번호 예: 00126380
bsns_year 필수 — 사업연도 예: 2024
reprt_code 필수 — 보고서코드 (11011=사업보고서, 11012=반기, 11013=분기) 예: 11011
fs_div 옵션 — OFS(재무제표원본) / CFS(연결재무제표) 예: OFS

출력: account_nm(계정명), account_detail(계정과목), thstrm_amount(당기금액), frmtrm_amount(전기금액), bfefrmtrm_amount(전전기금액), currency(통화단위)

호출 한도: 일 100,000회

인증·비용·약관

인증 방식	crtfc_key — opendart.fss.or.kr에서 무료 발급. 프록시 서버에만 보관.
비용	무료. 자동승인
이용허락	공공데이터: 출처표시 필수
재배포	허용 (출처표시 필수)
약관 확인일	2026-10-10
활용신청	opendart.fss.or.kr 회원가입 → 인증키 발급 (자동승인) 포털 바로가기
운영 상태	pending_key
최종 확인일	2026-10-10

에이전트 호출 방법

우리 프록시를 통해 호출합니다. 헤더 X-Agent-Token이 필요합니다.

예시: POST /agencatalog/api/call {service:'dart-opendart', endpoint:'fnlttSinglAcntAll.json', params:{corp_code:'00126380', bsns_year:'2024', reprt_code:'11011'}}

기계용 JSON 스키마

{
  "service": "dart-opendart",
  "name": "DART 전자공시 OpenAPI",
  "provider": "금융감독원",
  "apis": [
    {
      "id": "list.json",
      "name": "공시목록 조회",
      "params": [
        {
          "name": "pblntf_de",
          "required": true,
          "example": "20261001",
          "desc": "접수일 YYYYMMDD"
        },
        {
          "name": "pblntf_ty",
          "required": false,
          "example": "C",
          "desc": "공시유형 (C=정기공시, B=주요사항보고, A=발행공시 등)"
        },
        {
          "name": "bgn_de",
          "required": false,
          "example": "20260101",
          "desc": "검색 시작일"
        },
        {
          "name": "end_de",
          "required": false,
          "example": "20261010",
          "desc": "검색 종료일"
        },
        {
          "name": "page_no",
          "required": false,
          "example": "1"
        },
        {
          "name": "page_count",
          "required": false,
          "example": "10"
        }
      ]
    },
    {
      "id": "corpCode.json",
      "name": "기업코드 조회",
      "params": [
        {
          "name": "corp_name",
          "required": true,
          "example": "삼성전자",
          "desc": "기업명 (부분검색 가능)"
        },
        {
          "name": "corp_code",
          "required": false,
          "example": "00126380",
          "desc": "고유번호 (정확검색)"
        },
        {
          "name": "full_code",
          "required": false,
          "desc": "전체코드"
        }
      ]
    },
    {
      "id": "fnlttSinglAcntAll.json",
      "name": "재무제표(전체) 조회",
      "params": [
        {
          "name": "corp_code",
          "required": true,
          "example": "00126380",
          "desc": "기업고유번호"
        },
        {
          "name": "bsns_year",
          "required": true,
          "example": "2024",
          "desc": "사업연도"
        },
        {
          "name": "reprt_code",
          "required": true,
          "example": "11011",
          "desc": "보고서코드 (11011=사업보고서, 11012=반기, 11013=분기)"
        },
        {
          "name": "fs_div",
          "required": false,
          "example": "OFS",
          "desc": "OFS(재무제표원본) / CFS(연결재무제표)"
        }
      ]
    }
  ],
  "proxy_call": "POST /agencatalog/api/call",
  "attribution": "출처: 금융감독원 DART 전자공시시스템(opendart.fss.or.kr)"
}

이용 시 주의사항

기관 API 키는 서버에만 보관됩니다. 직접 키를 요청하는 클라이언트는 이 경로를 사용할 수 없습니다.
기관별 일일 한도가 있습니다. 한도 초과 시 429를 반환하고 추가 호출을 차단합니다.
기관 API 장애·한도 초과 시 오류가 전달됩니다. 재시도 전에 응답의 error 필드를 확인하세요.
출처 표기: 출처: 금융감독원 DART 전자공시시스템(opendart.fss.or.kr)

마지막 확인: 2026-10-10