해외파생 OpenAPI-W 개발가이드 1

Size: px

Start display at page:

Download "해외파생 OpenAPI-W 개발가이드 1"

래연 도
5 years ago
Views:

1 해외파생 OpenAPI-W 개발가이드 1

2 1. 설치및개발환경 1.1 설치하기 1.2 개발환경 2. 접속하기 2.1 로그인및버전처리 2.2 모의투자접속 3. WKOA Studio 활용법 3.1 WKOA Studio 개념및특징 3.2 WKOA Studio 설치 3.3 WKOA Studio 구성및사용법 4. 프로그램구성파일 4.1 라이브러리구성파일 4.2 프로그램데이터파일 4.3 시스템데이터파일 5. 해외파생 Open API-W 명세서 5.1 해외파생 Open API-W 컨트롤 5.2 해외파생 Open API-W 식별자 5.3 해외파생 Open API-W 메소드 5.4 해외파생 Open API-W 컨트롤이벤트 6. 제어함수상세명세서 6.1 메소드 (Method) 6.2 이벤트 (Event) 7. 에러코드표 8. 실시간 FID 8.1 해외선물옵션시세 8.2 해외선물옵션호가 8.3 해외선물옵션주문 8.4 해외선물옵션체결 8.5 해외선물옵션마진콜 9. 해외선물옵션종목마스터파일 9.1 해외선물종목마스터파일 9.2 해외옵션종목마스터파일 2

3 1. 설치및개발환경 1.1 설치하기 모듈설치 키움증권홈페이지 > 트레이딩채널 >Open API> 키움해외선물옵션 Open API> 서비스 소개 > 키움해외선물옵션 Open API 모듈다운로드 버튼을통해다운로드후설치 디렉토리 모듈을설치하면그림과같은디렉토리가생성됩니다. 해외파생 Open API-W 의 인터페이스는 OCX 컨트롤방식으로지원하며, 프로그램이설치될때 OCX 가 레지스트리에등록됩니다. ( 개발을하실때다시등록하지않으셔도됩니다.) 해외파생 Open API-W 사용자들께서자신의프로그램을개발시에필요한 OCX 컨트롤을 포함하여실행시에필요한기타모듈파일들을프로그램로그인시에다운로드를통해서 자동으로업데이트됩니다. 1.2 설치하기 - 키움 Open API는프로그램개발확정성을고려하여 OCX 컨트롤로제작지원합니다. - 사용자편의에따라 VB, 엑셀, 웹기반, MFC 등으로프로그램제작이가능합니다. - 데이터요청및수신은 TR 서비스명을검색한후 OCX를통해 API 함수를호출하는방식으로진행합니다. 2. 접속하기 2.1 로그인및버전처리키움 Open API는로그인창을제공합니다.( 공통 ) 제작한프로그램을통해로그인시, 아래절차를참고하시면됩니다. - 함수 CommConnect(long iautoupgrade) 의인자값을통해서버전처리시, 수동 (0) 또는자동 (1) 선택가능 - 수동선택시, 버전처리진행순서 ( 아래그림단계참조 1->2->3->4->5) 프로그램및 WKOA스튜디오접속 > ID/PW/ 인증PW 입력후, 로그인및버전처리진행 > 버전처리안내팝업메시지생성 > 팝업메시지는그대로둔상태에서프로그램및 WKOA스튜디오등 API와관련된모든프로그램종료 > 버전처리종료후다시프로그램수동실행 - 자동선택시, 버전처리진행순서 ( 아래그림단계참조 1->4->5) 프로그램및 WKOA스튜디오접속 > ID/PW/ 인증PW 입력후, 로그인및버전처리진행 > 프로그램및 WKOA스튜디오자동종료 > 버전처리종료후 3

4 프로그램및 WKOA스튜디오자동실행 > 로그인창 ID/PW/ 인증PW 수동입력절차진행 - 로그인시로그인창을실행한프로그램 (Open API OCX를탑재한프로그램 ) 이열려있는경우, 버전처리및로그인이진행되지않습니다. - 실서버접속의경우 모의투자접속 칸을해제한후접속하시면됩니다. - 버전처리그림순서 ( 아래참조 ) <1단계 > 수동 : O, 자동 : O <2 단계 > 수동 : O, 자동 : X 4

