get_foreign_institution_total#

KISDomesticStock.get_foreign_institution_total(fid_input_iscd: str, fid_div_cls_code: str, fid_rank_sort_cls_code: str, fid_etc_cls_code: str, tr_cont: str = '')[source]#

(국내주식시세) 국내기관_외국인 매매종목가집계[국내주식-037]

국내기관_외국인 매매종목가집계 API입니다.

증권사 직원이 장중에 집계/입력한 자료를 단순 누계한 수치로서, 입력시간은 외국인 09:30, 11:20, 13:20, 14:30 / 기관종합 10:00, 11:20, 13:20, 14:30 이며 사정에 따라 변동될 수 있습니다.

Parameters:
  • fid_input_iscd (str) – 입력 종목코드 - 0000:전체, 0001:코스피, 1001:코스닥, … 포탈 (FAQ : 종목정보 다운로드 - 업종코드 참조)

  • fid_div_cls_code (str) – 분류 구분 코드 - 0: 수량정열, 1: 금액정열

  • fid_rank_sort_cls_code (str) – 순위 정렬 구분 코드 - 0: 순매수상위, 1: 순매도상위

  • fid_etc_cls_code (str) – 기타 구분 정렬 - 0:전체 1:외국인 2:기관계 3:기타

  • tr_cont (str) – 연속조회여부

Returns:

dict

  • rt_cd (str): 응답코드

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

  • msg_cd (str): 메시지코드

  • msg1 (str): 메시지1

  • output (list): 응답상세

    • hts_kor_isnm: HTS 한글 종목명

    • mksc_shrn_iscd: 유가증권 단축 종목코드

    • ntby_qty: 순매수 수량

    • stck_prpr: 주식 현재가

    • prdy_vrss_sign: 전일 대비 부호

    • prdy_vrss: 전일 대비

    • prdy_ctrt: 전일 대비율

    • acml_vol: 누적 거래량

    • frgn_ntby_qty: 외국인 순매수 수량

    • orgn_ntby_qty: 기관계 순매수 수량

    • ivtr_ntby_qty: 투자신탁 순매수 수량

    • bank_ntby_qty: 은행 순매수 수량

    • insu_ntby_qty: 보험 순매수 수량

    • mrbn_ntby_qty: 종금 순매수 수량

    • fund_ntby_qty: 기금 순매수 수량

    • etc_orgt_ntby_vol: 기타 단체 순매수 거래량

    • etc_corp_ntby_vol: 기타 법인 순매수 거래량

    • frgn_ntby_tr_pbmn: 외국인 순매수 거래 대금 - frgn_ntby_tr_pbmn ~ etc_corp_ntby_tr_pbmn (단위 : 백만원, 수량*현재가)

    • orgn_ntby_tr_pbmn: 기관계 순매수 거래 대금

    • ivtr_ntby_tr_pbmn: 투자신탁 순매수 거래 대금

    • bank_ntby_tr_pbmn: 은행 순매수 거래 대금

    • insu_ntby_tr_pbmn: 보험 순매수 거래 대금

    • mrbn_ntby_tr_pbmn: 종금 순매수 거래 대금

    • fund_ntby_tr_pbmn: 기금 순매수 거래 대금

    • etc_orgt_ntby_tr_pbmn: 기타 단체 순매수 거래 대금

    • etc_corp_ntby_tr_pbmn: 기타 법인 순매수 거래 대금

Raises:

ValueError – API 에러 발생시