준비사항

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

조건 검색 등록

실시간으로 종목을 검색하기 위해서는 아래와 같이 서버에 등록을 해줘야 합니다.
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 조건검색 사용 하위 항목

계좌현황 가져오기

 

 

보유종목 가져오기

종목명,  평가손익, 수익률, 현재가,평가금액 등의 정보 가져오기

 

잔고현황 가져오기

총매입,총평가액,총손익, 수익률, 실현속익 등 가져오기

 

 

 

목차

로그인하여 내 정보 가져오기

Visual C#와 키움API로 로그인하여 계좌 정보를 가져오는 예제입니다.

자세한 사용방법을 녹화한 동영상을 하단에 링크해 두었으니 참조하세요.

 

Form에 키움API 컴포넌트 등록

KHOpenAPI.ocx 파일 등록

32비트(x86)로 변경

초기에 키움API업데이트 오류가 발생합니다. 프로그램 종료 후에 다시 실행하시면 됩니다.

 

로그인 구현

로그인 시도후 결과값(성공 또는 실패) 받기

 

 

내 계좌 가져오기

로그인 후에 계좌 정보까지 가져왔습니다.

 

 

동영상으로 정리

 

목차

 

키움API 사용 신청

키움API를 사용하려면 먼저 사용신청을 해야 합니다. 키움증권에 실전투자로 가입되어 있어야 하며 실전투자,모의투자와 별도로 키움API 사용신청을 해줘야 합니다.

먼저 키움API 페이지에 접속 하여 ‘서비스 사용 등록/해지’에서 신청합니다.

키움OpenAPI+ 가입 화면

키움OpenAPI+ 가입하는 방법

 

모든 동의 항목을 체크해 주시고 ‘등록하기’버튼으로 등록을 완료합니다.

등록이 완료되면 아래와 같이 등록됨을 확인할 수 있습니다.

 

API용 프로그램 설치

API 사용을 위해 키움에서 제공하는 프로그램을 설치해야 합니다. 아래 그림처럼 다운로드후에 설치를 합니다.

 

설치가 완료되면 아래와 같이 설치됩니다.
(설치 경로는 어디든 상관 없습니다.)

 

C# 사용을 위한 준비

Visual Studio 열고 Form 형태의 프로젝트를 생성합니다.
(프로그램 기초 자료를 참고 하세요)

 

C#에서 키움API 사용을 위해 컴포넌트를 설치해야 합니다.

 

‘도구상자’에서 ‘일반’을 선택합니다.
마우스 우측을 클릭하여 팝업메뉴을 열고 ‘항목 선택(I)’를 클릭합니다.

‘COM구성요소’탭에서 ‘찾아보기’를 클릭하여 앞에서 설치한 API 폴더를 열고 khopenapi.ocx 를 선택합니다.

 

도구상자에 ‘KHOpenAPI Control’이 설치되었습니다.

 

 

‘KHOpenAPI Control’를 Form에 끌고 옵니다.
아래와 같이 되면 Ctrl+F5 로 실행을 해봅니다.

 

에러 없이 실행된다면 모든 준비는 끝났습니다!!

 

만약 에러가 발생하다면 x86으로 변경해 줘야 합니다.

 

설치 동영상

사용방법을 동영상으로 정리해 보았습니다.

 

목차

 

키움 Open API+ 란?

당사가 제공하는 Open API 서비스 명으로, 고객님이 직접 프로그래밍한 투자전략을 당사가 제공하는 모듈에 연결하여, 시세조회/잔고조회/주문 등을 할 수 있도록 제공하는 서비스 입니다. 기존 키움 Open API에 실시간 조건검색 제공, 실시간 등록/해지,DATA 수신 속도 개선 등 강력한 추가 기능을 제공하여 새롭게 오픈하였습니다.

 

가능 상품

주식/Kospi200선물/Kospi200옵션/주식선물

 

적용 수수료율

영웅문4(HTS)와 동일

 

키움 Open API+ 사용 요건

당사 계좌를 보유하고 HTS ID를 연결하신 고객님께서는 모두 이용 가능하며, ‘서비스 사용등록’ 탭에서 사용 등록 후 바로 이용 가능합니다.

 

키움 Open API+ 사용절차

STEP 1. Open API 사용신청 합니다. -키움 Open API+ 서비스 이용을 위하여는 사용 등록 신청이 필요합니다. -당사 “홈페이지 > 트레이딩 채널 > Open API > 키움 Open API+ > 서비스 사용 등록/해지” 탭에서 사용등록이 가능합니다.

STEP 2. OpenAPI+ 모듈 다운로드 및 설치 -사용 신청 후 키움 Open API+ 모듈을 다운로드 하여 설치합니다.

STEP 3. Open API OCX 탑재 프로그램 제작 및 KOA Studio 활용 -키움 Open API+는 프로그램 개발 확장성을 고려하여 OCX 컨트롤로 제작 지원합니다. ※ 사용자 편의에 따라 VB, 엑셀, 웹기반, MFC 등으로 프로그램 제작이 가능합니다. – 데이터 요청 및 수신은 TR 서비스명을 검색한 후 OCX를 통해 API 함수를 호출하는 방식으로 진행합니다

프로그램 제작 편의를 위해 개발가이드 및 KOA Studio를 제공하고 있습니다. 가이드 및 자료실에 게시 된 샘플, 교육 VOD를 활용하시면 개발 시 도움을 받으 실 수 있습니다.

※ KOA Studio는? -당사가 제공하는 TR의 목록과 정보를 간편하게 확인 할 수 있습니다. -TR을 테스트할 수 있는 화면을 제공하며, 입력값을 확인 할 수 있습니다. -실시간 DATA의 ID값을 확인할 수 있습니다. -한글 명 검색기능이 있어 원하는 TR을 손쉽게 찾아볼 수 있습니다.

STEP 4. 모의환경 테스트 -프로그램 제작 및 테스트를 위해서 모의투자에 접속 할 수 있습니다. -제작한 프로그램의 디버깅과 테스트를 위하여 실 환경 적용 전 모의투자로 접속하여 충분한 테스트를 권고 드립니다. 모의투자 접속은 키움 Open API+ 로그인 창에서 ‘모의투자 접속’ 항목을 체크하고 로그인 하시면 됩니다. ※ 모의투자는 별도의 신청이 필요하며 당사 “홈페이지 > 모의/실전투자 > 상시 모의투자” 에서 가능 합니다.

 

참고사항

자세한 내용은 키움증권 API 페이지를 참조하세요 https://www3.kiwoom.com/nkw.templateFrameSet.do?m=m1408000000

 

키움API 하위 항목