05. 종목에 대한 실시간 정보 수신

 
rv = api.SetRealReg("012345", "005930;015760", "10;11;12;15;", "0"); //"0" 마지막에 등록한 종목들만 실시간 조회하겠다.
    삼성전자(005930), 한국전력(015760) 의 실시간 체결 정보에 대한 이벤트를 받을수 있습니다.      

키움API 조건검색 사용 하위 항목

키움증권(영웅문) API TR 리스트 입니다.

 

OPT10001: 주식기본정보요청
[OPT10002: 주식거래원요청]
[OPT10003: 체결정보요청]
OPT10004: 주식호가요청
[OPT10005: 주식일주월시분요청]
[OPT10006: 주식시분요청]
[OPT10007: 시세표성정보요청]
[OPT10008: 주식외국인요청]
[OPT10009: 주식기관요청]
[OPT10010: 업종프로그램요청]
[OPT10011: 투자자정보요청]
[OPT10012: 주문체결요청]
[OPT10013: 신용매매동향요청]
[OPT10014: 공매도추이요청]
[OPT10015: 일별거래상세요청]
[OPT10016: 신고저가요청]
[OPT10017: 상하한가요청]
[OPT10018: 고저가근접요청]
[OPT10019: 가격급등락요청]
[OPT10020: 호가잔량상위요청]
[OPT10021: 호가잔량급증요청]
[OPT10022: 잔량율급증요청]
[OPT10023: 거래량급증요청]
[OPT10024: 거래량갱신요청]
[OPT10025: 매물대집중요청]
[OPT10026: 고저PER요청]
[OPT10027: 전일대비등락률상위요청]
[OPT10028: 시가대비등락률요청]
[OPT10029: 예상체결등락률상위요청]
[OPT10030: 당일거래량상위요청]
[OPT10031: 전일거래량상위요청]
OPT10032: 거래대금상위요청 
[OPT10033: 신용비율상위요청]
[OPT10034: 외인기간별매매상위요청]
[OPT10035: 외인연속순매매상위요청]
[OPT10036: 매매상위요청]
[OPT10037: 외국계창구매매상위요청]
[OPT10038: 종목별증권사순위요청]
[OPT10039: 증권사별매매상위요청]
[OPT10040: 당일주요거래원요청]
[OPT10041: 조기종료통화단위요청]
[OPT10042: 순매수거래원순위요청]
[OPT10043: 거래원매물대분석요청]
[OPT10044: 일별기관매매종목요청]
[OPT10045: 종목별기관매매추이요청]
[OPT10058: 투자자별일별매매종목요청]
[OPT10059: 종목별투자자기관별요청]
[OPT10060: 종목별투자자기관별차트요청]
[OPT10061: 종목별투자자기관별합계요청]
[OPT10062: 동일순매매순위요청]
[OPT10063: 장중투자자별매매요청]
[OPT10064: 장중투자자별매매차트요청]
[OPT10065: 장중투자자별매매상위요청]
[OPT10066: 장중투자자별매매차트요청]
[OPT10067: 대차거래내역요청]
[OPT10068: 대차거래추이요청]
[OPT10069: 대차거래상위10종목요청]
[OPT10070: 당일주요거래원요청]
[OPT10071: 시간대별전일비거래비중요청]
[OPT10072: 일자별종목별실현손익요청]
[OPT10073: 일자별종목별실현손익요청]
OPT10074: 일자별실현손익요청
[OPT10075: 실시간미체결요청]
[OPT10076: 실시간체결요청]
[OPT10077: 당일실현손익상세요청]
[OPT10078: 증권사별종목매매동향요청]
[OPT10079: 주식틱차트조회요청]
[OPT10080: 주식분봉차트조회요청]
[OPT10081: 주식일봉차트조회요청]
[OPT10082: 주식주봉차트조회요청]
[OPT10083: 주식월봉차트조회요청]
OPT20001: 업종현재가요청
[OPT20002: 업종별주가요청]
[OPT20003: 전업종지수요청]
[OPT20004: 업종틱차트조회요청]
[OPT20005: 업종분봉조회요청]
[OPT20006: 업종일봉조회요청]
[OPT20007: 업종주봉조회요청]
[OPT20008: 업종월봉조회요청]
[OPT30001: ELW가격급등락요청]
[OPT30002: 거래원별ELW순매매상위요청]
[OPT30003: ELWLP보유일별추이요청]
[OPT30004: ELW괴리율요청]
[OPT30005: ELW조건검색요청]
[OPT30006: ELW종목상세요청]
[OPT30007: ELW종목상세요청]
[OPT30008: ELW민감도지표요청]
[OPT30009: ELW등락율순위요청]
[OPT30010: ELW잔량순위요청]
[OPT30011: ELW근접율요청]
[OPT40001: ETF수익율요청]
[OPT40002: ETF종목정보요청]
[OPT40003: ETF일별추이요청]
[OPT40004: ETF전체시세요청]
[OPT40005: ETF일별추이요청]
[OPT40006: ETF시간대별추이요청]
[OPT40007: ETF시간대별체결요청]
[OPT40008: ETF시간대별체결요청]
[OPT40009: ETF시간대별체결요청]
[OPT40010: ETF시간대별추이요청]
[OPT50001: 선옵현재가정보요청]
[OPT50002: 선옵일자별체결요청]
[OPT50003: 선옵시고저가요청]
[OPT50004: 옵션행사가요청]
[OPT50005: 선옵시간별거래량요청]
[OPT50006: 선옵체결추이요청]
[OPT50007: 선물시세추이요청]
[OPT50008: 투자자별매도수금액요청]
[OPT50009: 선옵시간별잔량요청]
[OPT50010: 선옵호가잔량추이요청]
[OPT50011: 선옵호가잔량추이요청]
[OPT50012: 선옵타임스프레드차트요청]
[OPT50013: 선물가격대별비중차트요청]
[OPT50014: 선물가격대별비중차트요청]
[OPT50015: 선옵미결제약정차트요청]
[OPT50016: 베이시스추이차트요청]
[OPT50017: 베이시스추이차트요청]
[OPT50018: 풋콜옵션비율차트요청]
[OPT50019: 선물옵션현재가정보요청]
[OPT50020: 복수종목결제월별시세요청]
[OPT50021: 콜종목결제월별시세요청]
[OPT50022: 풋종목결제월별시세요청]
[OPT50023: 민감도지표추이요청]
[OPT50024: 일별변동성분석그래프요청]
[OPT50025: 시간별변동성분석그래프요청]
[OPT50026: 선옵주문체결요청]
[OPT50027: 선옵잔고요청]
[OPT50028: 선물옵션틱차트요청]
[OPT50029: 선물옵션분차트요청]
[OPT50030: 선물옵션일차트요청]
[OPT50031: 선옵잔고손익요청]
[OPT50032: 선옵당일실현손익요청]
[OPT50033: 선옵잔존일조회요청]
[OPT50034: 선옵전일가격요청]
[OPT50035: 지수변동성차트요청]
[OPT50036: 역사적변동성차트요청]
[OPT50037: 코스피200지수요청]
[OPT50038: 투자자별만기손익차트요청]
[OPT50039: 투자자별포지션종합요청]
[OPT50040: 선옵시고저가요청]
[OPT50041: 주식콜옵션거래량상위종목요청]
[OPT50042: 주식풋옵션거래량상위종목요청]
[OPT50043: 주식선물거래량상위종목요청]
[OPT50044: 주식선물시세표요청]
[OPT50045: 상품선물현재가정보요청]
[OPT50046: 상품선물일별추이요청]
[OPT50047: 상품선물시간대별예상체결요청]
[OPT50048: 상품선물틱차트요청]
[OPT50049: 상품선물분봉차트요청]
[OPT50050: 상품선물일봉차트요청]
[OPT50051: 상품옵션현재가정보요청]
[OPT50052: 상품옵션틱차트요청]
[OPT50053: 상품옵션분봉차트요청]
[OPT50054: 상품옵션일봉차트요청]
[OPT50055: 상품옵션일봉차트요청]
[OPT50056: 상품선옵체결추이요청]
[OPT50057: 상품선물거래량상위종목요청]
[OPT50058: 상품선물종목정보요청]
[OPT50059: 상품선옵종목정보요청]
[OPT50060: 상품선옵행사가요청]
[OPT50061: 상품선물투자자별매매동향요청]
[OPT90001: 테마그룹별요청]
[OPT90002: 테마구성종목요청]
[OPT90003: 프로그램순매수상위50요청]
[OPT90004: 종목별프로그램매매현황요청]
[OPT90005: 프로그램매매추이요청]
[OPT90006: 프로그램매매차익잔고추이요청]
[OPT90007: 프로그램매매누적추이요청]
[OPT90008: 종목일별프로그램매매추이요청]
[OPT90009: 외국인기관매매상위요청]
[OPT90010: 차익잔고현황요청]
[OPT90012: 대차거래내역요청]
[OPTFOFID: 선물전체시세요청]
[OPTKWFID: 관심종목정보요청]
[OPTKWINV: 관심종목투자자정보요청]
[OPTKWPRO: 관심종목프로그램정보요청]
[OPW00001: 예수금상세현황요청]
[OPW00002: 일별추정예탁자산현황요청]
[OPW00003: 추정자산조회요청]
[OPW00004: 계좌평가현황요청]
[OPW00005: 체결잔고요청]
[OPW00006: 관리자별주문체결내역요청]
[OPW00007: 계좌별주문체결내역상세요청]
[OPW00008: 계좌별익일결제예정내역요청]
[OPW00009: 계좌별주문체결현황요청]
[OPW00010: 주문인출가능금액요청]
[OPW00011: 증거금율별주문가능수량조회요청]
[OPW00012: 신용보증금율별주문가능수량조회요청]
[OPW00013: 증거금세부내역조회요청]
[OPW00014: 비밀번호일치여부요청]
[OPW00015: 위탁종합거래내역요청]
[OPW00016: 일별계좌수익률상세현황요청]
[OPW00017: 계좌별당일현황요청]
[OPW10001: ELW종목별민감도지표요청]
[OPW10002: ELW투자지표요청]
[OPW10003: ELW민감도지표요청]
[OPW10004: 업종별순매수요청]
[OPW20001: 선물옵션청산주문위탁증거금가계산요청]
[OPW20002: 선옵당일매매변동현황요청]
[OPW20003: 선옵기간손익조회요청]
[OPW20004: 선옵주문체결내역상세요청]
[OPW20005: 선옵주문체결내역상세평균가요청]
[OPW20006: 선옵잔고상세현황요청]
[OPW20007: 선옵잔고현황정산가기준요청]
[OPW20008: 계좌별결제예상내역조회요청]
[OPW20009: 선옵계좌별주문가능수량요청]
[OPW20010: 선옵예탁금및증거금조회요청]
[OPW20011: 선옵계좌예비증거금상세요청]
[OPW20012: 선옵증거금상세내역요청]
[OPW20013: 계좌미결제청산가능수량조회요청]
[OPW20014: 선옵실시간증거금산출요청]
[OPW20015: 옵션매도주문증거금현황요청]

 