5 <3 단계 > 수동 : O, 자동 : X <4 단계 > 수동일때 ( 확인버튼눌러야함.) 자동일때 ( 자동진행 ) <5 단계 > 수동 : O, 자동 : O ( 이단계는수동 / 자동똑같이수동으로로그인입력함.) 5

6 2.2 모의투자접속 - 모의투자접속을위해서는로그인창우측하단에모의투자접속에체크한후, 모의투자 ID 및 PW 를이용하여접속하시면됩니다. 3. WKOA Studio 활용법 3.1 WKOA Studio 개념및특징 WKOA Studio는개발편의를위해제공하는 TR의목록과정보를간편하게확인할수있으며, 입력값및출력값을확인할수있는화면을제공하는프로그램입니다. 특징 - 모의투자서버로만접속가능 - 개발중인자신의프로그램상의수신데이타와 WKOA Studio상의수신데이터비교가능 - 서비스 TR의 Input값참고가능 - 실시간타입과 FID값참고가능 - 화면에사용되어지는 TR 참고가능 - 샘플소스및함수설명참고가능 3.2 WKOA Studio 설치및로그인 설치키움증권홈페이지 > 트레이딩채널 > 해외파생 Open API-W> 해외파생 Open API-W> 서비스소개 > 해외파생 Open API-W 모듈다운로드 버튼을통해다운로드후설치 6

7 로그인 - WKOA Studio > 파일 (F)>Open API 접속을클릭하시면, 로그인창이생성됩니다. - WKOA Studio 는모의투자접속만가능합니다.( 디폴트처리 ) 3.2 WKOA Studio 구성및사용법 작업창 / 정보창 / 입력창 / 결과창으로구성됩니다. 작업창 -영웅문W의화면에해당되는서비스 -전체 TR서비스목록 -TR의 IO -실시간타입과 FID 정보창 -선택된 TR에대한정보 -TR의 Input값설명 -코딩샘플 -실시간필드정보 입력창 - 선택된 TR 에대한 Input 값입력 - Input 값설명 결과창 -TR요청에대한결과 -실시간수신데이터 -조회 TR히스토리 7

8 TR 조회방법 - TR 목록을클릭하시면제공 TR 리스트와샘플코드예제 (C++ 기준 ) 이보여집니다. - INPUT 값을입력하면출력값이창에표시됩니다. 8

9 - 조회한 TR 목록에서는기조회내역을확인할수있습니다. - 실시간목록조회에서는실시간제공목록과샘플코드예제를볼수있습니다. 9

10 - 화면목록에서 TR 조회를할수있습니다. - 샘플목록에서 VC++, C#, VB 의샘플소스들을확인할수있습니다. 10

11 - 함수들에서함수정의를확인할수있습니다. 4. 프로그램구성파일 4.1 라이브러리구성파일 - 파일경로 : [SYSTEM DRIVE:]/Program Root/ 구분 파일명 설명 비고 DLL KFOpenAPI.ocx OpenAPI 실행모듈 KFOpManager.dll OpenAPI 관리모듈 KFOpCommApi.dll 통신모듈 KFOpComms.exe 서버와의 TCP/IP 연결모듈 4.2 프로그램데이터파일 - 파일경로 : [SYSTEM DRIVE:]/Program Root/Data 구분파일명설명비고 데이터파일 KFOpTrInfo.dat 통신용데이터파일 4.3 시스템데이터파일 11

12 - 파일경로 : [SYSTEM DRIVE:]/Program Root/System 구분파일명설명비고 시스템 KFOpComms.ini 통신속성관련데이터파일 5. 해외파생 Open API-W 명세서 5.1 해외파생 Open API-W 컨트롤 - 해외파생 Open API-W는 ActiveX Control (OCX) 형태의 OLE 컨트롤을기반으로설계및구현되어있다. 일반적으로 OCX와동일하게윈도우운영체제에컨트롤을등록해야사용할수있다. 설명 컨트롤모듈 KFOpenAPI.OCX 라이브러리형태 OCX OLE Control Extension DLL 호환성 Microsoft Windows XP SP3 이상 개발환경 Microsoft Visual C 버전 비고 5.2 해외파생 Open API-W 식별자 - 해외파생 Open API-W 컨트롤의인터페이스식별자 (Interface ID : GUID) 는 유일성 (Unique) 을지니며, 이중으로등록되어서는안된다. - 해외파생 Open API-W 컨트롤의생성및데이터상호교환을위한컨트롤인터페이스 식별자는다음과같다. 구분 설명 비고 Control D1ACAB7D-A3AF-49E C9E98344E17A 컨트롤클래스 Dispatch 85B F84-4CEF-991D-C79DE781363D 프로퍼티 / 메소드제어 Even 952B31F8-06FD-4D5A-A021-5FF57F5030AE 이벤트제어 Module 1F8A15ED-A F EDA98188FFC 컨트롤모듈 5.3 해외파생 Open API-W 메소드 - 해외파생 Open API-W 제어및편집을위한인터페이스메소드 (Interface Method) 목록은 다음과같다. ID 타입 이름 설명 1 LONG CommConnect 로그인윈도우를실행한다. 2 LONG CommRqData 통신데이터를송신한다. 3 void SetInputValue 입력데이터를송신한다. 4 BSTR GetCommData 수신데이터를반환한다. 12

