| search_disclosuresA | DART 전자공시시스템에서 공시 목록을 검색합니다.
Parameters:
corp_name: 회사명 (예: "삼성전자", "카카오")
corp_code: DART 고유번호 (8자리, 예: "00126380")
bgn_de: 검색 시작일 YYYYMMDD (예: "20240101")
end_de: 검색 종료일 YYYYMMDD (예: "20241231")
last_reprt_at: 최종보고서만 검색 (Y/N, 기본값: 빈문자열=전체)
pblntf_ty: 공시유형
A=정기공시, B=주요사항보고, C=발행공시, D=지분공시,
E=기타공시, F=외부감사관련, G=펀드공시, H=자산유동화,
I=거래소공시, J=공정위공시
pblntf_detail_ty: 공시상세유형 (공시유형 하위 세부 유형코드)
corp_cls: 법인구분 (Y=유가증권, K=코스닥, N=코넥스, E=기타)
sort: 정렬 기준 (date=접수일자, crp=회사명, rpt=보고서명)
sort_mth: 정렬방식 (asc=오름차순, desc=내림차순)
page_no: 페이지번호 (기본값: 1)
page_count: 페이지당 건수 (기본값: 20, 최대 100)
Returns:
공시 목록 (회사명, 보고서명, 접수일자, 고유번호, 접수번호 포함)
corp_code를 사용하여 get_company_info() 또는 get_financial_statements()로 상세 조회 가능
|
| get_company_infoA | DART 고유번호로 기업 개황 정보를 조회합니다.
고유번호(corp_code)는 search_disclosures() 또는 search_corp_code() 결과에서 확인할 수 있습니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
Returns:
기업 개황 정보 (회사명, 대표이사, 주소, 업종, 설립일, 결산월 등)
|
| search_corp_codeA | 회사명으로 DART 고유번호(corp_code)를 검색합니다.
get_company_info(), get_financial_statements() 등 대부분의 API 호출에 필요한
고유번호를 회사명으로 찾을 때 사용합니다. corpCode.xml 전체 목록을 다운로드하여
정확한 회사명 매칭을 수행합니다 (최초 호출 시 다운로드 후 메모리 캐시).
Parameters:
corp_name: 검색할 회사명 (예: "삼성전자", "카카오", "네이버")
Returns:
검색된 회사 목록과 각 회사의 고유번호(corp_code)
|
| get_financial_statementsA | DART에서 단일회사의 주요계정 재무제표를 조회합니다.
매출액, 영업이익, 당기순이익, 자산총계, 부채총계, 자본총계 등
주요 재무항목을 당기/전기/전전기 비교 형식으로 반환합니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
bsns_year: 사업연도 (예: "2024", "2023")
reprt_code: 보고서코드
11013=1분기보고서, 11012=반기보고서,
11014=3분기보고서, 11011=사업보고서(기본값)
Returns:
주요계정 재무제표 (재무상태표/손익계산서 구분, 당기/전기/전전기 금액)
연결재무제표(CFS)와 개별재무제표(OFS) 모두 포함
|
| get_financial_statements_fullA | DART에서 단일회사의 전체 재무제표를 조회합니다.
재무상태표(BS), 손익계산서(IS), 포괄손익계산서(CIS), 현금흐름표(CF),
자본변동표(SCE) 등 전체 재무제표 항목을 상세하게 반환합니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
bsns_year: 사업연도 (예: "2024", "2023")
reprt_code: 보고서코드
11013=1분기보고서, 11012=반기보고서,
11014=3분기보고서, 11011=사업보고서(기본값)
fs_div: 재무제표 구분
CFS=연결재무제표(기본값), OFS=개별재무제표
Returns:
전체 재무제표 (BS=재무상태표, IS=손익계산서, CIS=포괄손익계산서,
CF=현금흐름표, SCE=자본변동표 구분별 상세 항목)
|
| get_multi_company_financialsA | DART에서 여러 회사의 주요계정 재무제표를 한 번에 조회합니다.
최대 여러 회사의 매출액, 영업이익, 당기순이익, 자산총계 등
주요 재무항목을 비교할 수 있습니다.
Parameters:
corp_code: DART 고유번호 (쉼표로 구분하여 복수 입력, 예: "00126380,00164779,00258801")
bsns_year: 사업연도 (예: "2024", "2023")
reprt_code: 보고서코드
11013=1분기보고서, 11012=반기보고서,
11014=3분기보고서, 11011=사업보고서(기본값)
Returns:
다중회사 주요계정 재무제표 (회사별/재무제표 구분별 주요 계정 비교)
|
| get_financial_indicatorsA | DART에서 단일회사의 주요 재무지표를 조회합니다.
수익성, 안정성, 성장성, 활동성 등의 재무비율 지표를 반환합니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
bsns_year: 사업연도 (예: "2024", "2023")
reprt_code: 보고서코드
11013=1분기보고서, 11012=반기보고서,
11014=3분기보고서, 11011=사업보고서(기본값)
idx_cl_code: 지표분류코드 (빈 문자열이면 전체)
M210000=수익성지표 (매출총이익률, 영업이익률, 순이익률, ROE, ROA 등)
M220000=안정성지표 (부채비율, 유동비율, 자기자본비율, 이자보상배율 등)
M230000=성장성지표 (매출액증가율, 영업이익증가율, 총자산증가율 등)
M240000=활동성지표 (총자산회전율, 재고자산회전율, 매출채권회전율 등)
Returns:
재무지표 목록 (지표분류, 지표명, 지표값)
|
| get_multi_company_indicatorsA | DART에서 여러 회사의 주요 재무지표를 한 번에 조회합니다.
여러 회사의 수익성, 안정성, 성장성, 활동성 지표를 비교할 수 있습니다.
Parameters:
corp_code: DART 고유번호 (쉼표로 구분하여 복수 입력, 예: "00126380,00164779")
bsns_year: 사업연도 (예: "2024", "2023")
reprt_code: 보고서코드
11013=1분기보고서, 11012=반기보고서,
11014=3분기보고서, 11011=사업보고서(기본값)
idx_cl_code: 지표분류코드 (빈 문자열이면 전체)
M210000=수익성지표 (매출총이익률, 영업이익률, 순이익률, ROE, ROA 등)
M220000=안정성지표 (부채비율, 유동비율, 자기자본비율, 이자보상배율 등)
M230000=성장성지표 (매출액증가율, 영업이익증가율, 총자산증가율 등)
M240000=활동성지표 (총자산회전율, 재고자산회전율, 매출채권회전율 등)
Returns:
다중회사 재무지표 비교 (회사별/지표분류별 지표명, 지표값)
|
| get_major_shareholders_reportA | DART에서 대량보유 상황보고 정보를 조회합니다.
특정 기업의 주식 등을 대량보유(5% 이상)한 자의 보유 현황 및 변동 내역을 반환합니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
Returns:
대량보유 상황보고 목록
- 접수번호, 접수일자
- 보고서구분 (보유/변동)
- 보고자명
- 보유주식수 및 증감
- 보유비율 및 증감
- 변동사유
|
| get_executive_stock_reportA | DART에서 임원 및 주요주주의 주식 소유보고 정보를 조회합니다.
특정 기업의 임원 및 주요주주(10% 이상)의 특정증권등 소유 현황 및 변동 내역을 반환합니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
Returns:
임원·주요주주 소유보고 목록
- 접수번호, 접수일자
- 보고자명
- 임원여부, 직위
- 주요주주여부
- 특정증권등 소유수 및 증감
- 특정증권등 소유비율 및 증감
|
| get_periodic_reportA | DART 정기보고서의 주요정보를 유형별로 조회합니다.
27가지 보고서 유형 중 하나를 선택하여 해당 정보를 조회합니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
bsns_year: 사업연도 (예: "2024", "2023")
reprt_code: 보고서코드
11013=1분기보고서, 11012=반기보고서,
11014=3분기보고서, 11011=사업보고서(기본값)
report_type: 보고서 유형 (아래 목록에서 선택, 필수)
"증자감자현황" - 증자(감자) 현황
"배당" - 배당에 관한 사항
"자기주식취득처분" - 자기주식 취득 및 처분 현황
"최대주주현황" - 최대주주 현황
"최대주주변동" - 최대주주 변동 현황
"소액주주" - 소액주주 현황
"임원현황" - 임원 현황
"직원현황" - 직원 현황
"이사감사개인별보수" - 이사·감사의 개인별 보수 현황
"이사감사전체보수" - 이사·감사 전체의 보수 현황
"개인별보수지급" - 개인별 보수지급 금액(5억 이상 상위 5인)
"타법인출자" - 타법인 출자 현황
"채무증권발행" - 채무증권 발행실적
"기업어음미상환" - 기업어음증권 미상환 잔액
"단기사채미상환" - 단기사채 미상환 잔액
"회사채미상환" - 회사채 미상환 잔액
"신종자본증권미상환" - 신종자본증권 미상환 잔액
"조건부자본증권미상환" - 조건부자본증권 미상환 잔액
"회계감사인" - 회계감사인의 명칭 및 감사의견
"감사용역체결" - 감사용역 체결 현황
"비감사용역계약" - 회계감사인과의 비감사용역 계약체결 현황
"사외이사변동" - 사외이사 및 그 변동 현황
"미등기임원보수" - 미등기임원 보수 현황
"이사감사보수승인금액" - 이사·감사의 보수현황(주총 승인금액)
"이사감사보수유형별" - 이사·감사의 보수현황(보수지급금액 유형별)
"공모자금사용" - 공모자금의 사용내역
"사모자금사용" - 사모자금의 사용내역
Returns:
선택한 유형의 정기보고서 주요정보 (유형에 따라 반환 필드가 다름)
|
| get_major_event_reportA | DART 주요사항보고서를 이벤트 유형별로 조회합니다.
36가지 이벤트 유형 중 하나를 선택하여 해당 보고서 내용을 조회합니다.
Parameters:
corp_code: DART 고유번호 (8자리, 예: "00126380")
event_type: 이벤트 유형 (아래 목록에서 선택, 필수)
"자산양수도" - 자산양수도(주요자산 양수도 등)
"부도발생" - 부도 발생
"영업정지" - 영업 정지
"회생절차" - 회생절차 개시신청
"해산사유" - 해산사유 발생
"유상증자결정" - 유상증자 결정
"무상증자결정" - 무상증자 결정
"유무상증자결정" - 유무상증자 결정
"감자결정" - 감자 결정
"관리절차개시" - 관리절차 개시
"소송" - 소송 등
"해외상장결정" - 해외 상장 결정
"해외상장폐지결정" - 해외 상장폐지 결정
"해외상장" - 해외 상장
"해외상장폐지" - 해외 상장폐지
"전환사채발행" - 전환사채권 발행 결정
"신주인수권부사채발행" - 신주인수권부사채권 발행 결정
"교환사채발행" - 교환사채권 발행 결정
"관리절차중단" - 관리절차 중단
"상각형조건부자본증권발행" - 상각형 조건부자본증권 발행 결정
"자기주식취득결정" - 자기주식 취득 결정
"자기주식처분결정" - 자기주식 처분 결정
"자기주식신탁체결" - 자기주식취득 신탁계약 체결 결정
"자기주식신탁해지" - 자기주식취득 신탁계약 해지 결정
"영업양수결정" - 영업양수 결정
"영업양도결정" - 영업양도 결정
"유형자산양수" - 유형자산 양수 결정
"유형자산양도" - 유형자산 양도 결정
"타법인주식양수" - 타법인 주식 및 출자증권 양수 결정
"타법인주식양도" - 타법인 주식 및 출자증권 양도 결정
"사채권양수" - 사채권 양수 결정
"사채권양도" - 사채권 양도 결정
"회사합병" - 회사 합병 결정
"회사분할" - 회사 분할 결정
"회사분할합병" - 회사 분할합병 결정
"주식교환이전" - 주식의 포괄적 교환·이전 결정
bgn_de: 검색 시작일 YYYYMMDD (예: "20240101")
end_de: 검색 종료일 YYYYMMDD (예: "20241231")
Returns:
선택한 유형의 주요사항보고서 정보 (유형에 따라 반환 필드가 다름)
|
| download_documentA | 공시서류 원본파일을 다운로드합니다.
Parameters:
rcept_no: 접수번호 (14자리, search_disclosures 결과에서 확인 가능)
output_dir: 저장 디렉토리 (기본값: 현재 디렉토리)
Returns:
다운로드 결과 메시지 (파일 경로, 포함된 파일 목록)
|
| download_xbrlA | XBRL 재무제표 원본파일을 다운로드합니다.
Parameters:
corp_code: DART 고유번호 (8자리)
bsns_year: 사업연도 (예: "2024")
reprt_code: 보고서코드 (11013=1분기, 11012=반기, 11014=3분기, 11011=사업보고서)
output_dir: 저장 디렉토리 (기본값: 현재 디렉토리)
Returns:
다운로드 결과 메시지 (파일 경로, 포함된 파일 목록)
|
| get_xbrl_taxonomyB | XBRL 택사노미 재무제표 양식(표준계정과목체계)을 조회합니다.
Parameters:
sj_div: 재무제표구분
BS1=재무상태표(일반), BS2=재무상태표(특수), BS3=재무상태표(은행),
BS4=재무상태표(보험), IS1=손익계산서(일반), IS2=손익계산서(특수),
IS3=손익계산서(은행), IS4=손익계산서(보험),
DCIS=포괄손익계산서, CF1~CF4=현금흐름표, SCE=자본변동표
Returns:
표준계정과목 목록 (계정ID, 계정명, 표시순서 등)
|
| get_securities_reportB | 증권신고서 주요정보를 유형별로 조회합니다.
Parameters:
corp_code: DART 고유번호 (8자리)
report_type: 신고서 유형
"지분증권" - 지분증권
"채무증권" - 채무증권
"증권예탁증권" - 증권예탁증권
"합병" - 합병
"주식의포괄적교환이전" - 주식의 포괄적 교환·이전
"분할" - 분할
bgn_de: 검색 시작일 YYYYMMDD (기본값: 빈문자열)
end_de: 검색 종료일 YYYYMMDD (기본값: 빈문자열)
Returns:
증권신고서 주요정보
|