준비사항

조건검색을 등록/해제 하기 위해서는 먼저 조건명과 조건번호를 가져와야 합니다. 참고 자료 : 조건명, 조건번호 가져오기  

조건 검색 등록

실시간으로 종목을 검색하기 위해서는 아래와 같이 서버에 등록을 해줘야 합니다.
BOOL SendCondition(LPCTSTR strScrNo, LPCTSTR strConditionName, int nIndex, int
nSearch)
// strScrNo : 조건검색용_화면번호 (사용할 화면번호 지정,서버에서 받은 응답처리에 사용 가능)
// strConditionName : 조건명 (검색에 사용할 조건명)
// nIndex           : 조건번호 (검색에 사용할 조건번호)
// nSearch          : 조회구분 ( 0:일반조회, 1:실시간 조회, 2:연속조회)
// 반환값           : 0:실패, 1:성공


// 참고
// 단순 조건식에 맞는 종목을 조회하기 위해서는 조회구분을 0으로 하고,
// 실시간 조건검색을 하기 위해서는 조회구분을 1로 한다.
// OnReceiveTrCondition으로 결과값이 온다.
// 연속조회가 필요한 경우에는 응답받는 곳에서 연속조회 여부에 따라 연속조회를 송신하면된다.
  조건 검색 등록 결과 받기 검색된 종목을 가져옵니다.