13 5 void CommTerminate 통신접속을해제한다. 6 LONG GetRepeatCnt 수신받은데이터의반복개수를반환한다. 7 void DisconnectRealData 리얼시세를끊는다. 8 BSTR GetCommRealData 실시간데이터를반환한다. 9 BSTR GetChejanData 체결잔고데이터를반환한다. 10 LONG SendOrder 주식주문 Tran을송신한다. 11 BSTR GetLoginInfo 로그인정보를반환한다. 12 BSTR GetGlobalFutureItemlist 해외선물상품리스트를반환한다. 13 BSTR GetGlobalOptionItemlist 해외옵션상품리스트를반환한다. 14 BSTR GetGlobalFutureCodelist 해외선물종목코드를반환한다. 15 BSTR GetGlobalOptionCodelist 해외옵션종목코드를반환한다. 16 LONG GetConnectState 통신상태를반환한다. 17 BSTR GetAPIModulePath OpenAPI가위치한디렉토리를반환한다. 18 BSTR GetCommonFunc 공통함수로추후추가되는함수로사용한다. 19 BSTR GetConvertPrice 가격진법에따라변환된가격을반환한다. 20 BSTR GetGlobalFutCodeInfoByType 해외선물옵션종목정보를타입별 ( 지수 / 통화 ) 로반환한다. 21 BSTR GetGlobalFutCodeInfoByCode 해외선물옵션종목정보를종목코드별로반환한다. 22 BSTR GetGlobalFutureItemlistByType 해외선물상품리스트를타입별 ( 지수 / 통화 ) 별로반환한다. 23 BSTR GetGlobalFutureCodeByItemMonth 해외선물코드를상품 / 월물별로반환한다. 24 BSTR GetGlobalOptionCodeByMonth 해외옵션코드를상품 / 콜풋 / 행사가 / 월물별로반환한다. 25 BSTR GetGlobalOptionMonthByItem 해외옵션월물리스트를상품별로반환한다. 26 BSTR GetGlobalOptionActPriceByItem 해외옵션행사가리스트를상품별로반환한다. 27 BSTR GetGlobalFutureItemTypelist 해외선물상품타입리스트를반환한다. 28 BSTR GetCommFullData 수신전체데이타를반환한다. 5.4 해외파생 Open API-W 이벤트 - 해외파생 Open API-W 컨트롤에서발생하는컨트롤이벤트목록은다음과같다. 13

