inquire_balance#

KISDomesticStock.inquire_balance(cano: str, acnt_prdt_cd: str, inqr_dvsn: str, afhr_flpr_yn: str = 'N', fund_sttl_icld_yn: str = 'N', prcs_dvsn: str = '00', ctx_area_fk100: str = '', ctx_area_nk100: str = '', tr_cont: str = '')[source]#

(국내주식주문) 주식잔고조회[v1_국내주식-006]

주식 잔고조회 API입니다.

실전계좌의 경우, 한 번의 호출에 최대 50건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

모의계좌의 경우, 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

  • 당일 전량매도한 잔고도 보유수량 0으로 보여질 수 있으나, 해당 보유수량 0인 잔고는 최종 D-2일 이후에는 잔고에서 사라집니다.

Parameters:

  • cano (str) – 종합계좌번호 - 계좌번호 체계(8-2)의 앞 8자리

  • acnt_prdt_cd (str) – 계좌상품코드 - 계좌번호 체계(8-2)의 뒤 2자리

  • inqr_dvsn (str) – 조회구분 - 01:대출일별 02:종목별

  • afhr_flpr_yn (str) – 시간외단일가여부 - N:기본값 Y:시간외단일가

  • fund_sttl_icld_yn (str) – 펀드결제분포함여부 - N:포함하지 않음 Y:포함

  • prcs_dvsn (str) – 처리구분 - 00:전일매매포함 01:전일매매미포함

  • ctx_area_fk100 (str) – 연속조회검색조건100 - 공란:최초 조회시. 이전 조회 output ctx_area_fk100 값:다음페이지 조회시(2번째부터)

  • ctx_area_nk100 (str) – 연속조회키100 - 공란:최초 조회시. 이전 조회 output ctx_area_nk100 값:다음페이지 조회시(2번째부터)

  • tr_cont (str) – 연속조회여부 - 공란:최초 조회시. N:연속조회 시

Returns:

  • rt_cd (str): 응답코드

  • msg_cd (str): 메시지코드

  • msg1 (str): 응답메시지

  • tr_cont (str): 연속조회가능여부

  • ctx_area_fk100 (str): 연속조회검색조건100

  • ctx_area_nk100 (str): 연속조회키100

  • output1 (list): 응답상세1

    • pdno: 상품번호 - 종목번호(뒷 6자리)

    • prdt_name: 상품명 - 종목명

    • trad_dvsn_name: 매매구분명 - 매수매도구분

    • bfdy_buy_qty: 전일매수수량

    • bfdy_sll_qty: 전일매도수량

    • thdt_buyqty: 금일매수수량

    • thdt_sll_qty: 금일매도수량

    • hldg_qty: 보유수량

    • ord_psbl_qty: 주문가능수량

    • pchs_avg_pric: 매입평균가격 = 매입금액 / 보유수량

    • pchs_amt: 매입금액

    • prpr: 현재가

    • evlu_amt: 평가금액

    • evlu_pfls_amt: 평가손익금액 = 평가금액 - 매입금액

    • evlu_pfls_rt: 평가손익율

    • evlu_erng_rt: 평가수익율 - 미사용항목(0으로 출력)

    • loan_dt: 대출일자 - INQR_DVSN(조회구분)을 01(대출일별)로 설정해야 값이 나옴

    • loan_amt: 대출금액

    • stln_slng_chgs: 대주매각대금

    • expd_dt: 만기일자

    • fltt_rt: 등락율

    • bfdy_cprs_icdc: 전일대비증감

    • item_mgna_rt_name: 종목증거금율명

    • grta_rt_name: 보증금율명

    • sbst_pric: 대용가격 - 증권매매의 위탁보증금으로서 현금 대신에 사용되는 유가증권 가격

    • stck_loan_unpr: 주식대출단가

  • output2 (list): 응답상세2

    • dnca_tot_amt: 예수금총금액 - 예수금

    • nxdy_excc_amt: 익일정산금액 - D+1 예수금

    • prvs_rcdl_excc_amt: 가수도정산금액 - D+2 예수금

    • cma_evlu_amt: CMA평가금액

    • bfdy_buy_amt: 전일매수금액

    • thdt_buy_amt: 금일매수금액

    • nxdy_auto_rdpt_amt: 익일자동상환금액

    • bfdy_sll_amt: 전일매도금액

    • thdt_sll_amt: 금일매도금액

    • d2_auto_rdpt_amt: D+2자동상환금액

    • bfdy_tlex_amt: 전일제비용금액

    • thdt_tlex_amt: 금일제비용금액

    • tot_loan_amt: 총대출금액

    • scts_evlu_amt: 유가평가금액

    • tot_evlu_amt: 총평가금액 - 유가증권 평가금액 합계금액 + D+2 예수금

    • nass_amt: 순자산금액

    • fncg_gld_auto_rdpt_yn: 융자금자동상환여부 - 보유현금에 대한 융자금만 차감여부. 신용융자 매수체결 시점에서는 융자비율을 매매대금 100%로 계산 하였다가 수도결제일에 보증금에 해당하는 금액을 고객의 현금으로 충당하여 융자금을 감소시키는 업무

    • pchs_amt_smtl_amt: 매입금액합계금액

    • evlu_amt_smtl_amt: 평가금액합계금액 - 유가증권 평가금액 합계금액

    • evlu_pfls_smtl_amt: 평가손익합계금액

    • tot_stln_slng_chgs: 총대주매각대금

    • bfdy_tot_asst_evlu_amt: 전일총자산평가금액

    • asst_icdc_amt: 자산증감액

    • asst_icdc_erng_rt: 자산증감수익율 - 데이터 미제공

Return type:

dict

Raises:

ValueError – API 에러 발생시

On this page
Show Source