// 이벤트 등록
api.OnReceiveTrCondition += api_OnReceiveTrCondition;


void OnReceiveTrCondition(LPCTSTR sScrNo, LPCTSTR strCodeList, LPCTSTR strConditionName, int
nIndex, int nNext)

// 설명 : 조건검색 조회응답으로 종목리스트를 구분자(“;”)로 붙어서 받는 시점
// LPCTSTR sScrNo : 종목코드
// LPCTSTR strCodeList : 종목리스트(“;”로 구분)
// LPCTSTR strConditionName : 조건명
// int nIndex : 조건명 인덱스
// int nNext : 연속조회(2:연속조회, 0:연속조회없음)
 

사용예

준비
키움증권의 영웅문에서 조건식을 만들어야 합니다. 여기서는 이름을 ‘당일20프로상승’으로 하였고 검색번호는 자동으로 할당되며 신경 쓰지 않아도 됩니다.

  현재 상황에서는 5개가 검색되었습니다. (지금은 장마감된 상태입니다.)

 
등록된 조건명, 조건번호 가져오기
     

키움API 조건검색 사용 하위 항목

조건명과 조건 번호 요청

아래의 코드로 등록되어 있는 조건명,조건번호를 요청합니다.
this.api.GetConditionLoad();
  응답은 이벤트로 수신되며 이벤트는 미리 등록해야 합니다.