14 ID 타입 이름 설명 1 void OnReceiveTrData Tran 수신시이벤트 2 void OnReceiveMsg 메시지수신시이벤트 3 void OnReceiveRealData 실시간시세수신시이벤트 4 void OnReceiveChejanData 주문접수 / 확인수신시이벤트 5 void OnEventConnect 통신연결상태변경시이벤트 6. 제어함수상세명세서 - 해외파생 Open API-W 는 ActiveX 컨트롤은프로퍼티 ((property) 및메소드 (method) 를통하여 제어및조작을할수있다. 이러한함수에대한상세명세는다음과같습니다. - 개별항목검색의편의를위하여 ID 순으로정렬하였습니다. 6.1 메소드 (Method) 1) CommConnect 원형 LONG CommConnect(LONG nautoupgrade) 설명로그인윈도우를실행한다. 입력값 0 버전수동처리, 1 버전자동처리 * 로그인창및 OCX 파일을버전처리받는경우에, 수동처리시, 고객프로그램 (ocx포함) 을직접수동으로 Close하고버전처리진행자동처리시, 고객프로그램 (ocx포함) 을자동으로 Close하고버전처리및자동재실행을함. 반환값 0 - 성공, 음수값은실패비고로그인이성공하거나실패하는경우 OnEventConnect 이벤트가발생하고이벤트의인자값으로로그인성공여부를알수있다. 구분자자동여부는고객프로그램 (ocx포함) 이단독으로사용되어지는경우에, 구분자를자동으로선택하시고, 고객프로그램 (ocx포함) 이다른프로그램과연동되어져실행시데이터를수신해야하는경우에는구분자를수동으로선택. 2) CommRqData 원형 LONG CommRqData (BSTR srqname, BSTR strcode, BSTR sprevnext, BSTR sscreenno ) 설명 Tran을서버로송신한다. 입력값 BSTR srqname BSTR strcode long nprevnext BSTR sscreenno 반환값 OP_ERR_SISE_OVERFLOW 과도한시세조회로인한통신불가 14

15 비고 OP_ERR_RQ_STRUCT_FAIL 입력구조체생성실패 OP_ERR_RQ_STRING_FAIL 요청전문작성실패 OP_ERR_NONE 정상처리 srqname 사용자구분명 strcode - Tran명입력 nprevnext 서버에서내려준 Next키값입력 ( 샘플참조 ) sscreenno - 4자리의화면번호 (1~9999 : 숫자값으로만가능 ) Ex) openapi.commrqdata( RQ_1, OPT00001,, 0101 ); 3) SetInputValue 원형 void SetInputValue(BSTR sid, BSTR svalue) 설명 Tran 입력값을서버통신전에입력한다. 입력값 sid 아이템명 svalue 입력값반환값없음비고통신 Tran 매뉴얼참고 Ex) openapi.setinputvalue( 종목코드, 6AH16 ); openapi.setinputvalue( 계좌번호, ); 4) GetCommData 원형 BSTR GetCommData(BSTR strtrcode, BSTR strrecordname, long nindex, BSTR stritemname) 설명수신데이터를반환한다. 입력값 strtrcode Tran 코드 strrecordname 레코드명 nindex 복수데이터인덱스 stritemname 아이템명반환값수신데이터비고 Ex) 현재가출력 - openapi.getcommdata( OPT00001, 해외선물기본정보, 0, 현재가 ); 5) CommTerminate 원형 void CommTerminate() 설명 OpenAPI의서버접속을해제한다. 입력값 없음 반환값 없음 비고 통신연결상태는 GetConnectState 메소드로알수있다. 15

16 6) GetRepeatCnt 원형 LONG GetRepeatCnt(BSTR strcode, BSTR srecordname) 설명 레코드반복횟수를반환한다. 입력값 strcode Tran 명 srecordname 레코드명 반환값 레코드의반복횟수 비고 Ex) openapi.getrepeatcnt( OPT00001, 해외선물체결데이타 ); 7) DisconnectRealData 원형 void DisconnectRealData(BSTR sscnno) 설명 화면내모든리얼데이터요청을제거한다. 입력값 sscnno 화면번호 [4] 반환값 없음 비고 화면을종료할때반드시위함수를호출해야한다. Ex) openapi.disconnectrealdata( 0101 ); 8) GetCommRealData 원형 BSTR GetCommRealData(BSTR strrealtype, long nfid) 설명 실시간데이터를반환한다. 입력값 strrealtype 실시간구분 nfid 실시간아이템 반환값 수신데이터 비고 Ex) 현재가출력 - openapi.getcommrealdata( 해외선물시세, 10); 9) GetChejanData 원형 BSTR GetChjanData(long nfid) 설명 체결잔고데이터를반환한다. 입력값 nfid 체결잔고아이템 반환값 수신데이터 비고 Ex) 현재가출력 openapi.getchejandata(910); // 체결가격 10) SendOrder 원형 LONG SendOrder( BSTR srqname, BSTR sscreenno, BSTR saccno, LONG nordertype, BSTR scode, LONG nqty, 16

