[키움 OpenAPI] TR OPT10017 (상하한가요청) 코드 in Python

by


키움 OpenAPI의 TR OPT10017 (상하한가요청)을 요청하는 코드를 작성하고 테스트한 내용을 정리합니다.

TR 요청을 위해서는 키움 OpenAPI에 로그인이 되어야 하고 데이터 조회와 처리를 처리할 수 있는 코드가 사전에 작성이 되어야 합니다.

OPT10017 (상하한가요청)

‘KOA StudioSA’ 에서는 아래와 같이 설명하고 있습니다. 

[ opt10017 : 상하한가요청 ]

1. Open API 조회 함수 입력값을 설정합니다.
	시장구분 = 000:전체, 001:코스피, 101:코스닥
	SetInputValue("시장구분"	,  "입력값 1");

	상하한구분 = 1:상한, 2:상승, 3:보합, 4: 하한, 5:하락, 6:전일상한, 7:전일하한
	SetInputValue("상하한구분"	,  "입력값 2");

	정렬구분 = 1:종목코드순, 2:연속횟수순(상위100개), 3:등락률순
	SetInputValue("정렬구분"	,  "입력값 3");

	종목조건 = 0:전체조회,1:관리종목제외, 3:우선주제외, 4:우선주+관리종목제외, 5:증100제외, 6:증100만 보기, 7:증40만 보기, 8:증30만 보기, 9:증20만 보기, 10:우선주+관리종목+환기종목제외
	SetInputValue("종목조건"	,  "입력값 4");

	거래량구분 = 00000:전체조회, 00010:만주이상, 00050:5만주이상, 00100:10만주이상, 00150:15만주이상, 00200:20만주이상, 00300:30만주이상, 00500:50만주이상, 01000:백만주이상
	SetInputValue("거래량구분"	,  "입력값 5");

	신용조건 = 0:전체조회, 1:신용융자A군, 2:신용융자B군, 3:신용융자C군, 4:신용융자D군, 9:신용융자전체
	SetInputValue("신용조건"	,  "입력값 6");

	매매금구분 = 0:전체조회, 1:1천원미만, 2:1천원~2천원, 3:2천원~3천원, 4:5천원~1만원, 5:1만원이상, 8:1천원이상
	SetInputValue("매매금구분"	,  "입력값 7");


2. Open API 조회 함수를 호출해서 전문을 서버로 전송합니다.
	CommRqData( "RQName"	,  "opt10017"	,  "0"	,  "화면번호");

Input 정보는 위 KOA 설명에 포함되어 있습니다.

Output 정보는 아래 Config.py의 정보/목록으로 대체하여 기록합니다.

파일 구조

ㄴ Config.py
ㄴ KiwoomAPI.py
ㄴ KiwoomMain.py

Config.py

TR 요청 시, 조회할 OUTPUT 데이터를 정의 합니다.

output_list = {
    'OPT10017': ['종목코드',
                 '종목정보',
                 '종목명',
                 '현재가',
                 '전일대비기호',
                 '전일대비',
                 '등락률',
                 '거래량',
                 '전일거래량',
                 '매도잔량',
                 '매도호가',
                 '매수호가',
                 '매수잔량',
                 '횟수'
                 ],
}

KiwoomMain.py

import sys
from PyQt5.QtWidgets import *
import KiwoomAPI
from Config import *

class KiwoonMain:
    def __init__(self):
        self.kiwoom = KiwoomAPI.KiwoomAPI()
        self.kiwoom.CommConnect()

    def OPT10017(self):
        self.kiwoom.output_list = output_list['OPT10017']

        self.kiwoom.SetInputValue("시장구분", "0")
        self.kiwoom.SetInputValue("상하한구분", "1")
        self.kiwoom.CommRqData("OPT10017", "OPT10017", 0, "0101")

        return self.kiwoom.ret_data['OPT10017']

실행

app = QApplication(sys.argv)
api_con = KiwoonMain()

result = api_con.OPT10017()
print(result['Data'][0])

결과

[GetPCIdentity] VER 3.2.0.0  build 2015.8.12

[GetPCIdentity] VER 3.2.0.0  build 2015.8.12
0
0101 OPT10017 OPT10017  0 0
count :  5
{'종목코드': '015750', '종목정보': '27', '종목명': '성우하이텍', '현재가': '+5220', '전일대비기호': '1', '전일대비': '+1200', '등락률': '+29.85', '거래량': '30051856', '전일거래량': '1558374', '매도잔량': 
'0', '매도호가': '0', '매수호가': '+5220', '매수잔량': '1016144', '횟수': '0'}

연관 포스트

[키움API] 기본 개발 가이드 내용 및 샘플 코드 (in Python) / OpenAPI 오류코드

[키움API] TR 목록 및 샘플 코드 (in Python)



1 thought on “[키움 OpenAPI] TR OPT10017 (상하한가요청) 코드 in Python”

  1. Pingback: [키움 OpenAPI] TR 목록 및 샘플 코드 (in Python)⋆ JackerLab

Leave a Comment