open_dart

전자공시 Open Dart 분석 및 관련 자료 정리

2020-01-21 부터 시범 서비스 중인 전자공시 Open API 사용 방법에 대한 연구

기본 사항

1. https://opendart.fss.or.kr/
2. 계정 만들고(이메일) 약관 동의 후 메일로 오는 인증 링크 클릭
3. 인증키 신청/관리에서 API 인증키 확인.
4. 종목코드(stock_code. HTS, MTS 등에서 사용하는)와 Open API에서 사용하는 회사 코드 (corp_code)는 다르다. 처음에 고유번호부터 확보해야 한다.
   1. 비상장 회사 등의 중요사항 공시에 관한 규정이 있다.
   2. 종목코드 없는 비상장사 정보조회하려면 당연.
   3. https://opendart.fss.or.kr/api/corpCode.xml?crtfc_key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 로 요청하면 Zip으로 압축된 xml 파일을 다운로드 가능.
5. xml 혹은 json으로 요청하면 해당 포멧 혹은 파일을 받을 수 있음.

완전 뉴비를 위한 API 설명

1. 각 개발가이드 설명에 있는 '상세주소'를 브라우저 URL 입력하면 결과 확인 가능.

좀 더 자세한 설명

1. 인증키를 먼저 받는다.
2. '상세주소'에 요청 인자를 넣는다. URL과 요청인자 사이는 '?' 로 연결하고, 각 인자는 '&'으로 연결해 여러 인자를 넘겨줄 수 있다.
3. 각 인자에 값 지정은 '='로 한다. 아래 예시 참조
   1. 예제 1 : 삼성전자 사업연도 2019년 1분기 재무정보 조회 (crtfc_key 항목은 자신의 키를 넣어야 함.)

   https://opendart.fss.or.kr/api/fnlttSinglAcnt.json?crtfc_key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&corp_code=00126380&bsns_year=2019&reprt_code=11013
   

   1. 주의점: corp_code 인자는 위에서 설명한 회사 코드임에 주의(종목코드가 아니다). corpCode.xml 에 요청해 다운로드한 파일에서 찾아서 입력.

   2. 예제 2: 메리츠종금증권 사업연도 2018년 사업보고서 배당정보 조회

   https://opendart.fss.or.kr/api/alotMatter.json?crtfc_key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&corp_code=00163682&bsns_year=2018&reprt_code=11011
   

4. API 인증키, 고유번호, 사업연도, 보고서 코드는 기본으로 많이 사용됨.
5. Perl, Python, JAVA 등으로 각 종목, 연도, 분기 등을 다양하게 조합해서 돌아오는 결과를 DB에 넣으면 활용하기 좋을듯.