17 BSTR sprice, BSTR sstop, BSTR shogagb, BSTR sorgorderno ) 설명주문을서버로전송한다. 입력값 srqname - 사용자구분요청명 sscreenno - 화면번호 [4] (1~9999 : 숫자값으로만가능 ) saccno - 계좌번호 [10] nordertype - 주문유형 (1: 신규매도, 2: 신규매수, 3: 매도취소, 4: 매수취소, 5: 매도정정, 6: 매수정정 ) scode - 종목코드 nqty 주문수량 sprice 주문단가 sstop - Stop단가 shogagb - 거래구분 sorgorderno 원주문번호반환값에러코드 <7. 에러코드표참고 > 비고 shogagb 1: 시장가, 2: 지정가, 3:STOP, 4:STOP LIMIT ex) 지정가매수 - openapi.sendorder( RQ_1, 0101, , 2, 6AH16, 10, , 2, ); 시장가매수 - openapi.sendorder( RQ_1, 0101, , 2, 6AH16, 10, 0, 1, ); 매수정정 - openapi.sendorder( RQ_1, 0101, , 6, 6AH16, 10, , 0, ); 매수취소 - openapi.sendorder( RQ_1, 0101, , 4, 6AH16, 10, 0, 0, ); 11) GetLoginInfo 원형 BSTR GetLoginInfo(BSTR stag) 설명로그인한사용자정보를반환한다. 입력값 BSTR stag : 사용자정보구분 TAG값 ( 비고 ) 반환값 TAG값에따른데이터반환비고 BSTR stag에들어갈수있는값은아래와같음 ACCOUNT_CNT 전체계좌개수를반환한다. "ACCNO" 전체계좌를반환한다. 계좌별구분은 ; 이다. USER_ID - 사용자 ID를반환한다. 17

18 USER_NAME 사용자명을반환한다. KEY_BSECGB 키보드보안해지여부. 0: 정상, 1: 해지 FIREW_SECGB 방화벽설정여부. 0: 미설정, 1: 설정, 2: 해지 Ex) openapi.getlogininfo( ACCOUNT_CNT ); 12) GetGlobalFutureItemlist 원형 BSTR GetGlobalFutureItemlist() 설명 해외선물상품리스트를반환한다. 입력값 없음 반환값 해외선물상품리스트, 상품간구분은 ; 이다. 비고 해외선물상품리스트 (6A, 6B, 6C, ES..) 13) GetGlobalOptionItemlist 원형 BSTR GetGlobalOptionItemlist () 설명 해외옵션상품리스트를반환한다. 입력값 없음 반환값 해외옵션상품리스트, 상품간구분은 ; 이다. 비고 해외옵션상품리스트 (6A, 6B, 6C, ES..) 14) GetGlobalFutureCodelist 원형 BSTR GetGlobalFutureCodelist (BSTR sitem) 설명 해외상품별해외선물종목코드리스트를반환한다. 입력값 해외상품 반환값 해외선물종목코드리스트, 종목간구분은 ; 이다. 비고 해외선물종목코드리스트 15) GetGlobalOptionCodelist 원형 BSTR GetGlobalOptionCodelist (BSTR sitem) 설명 해외상품별해외선물종목코드리스트를반환한다. 입력값 해외상품 반환값 해외옵션종목코드리스트, 종목간구분은 ; 이다. 비고 해외옵션종목코드리스트 16) GetConnectState 원형 LONG GetConnectState () 설명 현재접속상태를반환한다. 입력값 없음 반환값 접속상태 18

19 비고 0: 미연결, 1: 연결완료 17) GetAPIModulePath. 원형 BSTR GetAPIModulePath () 설명 OpenAPI모듈의경로를반환한다. 입력값 없음 반환값 경로 비고 18) GetCommonFunc 원형 BSTR GetCommonFunc (BSTR sfuncname, BSTR sparam) 설명 공통함수로추후추가함수가필요시사용할함수이다. 입력값 함수명, 인자값 반환값 문자값으로반환한다. 비고 19) GetConvertPrice 원형 BSTR GetConvertPrice (BSTR scode, BSTR sprice, LONG ntype) 설명 가격진법에따라변환된가격을반환한다. 입력값 종목코드, 가격, 타입 (0 : 진법->10진수, 1 : 10진수-> 진법 ) 반환값 문자값으로반환한다. 비고 20) GetGlobalFutOpCodeInfoByType 원형 BSTR GetGlobalFutCodeInfoByType(LONG ngubun, BSTR stype) 설명 해외선물옵션종목코드정보를타입별로반환한다. 입력값 ngubun : 0( 해외선물 ), 1( 해외옵션 ) stype : IDX( 지수 ), CUR( 통화 ), INT( 금리 ), MLT( 금속 ), ENG( 에너지 ), CMD( 농산물 ) 반환값 종목코드정보리스트들을문자값으로반환한다.( 아래종목마스터파일참조 ) 비고 전체는 으로보내면된다. 21) GetGlobalFutOpCodeInfoByCode 원형 BSTR GetGlobalFutCodeInfoByCode(BSTR scode) 설명 해외선물옵션종목코드정보를종목코드별로반환한다. 입력값 scode : 해외선물옵션종목코드입력 반환값 종목코드정보를문자값으로반환한다.( 아래종목마스터파일참조 ) 비고 19

