키움 OPEN API - 조건검색 - 기본설명

        

        [조건검색 개요]

        키움OpenAPI에서 제공하는 조건검색 기능은 영웅문HTS에서 작성 조건식을 불러서 사용하는 방식이며 OpenAPI에서 조건검색 수식작성이나

        수식편집은 지원하지 않습니다.

        

        조건검색 관련 6개 함수와 3개 이벤트 함수가 제공되며 이를 이용해서 조건검색과 실시간 조건검색(반복적인 조건검색 요청없이 

        자동으로 신규종목 편입, 이탈되는 기능)을 설정할수 있습니다.

        영웅문HTS와 동일하게 실시간 조건검색은 최대 10개 조건식만 실시간 조건검색으로 요청할수 있는데 조건검색 결과가 100종목을 

        넘게 되면 실시간 조건검색을 할수가 없습니다.

        

        [조건검색 제한]

        조건검색(실시간 조건검색 포함)은 시세조회와 관심종목조회와 합산해서 1초에 5회만 요청 가능하며 1분에 1회로 조건검색 제한됩니다.

        조건검색 제한에 대한 자세한 내용은 하단을 참고해 주세요.

        

        10개 조건검색식을 한번에 모두 조회하는 프로그램이 있으며 조건검색만 요청한다고 가정해서 설명하면 다음과 같습니다.

        

        ------------------------------------------------------------------------------------------------------------------------------------

        

        첫번째 제한조건 : 1초에 5회만 조회가능

        두번째 제한조건 : 조건별 1분당 1회로 제한(실시간 조건검색 수신에는 영향없음)

        

        09:00:00  조회 시작

        1번부터 5번 조건식은 조회성공(첫번째 제한조건, 두번째 제한조건 모두 만족)

        6번부터 10번 조건식은 조회실패(첫번째 제한조건)

        

        09:00:01 조회 재시작(1초후 재조회)

        1번부터 5번 조건식은 조회실패(두번째 제한조건)

        6번부터 10번 조건식은 조회성공(첫번째 제한조건, 두번째 제한조건 모두 만족)

        ... ... ...

        

        09:01:00 조회시작 (첫조회 1분후)

        1번부터 5번 조건식은 조회성공(첫번째 제한조건, 두번째 제한조건 모두 만족)

        6번부터 10번 조건식은 조회실패(첫번째 제한조건)

        

        09:00:01 조회 재시작(1분 1초후 재조회)

        1번부터 5번 조건식은 조회실패(두번째 제한조건)

        6번부터 10번 조건식은 조회성공(첫번째 제한조건, 두번째 제한조건 모두 만족)

        

        ------------------------------------------------------------------------------------------------------------------------------------

        

        [실시간 조건검색]

        실시간 조건검색 결과로 100종목 이상이 검색되는 조건식은 실시간 조건검색 실행이 안됩니다.그리고 실시간 조건검색은 모두 10개 

        조건식만 사용할 수 있습니다.