DART 고유번호(corp_code)를 회사명 또는 종목코드로 조회합니다.

다른 DART 도구들은 대부분 corp_code(8자리)를 필요로 하므로, 먼저 이 도구로 회사의 corp_code를 확보하세요. 비상장법인도 조회할 수 있습니다. 회사명은 부분 일치 검색을 지원합니다.

IMPORTANT: 영문명만 알고 한글 정식 명칭을 모르는 경우, 웹 검색으로 정확한 한글 명칭을 먼저 확인한 뒤 corp_name에 입력하면 정확도가 올라갑니다.

Args: corp_name: 회사 명칭(한글 또는 영문). 부분 일치 검색 지원. stock_code: 상장회사의 종목코드(6자리, 예: 005930). limit: 반환할 최대 회사 수 (기본값: 20).

기업개황: 회사의 기본 정보를 조회합니다. corp_code는 get_corp_code로 확보하세요.

회사명(정식/영문/약식), 대표자명, 법인구분(corp_cls: Y유가/K코스닥/N코넥스/E기타), 종목코드, 업종코드, 설립일, 결산월, 주소, 홈페이지, 전화 등을 제공합니다.

Args: corp_code: 공시대상회사 고유번호(8자리).

공시검색: 회사·기간·공시유형 등 여러 조건으로 공시 목록을 조회합니다.

최근 공시를 검색할 때는 bgn_de(YYYYMMDD)를 반드시 지정하세요. 특정 회사의 공시만 보려면 먼저 get_corp_code로 corp_code(8자리)를 확보하세요.

Args: corp_code: 공시대상회사 고유번호(8자리). bgn_de: 검색 시작 접수일자(YYYYMMDD). 기본값은 종료일(end_de). end_de: 검색 종료 접수일자(YYYYMMDD). 기본값은 당일. last_reprt_at: 최종보고서만 검색할지 여부(Y/N). 기본값 N. pblntf_ty: 공시유형 한 글자 — A:정기공시, B:주요사항보고, C:발행공시, D:지분공시, E:기타공시, F:외부감사관련, G:펀드공시, H:자산유동화, I:거래소공시, J:공정위공시. pblntf_detail_ty: 공시상세유형(4자리). corp_cls: 법인구분 — Y:유가증권, K:코스닥, N:코넥스, E:기타. (복수 지정 불가) sort: 정렬 기준 — date:접수일자, crp:회사명, rpt:보고서명. 기본값 date. sort_mth: 정렬 방법 — asc:오름차순, desc:내림차순. 기본값 desc. page_no: 페이지 번호(1n). 기본값 1. page_count: 페이지당 건수(1100). 기본값 10, 최대 100.

공시서류 원본을 파싱해 가져옵니다. (접수번호는 get_disclosure_list의 rcept_no)

문서가 크면(약 200KB 초과) 전체 대신 목차(result.type == "toc")를 반환합니다. 목차가 반환되면 유저의 질문과 관련된 섹션을 section_id로 다시 조회하세요. 답변 후에는 조회하지 않은 나머지 섹션 목록을 유저에게 안내해 추가 조회 여부를 선택하게 하세요. 지정한 섹션도 크면 하위 목차(parent_section_id 포함)를 반환합니다.

Args: rcept_no: 접수번호(14자리). section_id: 조회할 섹션 ID(목차의 sections[].id = AASSOCNOTE). 생략하면 전체를 시도하고, 크면 목차를 반환합니다.

재무제표: 정기보고서 내 XBRL 재무제표의 모든 계정과목을 조회합니다.

상장법인(유가·코스닥) 및 주요 비상장법인(사업보고서 제출대상 & IFRS 적용)이 제출한 정기보고서의 전체 계정을 제공합니다. corp_code는 get_corp_code로 확보하세요.

Args: corp_code: 공시대상회사 고유번호(8자리). bsns_year: 사업연도(4자리). 2015년 이후부터 제공. reprt_code: 보고서 코드 — 11013:1분기, 11012:반기, 11014:3분기, 11011:사업보고서. fs_div: 개별/연결 구분 — OFS:재무제표(개별), CFS:연결재무제표. sj_nm: 특정 재무제표만 필터링 — 재무상태표, 손익계산서, 포괄손익계산서, 자본변동표, 현금흐름표 중 하나. 생략하면 전체 반환.

특정 종목의 특정 영업일 일별 매매정보(시세)를 조회합니다.

종가(TDD_CLSPRC), 전일대비(CMPPREVDD_PRC), 등락률(FLUC_RT), 시/고/저가, 거래량(ACC_TRDVOL), 거래대금(ACC_TRDVAL), 시가총액(MKTCAP), 상장주식수(LIST_SHRS) 등을 KRX 원본 필드 그대로 반환합니다.

bas_dd는 반드시 영업일(YYYYMMDD)이어야 합니다. 주말/공휴일이면 데이터가 없으니, get_today_date로 오늘을 확인하고 비영업일이면 직전 영업일로 다시 조회하세요. market을 모르면 생략하세요 — 시장을 자동 판별합니다.

Args: stock_code: 종목 단축코드(6자리, 예: 005930). bas_dd: 기준 영업일(YYYYMMDD). market: KOSPI | KOSDAQ | KONEX. 생략 시 자동 판별.

특정 종목의 기본정보를 조회합니다.

종목명(ISU_NM/ISU_ABBRV), 표준코드(ISU_CD), 단축코드(ISU_SRT_CD), 시장구분(MKT_TP_NM), 증권구분(SECUGRP_NM), 상장일(LIST_DD), 액면가(PARVAL), 상장주식수(LIST_SHRS) 등을 KRX 원본 필드 그대로 반환합니다.

bas_dd는 영업일(YYYYMMDD)이어야 합니다. market을 모르면 생략하세요(자동 판별).

Args: stock_code: 종목 단축코드(6자리, 예: 005930). bas_dd: 기준 영업일(YYYYMMDD). market: KOSPI | KOSDAQ | KONEX. 생략 시 자동 판별.

종목코드가 속한 시장(KOSPI/KOSDAQ/KONEX)을 판별합니다.

먼저 DART 기업개황(corp_cls)으로 판별을 시도하고, 실패하면 KRX 종목기본정보를 시장별로 조회해 판별합니다. KRX 시세/기본정보 조회의 진입점으로 쓰입니다.

Args: stock_code: 종목 단축코드(6자리, 예: 005930). bas_dd: 기준 영업일(YYYYMMDD). 생략 시 최근 영업일로 시도합니다.

오늘 날짜를 KST와 UTC 기준으로 제공합니다.

DART 조회에 쓰이는 YYYYMMDD 형식과 ISO 형식을 함께 반환합니다. "최근", "올해" 같은 상대적 날짜 질의를 해석할 때 사용하세요.