전자공시 Open API를 사용하여 기업의 재무제표를 조회하는 방법을 소개합니다. 이 API를 통해 기업의 재무상태표와 손익계산서를 손쉽게 조회할 수 있습니다. 이번 포스트에서는 삼성전자의 2018년도 재무제표를 예제로 사용하여 데이터를 추출하고, 이를 다른 포털사이트의 데이터와 비교해보겠습니다.
전자공시 Open API 개요
전자공시 Open API는 금융감독원에서 제공하는 서비스로, 기업의 공시 정보를 조회할 수 있는 기능을 제공합니다. 이를 통해 사용자들은 필요한 기업의 재무정보를 손쉽게 접근하고 활용할 수 있습니다.
API 인증키 발급
API를 사용하기 위해서는 먼저 인증키를 발급받아야 합니다. 금융감독원의 Open API 홈페이지에 가입 후, 인증키를 요청하면 됩니다.
고유번호 활용
기업 정보를 조회할 때, 종목코드 대신 고유번호가 필요합니다. 고유번호는 다트에서 제공하는 기업정보 상세조회에서 확인할 수 있습니다.
기업 재무제표 조회 API 사용 방법
삼성전자의 고유번호인 00126380을 사용하여 2018년도 사업보고서를 조회하는 방법을 알아보겠습니다.
Python 코드 예제
다음의 코드를 사용하여 삼성전자의 재무제표 데이터를 조회할 수 있습니다.
“`python
import requests
import json
URL = ‘https://opendart.fss.or.kr/api/fnlttSinglAcnt.json’
PARAMS = {
‘crtfc_key’: ‘Insert your crtfc key’, # API 인증키
‘corp_code’: ‘00126380’, # 삼성전자 고유번호
‘bsns_year’: ‘2018’, # 사업연도
‘reprt_code’: ‘11011’, # 사업보고서
}
resp = requests.get(url=URL, params=PARAMS)
if resp.status_code == 200:
data_json = resp.json()
if data_json['status'] == "000":
detail = data_json['list']
for x in detail:
if x['fs_div'] == 'CFS' and x['sj_div'] == 'IS' and x['account_nm'] == '당기순이익':
print(json.dumps(x, indent=4, ensure_ascii=False))
else:
print(data_json['message'])
“`
응답 데이터 분석
이 API를 통해 받은 응답 데이터는 다음과 같은 형식을 가집니다.
json
{
"status": "000",
"message": "정상",
"list": [
{
"rcept_no": "20190401004781",
"bsns_year": "2018",
"corp_code": "00126380",
"account_nm": "당기순이익",
"thstrm_amount": "44,344,857,000,000",
...
}
]
}
여기서 thstrm_amount는 2018년도 당기순이익을 나타내며, 이 값은 443,449억원입니다.
데이터 비교 및 활용
다트 Open API를 통해 조회한 재무제표는 다른 포털사이트에서 제공하는 데이터와 비교하여 검증할 수 있습니다. 이 과정에서 데이터를 판다스(Pandas) 라이브러리를 활용하여 DataFrame으로 변환하면 더욱 효율적으로 데이터를 처리할 수 있습니다.
pandas 라이브러리 설치
Pandas를 사용하기 위해 설치가 필요합니다. 아래의 명령어로 설치할 수 있습니다.
bash
pip install pandas
자주 묻는 질문
전자공시 Open API는 무료인가요?
전자공시 Open API는 무료로 제공되지만, 사용량에 따라 제한이 있을 수 있습니다.
API 사용 시 주의할 점은 무엇인가요?
API를 사용할 때는 매번 호출할 때마다 인증키를 사용해야 하며, 요청 시 데이터의 유효성을 확인하여야 합니다.
어떤 데이터를 조회할 수 있나요?
재무제표, 기업개황, 공시대상회사 등 다양한 기업 정보를 조회할 수 있습니다.
데이터 조회 시 어떤 형식으로 반환되나요?
API는 JSON 형식으로 데이터를 반환하며, 각 기업의 재무정보를 포함합니다.