4. DART API 사용법 - 참 쉽죠잉?

DART API는 RestAPI형태로 각 API에 따른 인자들을 포함한 url을 request.get()으로 요청하면 답을 받아오기에 직관적으로 이해할 수 있다. 

 

예를 들어, KOSPI 또는 KOSDAQ에 상장된 회사의 배당정보를 알고 싶으면, 

개발가이드 > 정기보고서 주요정보 > 배당에 관한 사항 > 바로가기를 선택하면 해당 API 가이드가 나타난다.

 

 

해당 API 가이드에 따르면,

요청URL, crtfc_key, corp_code, bsns_year, reprt_code 등으로 하나의 URL을 만들어서 request.get()으로 요청하면,

아래와 같은 응답이 나온다.

 

하나의 예제가 있어야... 이해가 쉬울듯. 마침 해당 화면 아래 테스트 창이 있다. 

 

API 인증키는 앞에서 신청하여 받은 것을 문자열로 넣으면 된다. 

아래는 실제 API의 응답이다. 위의 응답결과에서 설명한 것처럼 각 key가 어떤 뜻인지 맞춰보면 된다.

즉, 'frmtrm'는 '전기'를 뜻한다. (당기, 전기, 전전기의 '전기')

{

	"status":"000",
    "message":"정상",
    "list":[
    	{
    	"rcept_no":"20250311001085",
        "corp_cls":"Y",
        "corp_code":"00126380",
        "corp_name":"삼성전자",
        "se":"주당액면가액(원)",
        "thstrm":"100",
        "frmtrm":"100",
        "lwfr":"100",
        "stlm_dt":"2024-12-31"
        },
        {
        "rcept_no":"20250311001085",
        "corp_cls":"Y",
        "corp_code":"00126380",
        "corp_name":"삼성전자",
        "se":"(연결)당기순이익(백만원)",
        "thstrm":"33,621,363",
        "frmtrm":"14,473,401",
        "lwfr":"54,730,018",
        "stlm_dt":"2024-12-31"
        },
        {
        "rcept_no":"20250311001085",
        "corp_cls":"Y",
        "corp_code":"00126380",
        "corp_name":"삼성전자",
        "se":"(별도)당기순이익(백만원)",
        "thstrm":"23,582,565",
        "frmtrm":"25,397,099",
        "lwfr":"25,418,778",
        "stlm_dt":"2024-12-31"},
        ...

 

특히 알고 싶은 내용은 배당금!

	{
	"rcept_no":"20250311001085",
	"corp_cls":"Y",
    "corp_code":"00126380",
    "corp_name":"삼성전자",
    "se":"주당 현금배당금(원)",
    "stock_knd":"보통주",
    "thstrm":"1,446",
    "frmtrm":"1,444",
    "lwfr":"1,444",
    "stlm_dt":"2024-12-31"
    },{
    "rcept_no":"20250311001085",
    "corp_cls":"Y",
    "corp_code":"00126380",
    "corp_name":"삼성전자",
    "se":"주당 현금배당금(원)",
    "stock_knd":"우선주",
	"thstrm":"1,447",
    "frmtrm":"1,445",
    "lwfr":"1,445",
    "stlm_dt":"2024-12-31"
    },

 

삼성전자 보통주의 2024년 당기 배당금은 1,446월, 우선주 당기 배당금은 1,447원!

이런 식으로 데이터를 구하면 된다. 

 

참 쉽죠잉?