get_dividend_schedule

KISDomesticStock.get_dividend_schedule(gb1: str, f_dt: str, t_dt: str, sht_cd: str = '', high_gb: str = '0', cts: str = '') → dict

(예탁원정보) 배당일정[v1_국내주식-145]

예탁원정보(배당일정) API입니다. 한국투자 HTS(eFriend Plus) > [0658] 배당 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

Parameters:

• gb1 (str) – 조회구분 - 0: 배당전체, 1: 결산배당, 2: 중간배당

• f_dt (str) – 조회일자From - 일자 ~

• t_dt (str) – 종목코드To - ~ 일자

• sht_cd (str) – 종목코드 - 공백: 전체, 특정종목 조회시 : 종목코드

Returns:

• rt_cd (str): 성공 실패 여부

• msg_cd (str): 응답코드

• msg1 (str): 응답메세지

• output1 (list of dict): 응답상세

  • record_date (str): 기준일

  • sht_cd (str): 종목코드

  • isin_name (str): 종목명

  • divi_kind (str): 배당종류

  • face_val (int): 액면가

  • per_sto_divi_amt (int): 현금배당금

  • divi_rate (Decimal): 현금배당률(%)

  • stk_divi_rate (Decimal): 주식배당률(%)

  • divi_pay_dt (str): 배당금지급일

  • stk_div_pay_dt (str): 주식배당지급일

  • odd_pay_dt (str): 단주대금지급일

  • stk_kind (str): 주식종류

  • high_divi_gb (str): 고배당종목여부

Return type:

dict

Raises:

ValueError – API 에러 발생시