20 22) GetGlobalFutureItemlistByType 원형 BSTR GetGlobalFutureItemlistByType (BSTR stype) 설명 해외선물상품리스트를타입별로반환한다. 입력값 stype : IDX( 지수 ), CUR( 통화 ), INT( 금리 ), MLT( 금속 ), ENG( 에너지 ), CMD( 농산물 ) 반환값 상품리스트를문자값으로반환한다. 비고 23) GetGlobalFutureCodeByItemMonth 원형 BSTR GetGlobalFutureCodeByItemMonth (BSTR sitem, BSTR smonth) 설명 해외선물종목코드를상품 / 월물별로반환한다. 입력값 sitem: 상품코드 (6A, ES..), smonth: 반환값 종목코드를문자값으로반환한다. 비고 24) GetGlobalOptionCodeByMonth 원형 BSTR GetGlobalOptionCodeByMonth (BSTR sitem, BSTR scpgubun, BSTR sactprice, BSTR smonth) 설명해외옵션종목코드를상품 / 콜풋 / 행사가 / 월물별로반환한다. 입력값 sitem: 상품코드 (6A, ES..), scpgubun: C( 콜 )/P( 풋 ), sactprice: 0.760, smonth: 반환값종목코드를문자값으로반환한다. 비고 25) GetGlobalOptionMonthByItem 원형 BSTR GetGlobalOptionMonthByItem (BSTR sitem) 설명 해외옵션월물리스트를상품별로반환한다. 입력값 sitem: 상품코드 (6A, ES..) 반환값 월물리스트를문자값으로반환한다. 비고 26) GetGlobalOptionActPriceByItem 원형 BSTR GetGlobalOptionActPriceByItem (BSTR sitem) 설명 해외옵션행사가리스트를상품별로반환한다. 입력값 sitem: 상품코드 (6A, ES..) 반환값 행사가리스트를문자값으로반환한다. 비고 27) GetGlobalFutureItemTypelist 20

21 원형 BSTR GetGlobalFutureItemTypelist () 설명 해외선물상품타입리스트를반환한다. 입력값 없음 반환값 상품타입리스트를문자값으로반환한다. 비고 IDX;CUR;INT;MLT;ENG;CMD; 반환 28) GetCommFullData 원형 BSTR GetCommFullData (BSTR strtrcode, BSTR strrecordname, LONG ngubun ) 설명수신된전체데이터를반환한다. 입력값 strtrcode Tran 코드 strrecordname 레코드명 ngubun 0 : 전체 ( 싱글 + 멀티 ), 1 : 싱글데이타, 2 : 멀티데이타반환값수신전체데이터를문자값으로반환한다. 비고 WKOAStudio의 TR목록탭에서필드사이즈참조.( 필드명옆가로안의값들 ) 모든시세 / 원장조회에사용가능하며, 특히차트데이타같은대용량데이터를한번에받아서처리가능. 6.2 이벤트 (Event) 1) OnReceiveTrData. 원형 void OnReceiveTrData(BSTR sscrno, BSTR srqname, BSTR strcode, BSTR srecordname, BSTR sprenext) 설명서버통신후데이터를받은시점을알려준다. 입력값 sscrno 화면번호 srqname 사용자구분명 strcode Tran 명 srecordname Record 명 sprenext 연속조회유무반환값없음비고 srqname CommRqData의 srqname과매핑되는이름이다. strcode CommRqData의 strcode과매핑되는이름이다. 2) OnReceiveRealData 원형 void OnReceiveRealData(BSTR sjongmokcode, BSTR srealtype, BSTR srealdata) 설명실시간데이터를받은시점을알려준다. 입력값 sjongmokcode 종목코드 srealtype 리얼타입 srealdata 실시간데이터전문 21

