get_stock_condition_search_results#

KISDomesticStock.get_stock_condition_search_results(user_id: str, seq: str, tr_cont: str = '')[source]#

(국내주식시세) 종목조건검색조회 [국내주식-039]

HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API입니다. 종목조건검색 목록조회 API(/uapi/domestic-stock/v1/quotations/psearch-title)의 output인 ‘seq’을 종목조건검색조회 API(/uapi/domestic-stock/v1/quotations/psearch-result)의 input으로 사용하시면 됩니다.

※ 시스템 안정성을 위해 API로 제공되는 조건검색 결과의 경우 조건당 100건으로 제한을 둔 점 양해 부탁드립니다.

※ [0110] 화면의 ‘대상변경’ 설정사항은 HTS [0110] 사용자 조건검색 화면에만 적용됨에 유의 부탁드립니다.

※ ‘조회가 계속 됩니다. (다음을 누르십시오.)’ 오류 발생 시 해결방법 → HTS(efriend Plus) [0110] 조건검색 화면에서 조건을 등록하신 후, 왼쪽 하단의 “사용자조건 서버저장” 클릭하셔서 등록한 조건들을 서버로 보낸 후 다시 API 호출 시도 부탁드립니다.

※ {“rt_cd”:”1”,”msg_cd”:”MCA05918”,”msg1”:”종목코드 오류입니다.”} 메시지 발생 이유 → 조건검색 결과 검색된 종목이 0개인 경우 위 응답값을 수신하게 됩니다.

Parameters:

  • user_id (str) – 사용자 HTS ID

  • seq (str) – 사용자조건 키값 - 종목조건검색 목록조회 API의 output인 ‘seq’값을 사용 (0번부터 시작)

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

Returns:

  • rt_cd (str): 응답코드

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

  • msg_cd (str): 메시지코드

  • msg1 (str): 메시지1

  • output (list): 응답상세

    • code (str): 종목코드

    • name (str): 종목명

    • daebi (int): 전일대비부호 (1:상한 2:상승 3:보합 4:하한 5:하락)

    • price (int): 현재가

    • chgrate (Decimal): 등락율

    • acml_vol (Decimal): 거래량

    • trade_amt (Decimal): 거래대금

    • change (Decimal): 전일대비

    • cttr (Decimal): 체결강도

    • open (Decimal): 시가

    • high (Decimal): 고가

    • low (Decimal): 저가

    • high52 (Decimal): 52주최고가

    • low52 (Decimal): 52주최저가

    • expprice (Decimal): 예상체결가

    • expchange (Decimal): 예상대비

    • expchggrate (Decimal): 예상등락률

    • expcvol (Decimal): 예상체결수량

    • chgrate2 (Decimal): 전일거래량대비율

    • expdaebi (int): 예상대비부호

    • recprice (Decimal): 기준가

    • uplmtprice (Decimal): 상한가

    • dnlmtprice (Decimal): 하한가

    • stotprice (Decimal): 시가총액

Return type:

dict

On this page
Show Source