api.OnReceiveConditionVer += AxKHOpenAPI_OnReceiveConditionVer;

public void AxKHOpenAPI_OnReceiveConditionVer(object sender, AxKHOpenAPILib._DKHOpenAPIEvents_OnReceiveConditionVerEvent e) 
{
// 검색 조건명, 조건번호를 수신되면 실행됨
}
 
private void Form1_Load(object sender, EventArgs e)
{
	this.api.OnReceiveConditionVer += AxKHOpenAPI_OnReceiveConditionVer;
        this.api.OnEventConnect += AxKHOpenAPI1_OnEventConnect;	
	
}

private void AxKHOpenAPI1_OnEventConnect(object sender, AxKHOpenAPILib._DKHOpenAPIEvents_OnEventConnectEvent e)
{
	if(e.nErrCode ==0)
	{
		// label1.Text = "로그인 성공";


		// 조건 검색 번호와 이름 가져오기
		this.api.GetConditionLoad();

	}
	else
	{
	      // label1.Text = "로그인 실패";
	}
}



public void AxKHOpenAPI_OnReceiveConditionVer(object sender, AxKHOpenAPILib._DKHOpenAPIEvents_OnReceiveConditionVerEvent e)
{
     string[] conditionStocks = this.api.GetConditionNameList().Split(';');
     foreach (string con in conditionStocks)
     {
         string[] condition = con.Split('^');
         if (condition.Length == 2)
         {
             Console.WriteLine(string.Format("조건번호:{0},  조건명:{1}", condition[0], condition[1]));
         }
     }
}
   

키움API 조건검색 사용 하위 항목