22 반환값없음비고 3) OnReceiveMsg 원형 void OnReceiveMsg(BSTR sscrno BSTR srqname, BSTR strcode, BSTR smsg) 설명서버통신후메시지를받은시점을알려준다. 입력값 sscrno 화면번호 srqname 사용자구분명 strcode Tran 명 smsg 서버메시지반환값없음비고 sscrno CommRqData의 sscrno와매핑된다. srqname CommRqData의 srqname 와매핑된다. strcode CommRqData의 strcode 와매핑된다. 4) OnReceiveChejanData 원형 void OnReceiveChejanData(BSTR sgubun, LONG nitemcnt, BSTR sfidlist) 설명체결데이터를받은시점을알려준다. 입력값 sgubun 체결구분 nitemcnt - 아이템갯수 sfidlist 데이터리스트 ssplmmsg 버전이후사용하지않음. 반환값없음비고 sgubun 0: 주문체결통보, 1: 잔고통보, 3: 특이신호 sfidlist 데이터구분은 ; 이다. 5) OnEventConnect 원형 void OnEventConnect(LONG nerrcode) 설명 서버접속관련이벤트 입력값 LONG nerrcode : 에러코드 반환값 없음 비고 nerrcode가 0이면로그인성공, 음수면실패 음수인경우는에러코드참조 7. 에러코드표 OP_ERR_NONE 0 " 정상처리 " OP_ERR_NO_LOGIN -1 " 미접속상태 " OP_ERR_LOGIN -100 로그인시접속실패 ( 아이피오류또는접속정보오류 22

23 OP_ERR_CONNECT -101 " 서버접속실패 " OP_ERR_VERSION -102 " 버전처리가실패하였습니다. OP_ERR_TRCODE -103 "TrCode가존재하지않습니다. OP_ERR_NO_REGOPENAPI -104 해외OpenAPI 미신청 OP_ERR_SISE_OVERFLOW -200 조회과부하 OP_ERR_ORDER_OVERFLOW -201 주문과부하 OP_ERR_RQ_WRONG_INPUT -202 조회입력값 ( 명칭 / 누락 ) 오류 OP_ERR_ORD_WRONG_INPUT -300 주문입력값오류 OP_ERR_ORD_WRONG_ACCPWD -301 계좌비밀번호를입력하십시오. OP_ERR_ORD_WRONG_ACCNO -302 타인계좌를사용할수없습니다. OP_ERR_ORD_WRONG_QTY 경고-주문수량 200개초과 OP_ERR_ORD_WRONG_QTY 제한-주문수량 400개초과. 8. 실시간 FID 8.1 해외선물옵션시세 FID 설명 20 체결시간 10 현재가 ( 진법 ) 140 현재가 11 전일대비 12 등락율 27 매도호가 28 매수호가 15 체결량 13 누적거래량 16 시가 17 고가 18 저가 25 전일대비기호 26 대비 30 전일거래량등락율 22 체결일자 761 영업일 8.2 해외선물옵션호가 23

24 FID 설명 21 호가시간 27 최우선매도호가 28 최우선매수호가 41 매도호가1 61 매도호가잔량1 81 매도호가대비1 101 매도호가건수1 51 매수호가1 71 매수가잔량1 91 매수호가대비1 111 매수호가건수1 42 매도호가2 62 매도호가잔량2 82 매도호가대비2 102 매도호가건수2 52 매수호가2 72 매수가잔량2 92 매수호가대비2 112 매수호가건수2 43 매도호가3 63 매도호가잔량3 83 매도호가대비3 103 매도호가건수3 53 매수호가3 73 매수가잔량3 93 매수호가대비3 113 매수호가건수3 44 매도호가4 64 매도호가잔량4 84 매도호가대비4 104 매도호가건수4 54 매수호가4 74 매수가잔량4 94 매수호가대비4 114 매수호가건수4 45 매도호가5 24

25 65 매도호가잔량5 85 매도호가대비5 105 매도호가건수5 55 매수호가5 75 매수가잔량5 95 매수호가대비5 115 매수호가건수5 121 매도호가총잔량 122 매도호가총잔량대비 123 매도호가총건수 125 매수호가총잔량 126 매수호가총잔량대비 127 매수호가총건수 137 호가순잔량 128 순매수잔량 600 매도 1호가등락율 601 매도 2호가등락율 602 매도 3호가등락율 603 매도 4호가등락율 604 매도 5호가등락율 610 매수 1호가등락율 611 매수 2호가등락율 612 매수 3호가등락율 613 매수 4호가등락율 614 매수 5호가등락율 8.3 해외선물옵션주문 FID 설명 9201 계좌번호 (/r) 9203 주문번호 ( 이하 /t) 9001 종목코드 907 매도수구분 905 주문구분 904 원주문번호 302 종목명 906 주문유형 900 주문수량 25

26 901 주문가격 조건가격 주문표시가격 조건표시가격 902 미체결수량 913 주문상태 919 반대매매여부 8046 거래소코드 947 FCM코드 8043 통화코드 908 주문시간 8.4 해외선물옵션체결 FID 설명 9201 계좌번호 (/r) 9203 주문번호 ( 이하 /t) 9001 종목코드 907 매도수구분 905 주문체결구분 8046 거래소코드 947 FCM코드 904 원주문번호 302 종목명 906 주문유형 900 주문수량 901 주문가격 주문표시가격 조건가격 조건표시가격 909 체결번호 911 체결수량 910 체결가격 체결표시가격 체결금액 거부수량 913 주문상태 902 주문잔량 26

27 935 체결수수료 신규수량 청산수량 8018 실현손익 8043 통화코드 8009 약정금액 930 미결제약정합계 미결제약정단가표시 ( 평균 ) 908 체결수신시간 8.5 해외선물옵션마진콜 FID 설명 9201 계좌번호 (/r) 8054 경고구분 (1:1차경고, 2:2차경고 ) ( 이하 \t) 8055 발생일시 YYYYMMDDHHMMSSMS 8053 마진콜율 8043 통화코드 9. 해외선물옵션종목마스터파일 9.1 해외선물종목마스터파일 레코드명 크기 설명 stk_code 12 종목코드 arti_code 6 품목코드 (6A, ES,.) arti_hnm 40 품목명 arti_tp 3 품목구분 (IDX, CUR,.) crnc_code 3 결제통화코드 (USD, JPY, ) tick_unit 15 TICK 단위 tick_value 15 TICK 가치 deal_unit 15 거래단위 deal_mtal 15 거래승수 ntt_code 1 진법코드로서 1~9, A~Z으로표현되며, 실수형또는진법표현을위한구분값임. ntt_calc_unit 15 가격표시조정계수 frgn_exch_code 10 해외거래소코드 expr_dt 8 만기일자 fprc 10 소숫점자리수 27

28 gubun 1 최근월물구분 atv_code 1 액티브월물구분 9.2 해외옵션종목마스터파일레코드명크기설명 stk_code arti_code arti_hnm arti_tp crnc_code tick_unit tick_value deal_unit deal_mtal 12 종목코드 6 품목코드 (6A, ES,.) 40 품목명 3 품목구분 (IDX, CUR,.) 3 결제통화코드 (USD, JPY, ) 15 TICK 단위 15 TICK 가치 15 거래단위 15 거래승수 ntt_code 1 진법코드로서 1~9, A~Z 으로표현되며, 실수형또는진법표현을 위한구분값임. ntt_calc_unit frgn_exch_code expr_dt underlying_code atmg hsga cpgubn fprc tick_calc_unnm over_tick_unmn vtt_code yymm op_type 15 가격표시조정계수 10 해외거래소코드 8 만기일자 12 기초자산코드 1 ATM 구분 13 행사가 1 콜풋구분 10 frpc 15 tick check price 15 over tick price 4 vtt code 5 yymmd 1 옵션 type('a','e') 28

개발자 매뉴얼

개발자 매뉴얼 OpenAPI 개발자매뉴얼 ( 키움증권 ) 한국소리마치 목차 1 프로그램구성파일 1.1 라이브러리구성파일 1.2 프로그램데이터파일 1.3 시스템데이터파일 2 OpenApi 명세서 2.1 OpenApi 컨트롤 2.2 OpenApi 식별자 2.3 OpenApi 메소드 2.4 OpenApi 컨트롤이벤트 2.5 Event 발생흐름 3 제어함수상세명세서 3.1 메소드