get_volume_rank

KISDomesticStock.get_volume_rank(fid_input_iscd: str, fid_div_cls_code: str, fid_blng_cls_code: str, fid_trgt_cls_code: str, fid_trgt_excls_cls_code: str, fid_input_price_1: int = None, fid_input_price_2: int = None, fid_vol_cnt: int = None)

(국내주식시세) 거래량순위[v1_국내주식-047]

국내주식 거래량순위 API입니다.

한국투자 HTS(eFriend Plus) > [0171] 거래량 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

최대 30건 확인 가능하며, 다음 조회가 불가합니다. +30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.

종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로, HTS [0110]에서 여러가지 조건을 설정할 수 있는데, 그 중 거래량 순위(ex. 0봉전 거래량 상위순 100종목) 에 대해서도 설정해서 종목을 검색할 수 있습니다.

자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 API 이용안내 참고 부탁드립니다.

Parameters:

• fid_input_iscd (str) – 입력 종목코드 0000(전체) 기타(업종코드)

• fid_div_cls_code (str) – 분류 구분 코드 0:전체 1:보통주 2:우선주

• fid_blng_cls_code (str) – 소속 구분 코드 0:평균거래량 1:거래증가율 2:평균거래회전율 3:거래금액순 4:평균거래금액회전율

• fid_trgt_cls_code (str) –

  대상 구분 코드

  1 or 0 9자리 (차례대로 증거금 30% 40% 50% 60% 100% 신용보증금 30% 40% 50% 60%)

  ex) “111111111”

• fid_trgt_exls_cls_code (str) –

  대상 제외 구분 코드

  1 or 0 6자리 (차례대로 투자위험/경고/주의 관리종목 정리매매 불성실공시 우선주 거래정지)

  ex) “000000”

• fid_input_price_1 (int) –

  입력 가격1 - 가격 ~

  ex) 0

  전체 가격 대상 조회 시 FID_INPUT_PRICE_1, FID_INPUT_PRICE_2 모두 None

• fid_input_price_2 (int) –

  입력 가격2 - ~ 가격

  ex) 1000000

  전체 가격 대상 조회 시 FID_INPUT_PRICE_1, FID_INPUT_PRICE_2 모두 None

• fid_vol_cnt (int) –

  거래량 수 - 거래량 ~

  ex) 100000

  전체 거래량 대상 조회 시 FID_VOL_CNT None

Returns:

• rt_cd (str): 응답코드

• msg_cd (str): 메시지코드

• msg1 (str): 메시지1

• output (list): 응답상세

  • hts_kor_isnm: HTS 한글 종목명

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

  • data_rank: 데이터 순위

  • stck_prpr: 주식 현재가

  • prdy_vrss_sign: 전일 대비 부호

  • prdy_vrss: 전일 대비

  • prdy_ctrt: 전일 대비율

  • acml_vol: 누적 거래량

  • prdy_vol: 전일 거래량

  • lstn_stcn: 상장 주수

  • avrg_vol: 평균 거래량

  • n_befr_clpr_vrss_prpr_rate: N일전종가대비현재가대비율

  • vol_inrt: 거래량증가율

  • vol_tnrt: 거래량 회전율

  • nday_vol_tnrt: N일 거래량 회전율

  • avrg_tr_pbmn: 평균 거래 대금

  • tr_pbmn_tnrt: 거래대금회전율

  • nday_tr_pbmn_tnrt: N일 거래대금 회전율

  • acml_tr_pbmn: 누적 거래 대금

Return type:

dict

Raises:

ValueError – API 에러 발생시