OpenDART API 85종을 엑셀로 — 공시 수집기 기능설명

하는 일

금융감독원 전자공시가 공개한 OpenDART Open API 85종을 화면에서 골라 조회하고, 그 결과를 엑셀로 내보냅니다. 회사와 사업연도를 여러 개 넣으면 순서대로 반복 조회해 한 표로 모아 줍니다.

OpenDART는 한 번에 회사 하나, 연도 하나만 받습니다. 그 반복을 사람이 하지 않아도 되게 만든 것이 이 도구입니다.

넣는 것

조회할 수 있는 자료

OpenDART가 공개한 85종을 여섯 갈래로 묶어 두었습니다. 이름을 몰라도 검색창에 배당, 최대주주 처럼 치면 걸립니다.

회사 찾기

OpenDART는 회사를 8자리 고유번호로 지목합니다. 회사 목록 약 11만 8천 개사를 받아 두면 이름으로 찾아 넣을 수 있습니다.

자료 기준일

프로그램을 켤 때 받아둔 목록이 최신인지 조용히 확인합니다. 오래되었으면 회사 DB 가 빨갛게 바뀝니다. 본문 전체를 받지 않고 파일 크기만 물어보므로 0.3초면 끝납니다.

결과

엑셀과 받은 그대로의 원본

한글 필드명

OpenDART가 주는 값은 corp_code, rcept_no 같은 영문 이름입니다. 바로 알아볼 수 있게 한글 이름을 붙여 두었습니다.

결과 표

세부 규칙

복수 회사·연도 일괄 조회

페이지 넘기기

한 번에 100건씩 오고 그다음 쪽이 남아 있으면 마지막 쪽까지 이어서 받습니다. 전체 페이지 자동 수집을 끄면 첫 쪽만 받습니다.

다시 시도

중지했거나, 통신이 끊겼거나, 하루 요청 한도 초과(020)·시스템 점검(800)으로 멈추면 못 받은 요청을 모두 보관합니다. 실패·남은 N건 다시 시도 로 그 지점부터 이어받습니다. 여러 쪽을 받던 중이었다면 끊긴 쪽부터 받으므로 이미 받은 행이 두 번 들어가지 않습니다.

중지

중지 를 누르면 서버 응답을 기다리지 않고 곧바로 멈춥니다. 그때까지 받은 결과는 그대로 남습니다.

조회 중 탭 옮기기

결과는 조회를 시작한 탭에만 쌓입니다. 조회가 도는 동안 다른 탭을 보거나 다른 API 를 골라도 섞이지 않고, 탭을 옮기면 요청 인자 칸도 그 탭의 API·조건으로 바뀝니다.

하지 않는 것 · 한계

조회 기록과 결과 탭은 저장하지 않습니다. 남기려면 끄기 전에 엑셀로 내보내세요.

자료가 오가는 곳

조회하려면 인증키와 조회 조건이 opendart.fss.or.kr 로 전송됩니다 — 그래야 자료를 받아 올 수 있습니다. 받아 온 결과는 이 컴퓨터에서만 처리되며 어디로도 업로드되지 않습니다. 중계 프록시, 분석 도구, 외부 글꼴·CDN을 일절 쓰지 않고, 만든 이에게는 인증키도 조회 내용도 오지 않습니다.

버전 확인

그 한 번은 kongsist.com/version.json 으로 갑니다. 올라와 있는 버전 번호를 받아 프로그램에 박힌 번호와 견주는 것이 전부이며, 인증키도 조회 결과도 실리지 않습니다. 오프라인이거나 사내망에서 막혀 있으면 아무것도 표시하지 않고 그냥 넘어갑니다.

자주 묻는 것

인증키는 어디서 받나요?

opendart.fss.or.kr 에서 회원가입한 뒤 인증키 신청/관리 에서 발급받습니다. 40자리입니다. 화면을 보며 따라 하려면 인증키 신청하는 방법 을 보세요.

처음 실행할 때 파란 경고창이 뜹니다

코드 서명을 하지 않아 나오는 Windows 경고입니다. 추가 정보 → 실행 을 누르면 됩니다.

회사 이름을 쳤는데 후보가 안 뜹니다

회사 목록을 아직 받지 않은 것입니다. 회사 DB 내려받기 를 눌러 한 번 받으면 계속 쓰입니다.

「페이지 별 건수」는 무엇인가요?

한 번에 몇 건씩 나눠 받을지입니다. 받는 자료의 양은 같고 요청 횟수만 달라집니다. 기본값 100 그대로 두시면 됩니다.

조회했더니 결과가 없다고 나옵니다

상태 코드 013 은 조건에 맞는 자료가 없다는 뜻이며 오류가 아닙니다. 정기보고서 항목은 그 해에 제출한 보고서가 있어야 값이 나옵니다.

공시검색에서 기간을 길게 잡으니 거절됩니다

고유번호 없이 조회하면 기간이 3개월로 제한됩니다. 회사를 지정하면 길게 잡을 수 있습니다. 기본 시작일은 3개월 전으로 잡혀 있어 그대로 조회하면 됩니다.

「요청 한도 초과(020)」로 멈췄습니다

OpenDART 인증키 하나로 하루 약 2만 건까지 요청할 수 있습니다. 남은 요청은 그 탭에 보관돼 있으니 프로그램을 끄지 않은 채 다음 날 다시 시도 를 누르면 이어받습니다. 프로그램을 끄면 결과 탭과 함께 사라집니다.

결과가 몇만 행인데 화면에 다 안 나옵니다

화면에는 500행까지만 그립니다. 엑셀로 내보내면 전부 들어 있습니다.

재무비율은 어떻게 계산된 값인가요?

주요 재무지표 67종의 계산식은 재무비율 계산식 에 정리해 두었습니다.