목차 1. 개요... 5 2. 개발환경및주의사항... 5 2.1. 개발환경... 5 2.2. 주의사항... 5 3. 서버접속및로그인관련... 7 3.1. 서버접속... 7 3.1.1. LONG CommInit(void) - 서버접속요청... 7 3.1.2. void CommTerminate(BOOL bsocketclose) 서버접속종료... 7 3.1.3. LONG CommGetConnectState(void) - 서버접속상태체크... 7 3.2. 로그인... 7 3.2.1. LONG CommLogin(BSTR suserid, BSTR spwd, BSTR scertpwd) - 로그인요청... 7 3.2.2. LONG CommLogout(BSTR suserid) 로그아웃요청... 7 4. 주문관련함수... 9 4.1. 국내주문... 9 4.1.1. LONG KoOrderSend(BSTR sdata) - 국내주문... 9 4.1.2. LONG KoCancelSend(BSTR sdata) - 국내주문취소... 10 4.1.3. LONG KoModifySend(BSTR sdata) - 국내주문정정... 10 4.1.4. LONG KoWorkingOrder(BSTR sdata) - 국내주문미체결조회... 11 4.1.5. LONG KoFilledList(BSTR sdata) - 국내주문체결조회... 12 4.1.6. LONG KoOrderList(BSTR sdata) - 국내주문주문내역... 14 4.1.7. LONG KoOpenInterest(BSTR sdata) - 국내주문미결제약정조회... 15 4.1.8. LONG KoDepositStat(BSTR sdata) - 국내주문위탁계좌예수금조회... 16 4.1.9. LONG KoAcountList(void) - 국내주문국내주문가능계좌조회... 17 4.1.10. LONG KoOrdableQty(BSTR sdata) - 국내주문가능수량조회... 17 4.2. 해외주문... 18 4.2.1. LONG GoOrderSend(BSTR sdata) 해외주문... 18 4.2.2. LONG GoCancelSend(BSTR sdata) - 해외주문취소... 19 4.2.3. LONG GoModifySend(BSTR sdata) - 해외주문정정함수... 19 4.2.4. LONG GoWorkingOrder(BSTR sdata) - 해외주문미체결조회... 20 4.2.5. LONG GoOrderFillList(BSTR sdata) - 해외주문주문체결조회... 22 4.2.6. LONG GoOpenInterest(BSTR sdata) - 해외주문미결제약정현황... 23 4.2.7. LONG GoDepositStat(BSTR sdata) - 해외주문예수금현황... 23 4.2.8. LONG GoAcountList(void) 해외주문가능계좌조회... 24 4.2.9. LONG GoCurrencyCode(BSTR sdata) 해외통화코드리스트조회... 25 1 / 72
4.2.10. LONG GoOrdableQty(BSTR sdata) - 해외주문가능수량조회... 25 4.2.11. LONG GoOrderPeriodList(BSTR sdata) 해외주문주문체결조회 ( 기간 )... 25 4.3. KOSPI 야간주문... 27 4.3.1. LONG CmOrderSend(BSTR sdata) - KOSPI 야간주문... 27 4.3.2. LONG CmCancelSend(BSTR sdata) - KOSPI 야간주문취소... 28 4.3.3. LONG CmModifySend(BSTR sdata) - KOSPI 야간주문정정... 28 4.3.4. LONG CmWorkingOrder(BSTR sdata) - KOSPI 야간주문미체결조회... 29 4.3.5. LONG CmFilledList(BSTR sdata) - KOSPI 야간주문체결조회... 30 4.3.6. LONG CmOpenInterest(BSTR sdata) - KOSPI 야간주문미결제약정조회... 32 4.3.7. LONG CmDepositStat(BSTR sdata) - KOSPI 야간주문위탁계좌예수금조회... 32 4.3.8. LONG CmOrdableQty(BSTR sdata) - KOSPI 야간주문 CME 주문가능수량조회... 34 4.4. 차트조회... 34 4.4.1. LONG KoCandleRequest(BSTR sdata) 국내주식차트조회... 34 4.4.2. LONG GoCandleRequest(BSTR sdata) 해외주식차트조회... 36 4.5. 연속조회가능함수... 38 4.5.1. LONG KoWorkingOrderNext(void) - 국내주문미체결조회연속조회... 38 4.5.2. LONG KoFilledListNext(void) - 국내주문체결조회연속조회... 38 4.5.3. LONG KoOrderListNext(void) - 국내주문체결조회연속조회... 38 4.5.4. LONG KoOpenInterestNext(void) - 국내주문미결제약정조회연속조회... 38 4.5.5. LONG GoWorkingOrderNext(void) - 해외주문미체결조회연속조회... 39 4.5.6. LONG GoOrderFillListNext(void) - 해외주문주문체결조회연속조회... 39 4.5.7. LONG GoOrderPeriodListNext(void) - 해외주문주문체결조회 ( 기간 ) 연속조회.. 39 4.5.8. LONG CmWorkingOrderNext(void) - KOSPI 야간주문미체결조회연속조회... 39 4.5.9. LONG CmFilledListNext(void) - KOSPI 야간주문체결조회연속조회... 39 4.5.10. LONG CmOpenInterestNext(void) - KOSPI 야간주문미결제약정조회연속조회 39 5. 시세조회및종목마스터관련함수... 40 5.1. 시세조회요청함수... 40 5.1.1. LONG KoPriceQtRequest(BSTR sdata, BOOL breg) - 시세조회국내시세... 40 5.1.2. LONG GoPriceQtRequest (BSTR sdata, BOOL breg) 해외시세조회... 41 5.1.3. LONG CmPriceQtRequest(BSTR sdata) - CME 시세조회... 43 5.1.4. LONG BankDollarQtRequest (BOOL breg) - 은행별원달러환율... 45 5.2. 종목마스터요청함수... 46 5.2.1. LONG SeriesInfoRequest(LONG ntype) 종목정보를얻는함수... 46 6. 서비스및실시간응답이벤트함수... 47 6.1. 서비스응답이벤트함수... 47 6.1.1. void OnReceiveProc(LONG nrqid, BSTR sproc, LONG bexistnext) - 서비스응답 이에러일경우발생하는이벤트... 47 6.1.2. void OnReceiveError(LONG nrqid, BSTR sproc, BSTR serrmsg) - 서비스응답이 2 / 72
에러일경우발생하는이벤트... 47 6.2. 실시간응답이벤트함수... 47 6.2.1. OnReceiveRealData(BSTR sreal) 실시간데이터응답이벤트... 47 6.3. 실시간응답데이터구조... 48 6.3.1. KOCASTORDE 국내주문확인... 48 6.3.2. KOCASTMODI 국내정정확인... 49 6.3.3. KOCASTCANC 국내주문취소확인... 50 6.3.4. KOCASTFILL - 국내주문체결통보... 51 6.3.5. GOCASTPEND 해외주문주문대기... 52 6.3.6. GOCASTORDE 해외주문주문확인... 53 6.3.7. GOCASTMODI 해외주문취소확인... 54 6.3.8. GOCASTCANC 해외주문정정확인... 55 6.3.9. GOCASTFILL 해외주문체결통보... 56 6.3.10. CMCASTORDE - KOSPI 야간주문주문확인... 57 6.3.11. CMCASTMODI - KOSPI 야간주문정정확인... 58 6.3.12. CMCASTCANC - KOSPI 야간주문취소확인... 59 6.3.13. CMCASTFILL - KOSPI 야간주문체결통보... 60 6.3.14. KOSISEDEAL 시세조회국내체결통보... 61 6.3.15. KOSISEHOGA 시세조회국내호가통보... 62 6.3.16. GOSISEDEAL 시세조회해외호가통보... 63 6.3.17. GOSISEHOGA 시세조회해외호가통보... 64 6.3.18. CMSISEDEAL 시세조회야간체결통보... 65 6.3.19. CMSISEHOGA 시세조회야간호가통보... 66 6.3.20. MBSHOGA 원달러환율시세조회통보... 67 7. 서비스및실시간응답데이터얻는함수... 67 7.1. 실시간응답데이터구하는함수... 67 7.1.1. void GetRealData(BSTR sreal, VARIANT* arritem, VARIANT* arrdata) - 시세조회 요청함수명으로항목과데이터를얻는함수... 67 7.1.2. BSTR ReceiveReal(BSTR sreal, BSTR sitem) 시세조회요청함수명과아이템명 칭으로데이터를얻는함수... 67 7.1.3. LONG ReceiveRealDataArr(BSTR sreal, VARIANT* parrdata) 시세조회명칭으 로데이터를얻는함수... 68 7.1.4. LONG GetRealItemArr(BSTR sreal, VARIANT* par ritem) - 시세조회명칭으로아 이템명칭을얻는함수... 68 7.2. 서비스응답데이터구하는함수... 68 7.2.1. LONG ReceiveProcOutRecCnt(LONG nrqid, BSTR sproc, LONG noutrecindex) RqID( 서비스요청고유값 ) 로서비스응답데이터건수를얻는함수... 68 7.2.2. void GetProcData(LONG nrqid, BSTR sproc, LONG noutrecindex, VARIANT* 3 / 72
parritem, VARIANT* parrdata) - RqID 값으로서비스응답아이템명칭과데이터를얻는함수 68 7.2.3. LONG ReceiveProcDataArr(LONG nrqid, BSTR sproc, LONG noutrecindex, VARIANT* parrdata) - RqID 값으로서비스응답 OutRec 의데이터를얻는함수... 69 7.2.4. LONG GetProcItemArr(LONG nrqid, BSTR sproc, LONG noutrecindex, VARIANT* parritem) - RqID 값으로서비스응답 OutRec 의아이템명칭을얻는함수... 69 8. 서비스요청시에러코드... 70 9. 기타... 71 9.1. 2010.Net VC++ 래퍼클래스만드는법... 71 9.2. 6.0 VC++ 래퍼클래스만드는법... 71 4 / 72
1. 개요 본시스템은사용자에게삼성선물 HTS 주문을낼수있는 AcitveX 입니다. 2. 개발환경및주의사항 2.1. 개발환경 - 삼성선물의 FuturesNetS 프로그램을설치합니다 - FuturesNetS 가설치된패스에서 FNDirect.ocx 파일을사용합니다. FNDirect.ocx 파일을이동하면안됩니다. 하지만 FNDirect.ocx 를사용하는프로그램은같은경로에존재하지않아도됩니다. - FuturesNetS 의로그인창을실행하셔야최신 DLL 및파일을받을수있습니다. 2.2. 주의사항 - FNDirect.ocx 는 Visual Studio 2010.Net 의 VC++, 멀티바이트문자집합, 공유 DLL 에서 MFC 사용으로구성되어있습니다. - C# 및유니코드문자집합을사용하신경우멀티바이트로변환하여데이터를넣어주셔야합니다.( C# 샘플프로그램참조 ) - ActiveX 의파일이지만서명을포함한파일은아닙니다. - FuturesNetS 에서자동으로 FNDirect.ocx 를레지스트리에등록하지않습니다. 명령창에서 Regsvr32 명령어를사용하시는방법과 2010.Net 의 VC++ 테스트프로그램에서사용하는방법을사용하시면됩니다. (OS - Vista 이상인경우에는사용자권한을 Administrator 로변경하여레지스트리에등록해야합니다. 매니페스트를참고하세요.) - 자동갱신응답데이터는 OnReciveRealData 이벤트함수안에서만존재합니다. 이벤트함수이외에서데이터를요청하는경우값을반환하지않습니다. - 서비스응답데이터는 OnReceiveProc 이벤트함수안에서만존재합니다. 이벤트함수이외에서데이터를요청하는경우값을반환하지않습니다. - RqID 은서비스요청시고유한값으로 128 을넘으면 20 번부터다시시작합니다. 서비스요청할때순차적으로증가하지만서비스응답은순차적 5 / 72
으로들어오지않습니다. - 서비스요청시입력값에여러값을입력해야하는경우아이템구분자콤마 (,) 를사용하며다중입력인경우구분자 Vertical Bar( ) 를사용합니다. - 서비스응답이벤트에다음데이터존재여부값이있습니다. 다음데이터가있을경우에만연속조회함수를사용할수있습니다. - 서버에접속한후프로그램종료시에는서버접속종료함수 ( CommTerminate(TRUE) ) 를꼭호출해야합니다. - 서버와접속중외부요인으로접속이중단된경우 OnReceiveError(LONG nrqid, BSTR sproc, BSTR serrmsg) 이벤트에 nrqid = -9999, sproc 와 serrmsg 값에 "SOCKET CLOSED" 값이들어옵니다. 6 / 72
3. 서버접속및로그인관련 3.1. 서버접속 3.1.1. LONG CommInit(void) - 서버접속요청 Param : void Return : 1 ( 성공 ) 0 ( 실패 ) Comment : CommsU.ini (Comms.ini) 의정보를이용하여 Fnsscomms.exe 프로그램을실행하여서버와접속합니다. 3.1.2. void CommTerminate(BOOL bsocketclose) 서버접속종료 Param : TRUE ( 접속해제 ) FALSE( 접속은유지상태이고 Fnsscomms.exe 프로그램은종료 ) Return : void Comment : Fnsscomms.exe 프로그램을종료합니다. 3.1.3. LONG CommGetConnectState(void) - 서버접속상태체크 Param : void Return : 1 ( 성공 ) 0 ( 실패 ) Comment : 서버와접속이끊긴경우 OnReceiveError 이벤트에 SOCKET CLOSED 내용을발생합니다. 3.2. 로그인 3.2.1. LONG CommLogin(BSTR suserid, BSTR spwd, BSTR scertpwd) - 로그인요청 Param : suserid ( 아이디 ) spwd ( 비밀번호 ) scertpwd ( 공인인증비밀번호 ) Return : 1 ( 성공 ) 0 ( 실패 ) Comment : 공인인증서로그인을수행합니다. ( 단공인인증서없이로그인가능한계정은제외 ) 3.2.2. LONG CommLogout(BSTR suserid) 로그아웃요청 Param : suserid ( 아이디 ) Return : 1 ( 성공 ) 7 / 72
0 ( 실패 ) Comment : 시세조회를중지하지않은경우자동으로종료합니다. 8 / 72
4. 주문관련함수 4.1. 국내주문 4.1.1. LONG KoOrderSend(BSTR sdata) - 국내주문 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 종목코드 32 주문수량 5 주문가격 17 매매구분 1 1= 매수 2= 매도 가격구분 1 1= 지정가, 2= 시장가 (KOSPI) : L -> 지정가,M-> 시장가,C-> 조건부지정가,B-> 최유리지정가 체결구분 1 1= 일반 2=FOK 3=IOC KOSPI 는일반만가능 Comment : 다중입력가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workipaddr 15 작업 IP-ADDRESS deptcd 3 지점코드 userid 8 사용자 ID exacctno 5 거래소계좌번호 acctno 3 계좌번호 buydt 8 매수일자 series 32 종목 ordqty 5 주문수량 ordprice 17 주문가격 origprice 17 전환매시원잔고가격 termprice 17 조건가격 bidasktp 1 매매구분 0= 시장조성 1= 매수 2= 매도 3= 전매 4= 환매 pricetp 1 가격구분 1= 지정가, 2= 시장가 9 / 72
dealtp 1 체결구분 1= 일반 2=FOK 3=IOC termtp 1 조건구분 0= 일반 1= 대기 2=STOP 3=STOPLIMIT A= 대기-> 주문 B=STOP-> 주문 ordno 7 주문번호 errorcode 5 에러코드 4.1.2. LONG KoCancelSend(BSTR sdata) - 국내주문취소 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 주문번호 32 취소주문수량 5 취소주문수량 (0 인경우전량 ) Comment : 다중입력가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workipaddr 15 작업 IP-ADDRESS deptcd 3 지점코드 userid 8 사용자 ID exacctno 5 거래소계좌번호 acctno 3 계좌번호 acctpasswd 8 계좌비밀번호 ordno 7 주문번호 cnlordcnt 5 취소주문수량 errorcode 5 에러코드 4.1.3. LONG KoModifySend(BSTR sdata) - 국내주문정정 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 주문번호 7 정정수량 5 정정수량 (0 인경우전량 ) 정정가격 17 10 / 72
Comment : 다중입력가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workipaddr 15 작업 IP-ADDRESS deptcd 3 지점코드 userid 8 사용자 ID exacctno 5 거래소계좌번호 acctno 3 계좌번호 acctpasswd 8 계좌비밀번호 ordno 5 주문번호 modqty 5 정정수량 modprice 17 정정금액 errorcode 5 에러코드 4.1.4. LONG KoWorkingOrder(BSTR sdata) - 국내주문미체결조회 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 ordno 7 주문번호 origno 7 원주문번호 momno 7 모주문 forcetp 1 반대매매구분 0= 일반매매 1= 반대매매 ordtp 1 주문구분 1= 주문 2= 정정 3= 취소 A= 조건 accttp 1 주문계좌구분 1= 자기, 2= 위탁, 3= 시장조성 termtp 1 조건구분 0= 일반 2=STOP 3=STOPLIMIT htstp 1 HTS 구분 0= 일반 1=HTS 2=WEB 3=Other combotp 17 복합주문구분 0= 일반,1= 정형복합,2= 비정형복 11 / 72
합 series 32 종목 1= 매수 2= 매도 3= 전매 4= 환매 bidasktp 1 매매구분 1= 일반 2=FOK 3=IOC dealtp 1 체결구분 1= 지정가, 2= 시장가 pricetp 1 가격구분 ordprice 14 주문가격 termprice 14 조건가격 ordqty 5 주문수량 confirmqty 5 확인수량 modqty 5 정정수량 cancelqty 5 취소수량 dealqty 5 체결수량 remqty 5 잔량 comboordqty 5 전체주문수량 combodealqty 5 체결수량 dealno 4 체결번호 ordtime 6 주문시간 accepttp 1 접수구분 acceptcd 10 접수코드 accepttime 6 접수시간 kfxordno 15 거래소주문번호 buydt 8 매수일자 전환매시, 지정시만 INSERT buyprice 14 매수단가 전환매시, 지정시만 INSERT workdate 20 작업일자 ( 최초주문시만 INSERT) 'YYYY- MM-DD, HH24:MI:SS' workuser 20 작업자 workipaddr 15 작업 IP-ADDR 4.1.5. LONG KoFilledList(BSTR sdata) - 국내주문체결조회 Param : sdata 항목명최대입력길이계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 12 / 72
- OutRec1 acctno 8 계좌번호 acctnm 30 계좌명 ordno 7 주문번호 ( 일자별, 지점별 ) dealno 4 체결번호 주문에따른체결순서 CancelTp 1 취소구분 0= 정상 1= 취소 2= 거래정정 ForceTp 1 반대매매구분 0= 일반매매 1= 반대매매 AcctNoTp 1 주문계좌구분 1= 자기, 2= 위탁, 3= 시장조성 TermTp 1 조건구분 0= 일반 2=STOP 3=STOP LIMIT HTStp 1 HTS 구분 0= 일반 1=HTS 2=Web 3=Other ComboOrdTp 1 복합주문구분 0= 일반,1= 정형복합,2= 비정형복합 Series 32 종목코드 BidAskTp 1 매매구분 1= 매수 2= 매도 3= 전매 4= 환매 DealPrice 14 체결가격 Volume 5 체결량 dealtm 6 체결시간 (KOFEX setlplamt 15 장중청산손익 amt 15 약정금액 dealfee 10 거래수수료 (Batch) kofexseqno 10 거래소일련번호 (KOFEX) kofextrdno 10 거래번호 (KOFEX) kofexdealno 10 체결번호 (KOFEX) kofextrdtype 1 거래유형 (KOFEX) origtrdno 10 거래정정시원체결번호 workdate 20 작업일자 workuser 8 작업자 workipaddr 15 작업 IP-ADDR 13 / 72
4.1.6. LONG KoOrderList(BSTR sdata) - 국내주문주문내역 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 ordno 7 주문번호 origno 7 원주문번호 momno 7 모주문 forcetp 1 반대매매구분 0= 일반매매 1= 반대매매 ordtp 1 주문구분 1= 주문 2= 정정 3= 취소 A= 조 건 accttp 1 주문계좌구분 1= 자기, 2= 위탁, 3= 시장조성 termtp 1 조건구분 0= 일반 2=STOP 3=STOPLIMIT htstp 1 HTS 구분 0= 일반 1=HTS 2=WEB 3=Other combotp 1 복합주문구분 0= 일반,1= 정형복합,2= 비정형복 합 series 32 종목 bidasktp 1 매매구분 1= 매수 2= 매도 3= 전매 4= 환 매 dealtp 1 체결구분 1= 일반 2=FOK 3=IOC pricetp 1 가격구분 1= 지정가, 2= 시장가 price 14 주문가격 termprice 14 조건가격 qty 5 주문수량 confirmqty 5 확인수량 modqty 5 정정수량 cancelqty 5 취소수량 dealqty 5 체결수량 remqty 5 잔량 comboordqty 5 전체주문수량 14 / 72
combodealqty 5 체결수량 dealno 4 체결번호 ordtime 6 주문시간 accepttp 1 접수구분 acceptcd 10 접수코드 accepttime 6 접수시간 kfxordno 15 거래소주문번호 buydt 8 매수일자 전환매시, 지정시만 INSERT buyprice 14 매수단가 전환매시, 지정시만 INSERT workdate 20 작업일자 ( 최초주문시만 INSERT) 'YYYY- MM-DD, HH24:MI:SS' workuser 20 작업자 workipaddr 15 작업 IP-ADDR sourcetp 1 주문출처 4.1.7. LONG KoOpenInterest(BSTR sdata) - 국내주문미결제약정조회 Param : sdata 항목명 최대입력길이 거래일자 8 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 series 32 종목 bidasktp 1 매매구분 qty 10 수량 ordqty 10 주문수량 avrbuyprice 14 평균매입가 fixvalue 14 정산가 appplamt 18 평가손익 custfee 18 수수료 plamt 18 순손익 avgamt 15 미결제약정금액 15 / 72
4.1.8. LONG KoDepositStat(BSTR sdata) - 국내주문위탁계좌예수금조회 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 totamt 15 예탁총액 cashamt 15 예탁현금 substamt 15 예탁대용 custmargin 15 위탁증거금총액 custmargincash 15 위탁증거금현금 custmarginsubst 15 위탁증거금대용 ordmargin 15 주문증거금 ( 합계 ) ( futordmargin 15 주문증거금 ( 선물 ) optbidmargin 15 주문증거금 ( 옵션매수 ) (- 사항 ) optaskmargin 15 주문증거금 ( 옵션매도 ) (+ 사항 ) maintmargin 15 유지증거금 addmargin 15 추가증거금 addmargincash 15 추가증거금현금 nonsetltotamt 15 가결제금액 선물매매확정손익 - 옵션매수대금 + 옵 션매도대금 - 미결 제금액 ( 미수 ) dealfutclspl 15 선물확정손익 dealoptsellamt 15 옵션매도대금 dealoptbuyamt 15 옵션매수대금 emrgsetlamt 15 긴급정산차금 chkamt 15 자기압수표 ( 전일 + 당일 ) substsetlamt 15 대용매도결제예정금액 substselamt 15 대용매도금액 trnscashamt 15 이체출금예정금액 trnssubstamt 15 이체출고예정금액 16 / 72
etochkamt 15 기타수표 delvresvamt 15 실물인수예치금 realuncol 15 실미수금 uncolamt 15 미수금 delayfee 15 연체료 nsetltotamt 15 익일결제금액 익일정산차금 - 익일수수료 nsetlamt 15 익일정산차금 익일선물차금 + 익일옵션매수도대금 ndelvamt 15 익일인수도대금 nfeeamt 15 익일수수료결재금액 outtotamt 15 인출가능총액 outcashamt 15 인출가능현금 outsubstamt 15 인출가능대용 ordableamt 15 인출가능대용 cashrate 15 증거금율 nextsetlamt 15 장중익일추정손익 optevalamt 15 옵션평가금액 evalamt 15 평가예탁금액 예탁금 + 추정익일손익 + 옵션평가금액 kospiordabletotamt 15 KOSPI 주문가능액합계 kospiordablecashamt 15 KOSPI 주문가능액현금 kospiordablesubstamt 15 KOSPI 주문가능액대용 4.1.9. LONG KoAcountList(void) - 국내주문국내주문가능계좌조회 Param : void Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 acctno 8 계좌번호 acctnm 30 계좌명 4.1.10. LONG KoOrdableQty(BSTR sdata) - 국내주문가능수량조회 Param : sdata 항목명최대입력길이 17 / 72
계좌번호 8 계좌비밀번호 8 종목 32 매매구분 1 가격 17 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 ableqty 8 주문가능수량 clearqty 8 청산가능수량 openqty 8 미결제수량 4.2. 해외주문 4.2.1. LONG GoOrderSend(BSTR sdata) 해외주문 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 종목 32 매매구분 1 1= 매수, 2= 매도 주문구분 1 1= 주문, 2= 정정, 3= 취소, A= 조건 조건구분 1 0= 일반, 1=OCO, 2=PC 모니터 가격구분 1 1= 시장가, 2= 지정가, 3=STOP, 4=STOP LIMIT 주문수량 5 주문가격 20 조건가격 20 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workuser 8 작업자 workipaddr 15 작업자 IP localip 15 Local IP acctno 8 계좌번호 18 / 72
passwd 8 비밀번호 series 32 종목코드 bidasktp 1 매매구분 1= 매수, 2= 매도 ordtp 1 주문구분 1= 주문, 2= 정정, 3= 취소, A= 조건 termtp 1 조건구분 0= 일반, 1=OCO, 2=PC 모니터 prctype 1 가격구분 1= 시장가, 2= 지정가, 3=STOP, 4=STOP LIMIT qty 5 주문수량 price 20 주문가격 termprice 20 조건가격 commyn 1 수수료여부 0= 미부과, 1= 부과 ordno 15 주문번호 4.2.2. LONG GoCancelSend(BSTR sdata) - 해외주문취소 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 주문번호 15 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workuser 8 작업자 workipaddr 15 작업자 IP localip 15 Local IP acctno 8 계좌번호 passwd 8 비밀번호 orgno 15 주문번호 ordno 15 취소주문번호 4.2.3. LONG GoModifySend(BSTR sdata) - 해외주문정정함수 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 19 / 72
원주문번호 15 종목코드 32 주문수량 5 정정가격 20 정정조건가격 20 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workuser 8 작업자 workipaddr 15 작업자 IP localip 15 Local IP acctno 8 계좌번호 passwd 8 비밀번호 orgno 15 원주문번호 series 32 종목코드 qty 5 주문수량 price 20 정정가격 termprice 20 정정조건가격 ordno 15 정정주문번호 4.2.4. LONG GoWorkingOrder(BSTR sdata) - 해외주문미체결조회 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 teamcode 3 관리자소속팀 teamnm 20 관리자소속팀명 mngerno 8 관리자 mngernm 20 관리자명 acctno 8 계좌번호 20 / 72
acctnm 30 계좌명 ordno 15 주문번호 orgno 15 원주문번호 momno 15 모주문번호 ordstat 2 주문접수구분 10= 주문대기, 11= 주문, 20= 정정대기, 21= 정정, 30= 취소대기, 31= 취소 ordtp 1 주문구분 1= 주문, 2= 정정, 3= 취소, A= 조건 ordtpnm 4 주문구분 termtp 1 조건구분 0= 일반, 1=OCO, 2=PC 모니터 termtpnm 10 조건구분 htstp 1 HTS 구분 0= 전화, 1=HTS, 2=WEB, 3=Other htstpnm 5 HTS 구분 sourcetp 1 주문출처 0=FuturesNet, 1=OfficeNet, 2=EXCEL, 3=Other sourcetpnm 10 주문출처 series 32 종목코드 settltp 1 정산구분 1= 일일정산, 2= 만기정산 settltpnm 8 정산구분 commyn 1 수수료여부 0= 미부과, 1= 부과 commynnm 6 수수료여부 futoptcd 1 선물 / 옵션구분 F= 선물, C=CALL, P=PUT futoptcdnm 4 선물 / 옵션구분 pricetp 1 가격구분 1= 지정가, 2= 시장가, 3=STOP, 4=STOP LIMIT pricetpnm 10 가격구분 bidasktp 1 매매구분 1= 매수, 2= 매도 bidasktpnm 4 매매구분 ordprice 20 주문가격 termprice 20 조건가격 ordqty 5 주문수량 dealqty 5 체결수량 modqty 5 정정수량 cancelqty 5 취소수량 confirmqty 5 확인수량 remqty 5 잔량 accepttp 1 접수구분 0= 접수전, 1= 접수, 2= 거부, 3= 체 21 / 72
결 / 취소완료 accepttpnm 8 접수구분 acceptmsg 120 거부메세지 localip 15 Local IP tradedate 8 주문일자 tradetime 6 주문시간 userid 8 주문자 workipaddr 15 주문자 IP tif 1 TIF 0=DAY, 6=GTD expiredate 8 주문종료일 cleartp 1 청산여부 0= 일반, 1= 청산 clearposno 15 청산포지션번호 ifdprice 20 IFD 가격 ifdtermprice 20 IFD STOP 가격 reserved 50 예약공간 4.2.5. LONG GoOrderFillList(BSTR sdata) - 해외주문주문체결조회 Param : sdata 항목명 최대입력길이 시작일자 8 종료일자 8 계좌번호 8 비밀번호 8 종목코드 32 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 bsns_date 8 영업일자 ordno 7 주문번호 orgno 7 원주문 ordstat 4 체결구분 1: 주문, 2: 정정, 3: 취소, 9: 거부 series 32 종목코드 bidasktp 4 매매구분 1: 매수, 2: 매도 ordqty 7 주문수량 dealqty 7 체결수량 22 / 72
pricetp 14 주문유형 1: 시장가, 2: 지정가, 3:STOP- MARKET, 4:STOP-LIMIT ordprice 15 주문가격 dealprice 15 체결가격 dealno 7 체결번호 tradedate 8 체결번호 dealdate 8 체결시간 termprice 15 STOP 가격 userid 20 주문자 useripaddr 15 IP_addr seqno 7 SEQ_NO futoptcd 1 선물옵션구분 선물 / 옵션구분 : F= 선물, C=CALL, P=PUT, S=SPREAD 4.2.6. LONG GoOpenInterest(BSTR sdata) - 해외주문미결제약정현황 Param : sdata 항목명 최대입력길이 조회날짜 8 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 series 32 종목코드 bidasktp 1 매매구분 qty 10 수량 avrbuyprice 14 평균매입가 fixvalue 14 정산가 applamt 18 평가손익 4.2.7. LONG GoDepositStat(BSTR sdata) - 해외주문예수금현황 Param : sdata 항목명 최대입력길이 조회날짜 8 계좌번호 8 통화코드 3 23 / 72
비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 cashamt 15 예탁금잔액 setlpamt 15 청산손익 custfee 15 수수료 ableamt 15 평가손익 plamt 15 예탁자산평가액 ordamt 15 주문가능금액 uncolamt 15 미수 / 연체료 outamt 15 출금예정금액 custmrgn 15 위탁증거금 maintmrgn 15 유지증거금 addmrgn 15 추가증거금필요액 outableamt 15 인출가능금액 - OutRec2 currcd 3 통화코드 custmrgn 15 위탁증거금 uncolamt 15 미수 / 연체료 cashamt 15 예탁금잔액 exrate 15 환율가 examt 15 외화환산금액 4.2.8. LONG GoAcountList(void) 해외주문가능계좌조회 Param : void Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 acctno 8 계좌번호 acctnm 30 계좌명 24 / 72
4.2.9. LONG GoCurrencyCode(BSTR sdata) 해외통화코드리스트조회 Param : sdata 항목명 최대입력길이 통화코드 15 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 s_code 36 코드명 + 코드 CODE_NM + ' ' + CODE 4.2.10. LONG GoOrdableQty(BSTR sdata) - 해외주문가능수량조회 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 종목 32 매매구분 1 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 ableqty 5 주문가능수량 clearqty 5 청산가능수량 openqty 5 미결제수량 4.2.11. LONG GoOrderPeriodList(BSTR sdata) 해외주문주문체결조회 ( 기간 ) Param : sdata 항목명최대입력길이시작일자 8 종료일자 8 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 25 / 72
- OutRec1 teamcode 3 관리자소속팀 teamnm 20 관리자소속팀명 mngerno 8 관리자 mngernm 20 관리자명 acctno 8 계좌번호 acctnm 30 계좌명 ordno 15 주문번호 dealno 5 체결번호 fcmdealno 20 FCM 체결번호 posno 11 포지션번호 canceltp 1 취소구분 0= 정상, 1= 취소, 2= 거래정정 canceltpnm 8 취소구분 dealtp 1 거래구분 0= 매매, 1= 선물만기, 2= 옵션행사, 3= 옵션배정, 4= 출고, 5= 입고, 6= 소멸, 7=Level Carry, 8=Lending, 9=Borrowing, A=HPC dealtpnm 8 거래구분 termtp 1 조건구분 0= 일반, 1=OCO, 2=PC 모니터 termtpnm 10 조건구분 htstp 1 HTS 구분 0= 전화, 1=HTS, 2=WEB, 3=Other htstpnm 5 HTS 구분 sourcetp 1 주문출처 0=FuturesNet, 1=OfficeNet, 2=EXCEL, 3=FIX, 9=Other sourcetpnm 10 주문출처 series 32 종목코드 settltp 1 정산구분 1= 일일정산, 2= 만기정산 settltpnm 8 정산구분 commyn 1 수수료여부 0= 미부과, 1= 부과 commynnm 6 수수료여부 futoptcd 1 선물 / 옵션구분 F= 선물, C=CALL, P=PUT futoptcdnm 4 선물 / 옵션구분 pricetp 1 가격구분 1= 지정가, 2= 시장가, 3=STOP, 4=STOP LIMIT pricetpnm 10 가격구분 bidasktp 1 매매구분 1= 매수, 2= 매도 26 / 72
bidasktpnm 4 매매구분 dealprice 20 체결가격 dealqty 5 체결수량 dealtime 14 체결시간 YYYYMMDDHH24MISS custfee 15 위탁수수료 fcmfee 15 FCM 수수료 origtrdno 15 원체결번호 거래정정시원체결번호 4.3. KOSPI 야간주문 4.3.1. LONG CmOrderSend(BSTR sdata) - KOSPI 야간주문 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 종목코드 32 주문수량 5 주문가격 17 매매구분 1 1= 매수 2= 매도 가격구분 1 1= 지정가, 2= 시장가 체결구분 1 1=FAS 2=FOK 3=FAK Comment : 다중입력가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workipaddr 15 작업 IP-ADDRESS deptcd 3 지점코드 userid 8 사용자 ID acctno 3 계좌번호 series 32 종목 ordqty 5 주문수량 ordprice 17 주문가격 bidasktp 1 매매구분 0= 시장조성 1= 매수 2= 매도 3= 전매 4= 환매 pricetp 1 가격구분 1= 지정가, 2= 시장가 dealtp 1 체결구분 1=FAS 2=FOK 3=FAK 27 / 72
ordno 7 주문번호 errorcode 5 에러코드 termtp 1 주문매체구분 4.3.2. LONG CmCancelSend(BSTR sdata) - KOSPI 야간주문취소 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 주문번호 32 잔량 5 Comment : 다중입력가능합니다. * 서비스응답 OutRec 구조 - OutRec1 workipaddr 15 작업 IP-ADDRESS deptcd 3 지점코드 userid 8 사용자 ID acctno 8 계좌번호 acctpasswd 8 계좌비밀번호 ordno 7 주문번호 errorcode 5 에러코드 4.3.3. LONG CmModifySend(BSTR sdata) - KOSPI 야간주문정정 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 주문번호 7 잔량 5 정정수량 5 정정가격 17 IFM 사용유무 1 1= 미사용 2= 사용 Comment : 다중입력가능합니다. * 서비스응답 OutRec 구조 28 / 72
- OutRec1 workipaddr 15 작업 IP-ADDRESS deptcd 3 지점코드 userid 8 사용자 ID acctno 8 계좌번호 acctpasswd 8 계좌비밀번호 ordno 5 주문번호 modqty 5 정정수량 modprice 17 정정금액 errorcode 5 에러코드 ifm_c 1 IFM 사용유무 1= 미사용 2= 사용 4.3.4. LONG CmWorkingOrder(BSTR sdata) - KOSPI 야간주문미체결조회 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 ordno 7 주문번호 origno 7 원주문번호 momno 7 모주문 forcetp 1 반대매매구분 0= 일반매매 1= 반대매매 ordtp 1 주문구분 1= 주문 2= 정정 3= 취소 A= 조 건 accttp 1 주문계좌구분 1= 자기, 2= 위탁, 3= 시장조성 termtp 1 조건구분 0= 일반 2=STOP 3=STOPLIMIT htstp 1 HTS 구분 0= 일반 1=HTS 2=WEB 3=Other combotp 17 복합주문구분 0= 일반,1= 정형복합,2= 비정형복 합 series 32 종목 bidasktp 1 매매구분 1= 매수 2= 매도 3= 전매 4= 환 29 / 72
매 dealtp 1 체결구분 1=FAS 2=FOK 3=FAK pricetp 1 가격구분 1= 지정가, 2= 시장가 ordprice 14 주문가격 termprice 14 조건가격 ordqty 5 주문수량 confirmqty 5 확인수량 modqty 5 정정수량 cancelqty 5 취소수량 dealqty 5 체결수량 remqty 5 잔량 comboordqty 5 전체주문수량 combodealqty 5 체결수량 dealno 4 체결번호 ordtime 6 주문시간 ( 일반주문 : 주문시, 조건주문 : 주문실행시 ) accepttp 1 접수구분 0= 접수전, 1= 접수, 2= 거부 acceptcd 10 접수코드 accepttime 6 접수시간 kfxordno 15 거래소주문번호 buydt 8 매수일자 전환매시, 지정시만 INSERT buyprice 14 매수단가 전환매시, 지정시만 INSERT workdate 20 작업일자 ( 최초주문시만 INSERT) 'YYYY- MM-DD, HH24:MI:SS' workuser 20 작업자 workipaddr 15 작업 IP-ADDR ifmtp_c 1 IFM 사용유무 '2'= 사용, '1'= 미사용 '0'=none 4.3.5. LONG CmFilledList(BSTR sdata) - KOSPI 야간주문체결조회 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 종목코드 32 매매구분 1 매수 (1)/ 매도구분 (2), '5': 전체 Comment : 다중입력불가능합니다. 30 / 72
* 서비스응답 OutRec 구조 - OutRec1 acctno 8 계좌번호 acctnm 30 계좌명 ordno 7 주문번호 ( 일자별, 지점별 ) dealno 4 체결번호 ( 주문에따른체결순서 ) CancelTp 1 취소구분 0= 정상 1= 취소 2= 거래정정 ForceTp 1 반대매매구분 0= 일반매매 1= 반대매매 AcctNoTp 1 주문계좌구분 1= 자기, 2= 위탁, 3= 시장조성 TermTp 1 조건구분 0= 일반 2=STOP 3=STOP LIMIT HTStp 1 HTS 구분 0= 일반 1=HTS 2=Web 3=Other ComboOrdTp 1 복합주문구분 0= 일반,1= 정형복합,2= 비정형복합 Series 32 종목코드 BidAskTp 1 매매구분 1= 매수 2= 매도 3= 전매 4= 환매 DealPrice 14 체결가격 Volume 5 체결량 dealtm 6 체결시간 (KOFEX) setlplamt 15 장중청산손익 amt 15 약정금액 dealfee 10 거래수수료 (Batch) kofexseqno 10 거래소일련번호 (KOFEX) kofextrdno 10 거래번호 (KOFEX) kofexdealno 10 체결번호 (KOFEX) kofextrdtype 1 거래유형 (KOFEX) origtrdno 10 거래정정시원체결번호 workdate 20 작업일자 workuser 8 작업자 workipaddr 15 작업 IP-ADDR 31 / 72
4.3.6. LONG CmOpenInterest(BSTR sdata) - KOSPI 야간주문미결제약정조회 Param : sdata 항목명 최대입력길이 거래일자 8 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 series 32 종목 bidasktp 1 매매구분 qty 10 수량 ordqty 10 주문수량 avrbuyprice 14 평균매입가 fixvalue 14 정산가 appplamt 18 평가손익 custfee 18 수수료 plamt 18 순손익 avgamt 15 미결제약정금액 4.3.7. LONG CmDepositStat(BSTR sdata) - KOSPI 야간주문위탁계좌예수금조회 Param : sdata 항목명 최대입력길이 계좌번호 8 비밀번호 8 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 totamt 15 예탁총액 cashamt 15 예탁현금 substamt 15 예탁대용 32 / 72
custmargin 15 위탁증거금총액 custmargincash 15 위탁증거금현금 custmarginsubst 15 위탁증거금대용 ordmargin 15 주문증거금 ( 합계 ) futordmargin 15 주문증거금 ( 선물 ) optbidmargin 15 주문증거금 ( 옵션매수 ) (- 사항 ) optaskmargin 15 주문증거금 ( 옵션매도 ) (+ 사항 maintmargin 15 유지증거금 addmargin 15 추가증거금 addmargincash 15 추가증거금현금 nonsetltotamt 15 가결제금액 선물매매확정손익 - dealfutclspl 15 선물확정손익 옵션매수대금 + 옵 션매도대금 - 미결제 금액 ( 미수 ) dealoptsellamt 15 옵션매도대금 dealoptbuyamt 15 옵션매수대금 emrgsetlamt 15 긴급정산차금 chkamt 15 자기압수표 ( 전일 + 당일 ) substsetlamt 15 대용매도결제예정금액 substselamt 15 대용매도금액 trnscashamt 15 이체출금예정금액 trnssubstamt 15 이체출고예정금액 etochkamt 15 기타수표 delvresvamt 15 실물인수예치금 realuncol 15 실미수금 uncolamt 15 미수금 delayfee 15 연체료 nsetltotamt 15 익일결제금액 익일정산차금 - 익 일수수료 nsetlamt 15 익일정산차금 익일선물차금 + 익일 옵션매수도대금 ndelvamt 15 익일인수도대금 nfeeamt 15 익일수수료결재금액 outtotamt 15 인출가능총액 outcashamt 15 인출가능현금 outsubstamt 15 인출가능대용 33 / 72
ordableamt 15 인출가능대용 cashrate 15 증거금율 nextsetlamt 15 장중익일추정손익 optevalamt 15 옵션평가금액 evalamt 15 평가예탁금액 예탁금 + 추정익일 kospiordabletotamt 15 KOSPI 주문가능액합계 kospiordablecashamt 15 KOSPI 주문가능액현금 kospiordablesubstamt 15 KOSPI 주문가능액대용 손익 + 옵션평가금 액 4.3.8. LONG CmOrdableQty(BSTR sdata) - KOSPI 야간주문 CME 주문가능수량조회 Param : sdata 항목명 최대입력길이 계좌번호 8 계좌비밀번호 8 종목 32 매매구분 1 가격 17 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 ableqty 8 주문가능수량 clearqty 8 청산가능수량 openqty 8 미결제수량 4.4. 차트조회 4.4.1. LONG KoCandleRequest(BSTR sdata) 국내주식차트조회 Param : sdata 항목명 최대입력길이 종목코드 32 구분 1 1: 선옵 2: 현물 3: 지수 4: 환율 5:CME 주기 1 T: 틱 S: 초 M: 분 D: 일 W: 주 N: 월 34 / 72
간격 3 기준일자 8 만기보정 1 Y: 예, N: 아니오 제외구분 1 0: 없음, 1: 가격, 2: 거래량, 3: 둘다 제외기준틱 3 제외기준거래량 6 요청건수 4 다음조회키값 23 등락률차트 1 Y: 예, N: 아니오 누적갭 9 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 series 8 종목 sprice 시가 가변길이 hprice 고가 가변길이 lprice 저가 가변길이 nprice 종가 가변길이 volume 거래량 가변길이 opnlong 미결제약정 가변길이 bidprice 매수호가 (X) 가변길이 askprice 매도호가 (X) 가변길이 ordhprice 상한가 가변길이 ordlprice 하한가 가변길이 presprice 전일시가 가변길이 prehprice 전일고가 가변길이 prelprice 전일저가 가변길이 prenprice 전일종가 가변길이 prevolume 전일거래량 가변길이 preopnlong 전일미결제 가변길이 prerealprice 전일현물가 가변길이 change 전일대비 가변길이 percent 등락률 가변길이 theoryprice 이론가 가변길이 realprice 현물가 가변길이 svrtime 서버시간 가변길이 35 / 72
trddt 영업일 가변길이 lastcnt N 틱커봉구성갯수 가변길이 changeflag 1 전일대비부호 nextkey 23 다음조회키값 accgap 9 누적갭 trddttp 1 영업일타입 filler 2 filler - OutRec2 dt 일자 가변길이 tm 시간 가변길이 seq 일련번호 가변길이 sprice 시가 가변길이 hprice 고가 가변길이 lprice 저가 가변길이 nprice 종가 가변길이 volume 거래량 가변길이 opnint 미결제약정 가변길이 4.4.2. LONG GoCandleRequest(BSTR sdata) 해외주식차트조회 Param : sdata 항목명 최대입력길이 종목코드 32 구분 1 1: 선옵 2: 현물 3: 지수 4: 환율 5:CME 주기 1 T: 틱 S: 초 M: 분 D: 일 W: 주 N: 월 간격 3 기준일자 8 만기보정 1 Y: 예, N: 아니오 제외구분 1 0: 없음, 1: 가격, 2: 거래량, 3: 둘다 제외기준틱 3 제외기준거래량 6 요청건수 4 다음조회키값 23 본장여부 1 Y: 예, N: 아니오 등락률차트 1 Y: 예, N: 아니오 36 / 72
누적갭 9 Comment : 다중입력불가능합니다. * 서비스응답 OutRec 구조 - OutRec1 series 8 종목 Sprice 시가 가변길이 Hprice 고가 가변길이 lprice 저가 가변길이 nprice 종가 가변길이 volume 거래량 가변길이 opnint 미결제약정 (X) 가변길이 bidprice 매수호가 가변길이 askprice 매도호가 가변길이 ordhprice 상한가 (X) 가변길이 ordlprice 하한가 (X) 가변길이 presprice 전일시가 가변길이 prehprice 전일고가 가변길이 prelprice 전일저가 가변길이 prenprice 전일종가 가변길이 preopnint 전일미결제 가변길이 change 전일대비 가변길이 percent 등락률 가변길이 theoryprice 이론가 (X) 가변길이 realprice 현물가 (X) 가변길이 svrtime 서버시간 가변길이 trddt 영업일 가변길이 lastcnt 몇개의틱으로 가변길이 changeflag 1 전일대비부호 nextkey 23 다음조회키값 opntm 6 장시작시간 clstm 6 장종료시간 accgap 9 누적갭 trddttp 1 영업일타입 filler 2 filler - OutRec2 37 / 72
dt 일자 가변길이 tm 시간 가변길이 seq 일련번호 가변길이 sprice 시가 가변길이 hprice 고가 가변길이 lprice 저가 가변길이 nprice 종가 가변길이 volume 거래량 가변길이 dsprice 시가 (10 진법 ) 가변길이 dhprice 고가 (10 진법 ) 가변길이 dlprice 저가 (10 진법 ) 가변길이 dnprice 종가 (10 진법 ) 가변길이 4.5. 연속조회가능함수 4.5.1. LONG KoWorkingOrderNext(void) - 국내주문미체결조회연속조회 Param : void Comment : KoWorkingOrder 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.2. LONG KoFilledListNext(void) - 국내주문체결조회연속조회 Param : void Comment : KoFilledList 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.3. LONG KoOrderListNext(void) - 국내주문체결조회연속조회 Param : void Comment : KoOrderList 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.4. LONG KoOpenInterestNext(void) - 국내주문미결제약정조회연속조회 Param : void Comment : KoOpenInterest 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 38 / 72
4.5.5. LONG GoWorkingOrderNext(void) - 해외주문미체결조회연속조회 Param : void Comment : GoWorkingOrder 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.6. LONG GoOrderFillListNext(void) - 해외주문주문체결조회연속조회 Param : void Comment : GoOrderFillList 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.7. LONG GoOrderPeriodListNext(void) - 해외주문주문체결조회 ( 기간 ) 연속조회 Param : void Comment : GoOrderPeriodList 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.8. LONG CmWorkingOrderNext(void) - KOSPI 야간주문미체결조회연속조회 Param : void Comment : CmWorkingOrder 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.9. LONG CmFilledListNext(void) - KOSPI 야간주문체결조회연속조회 Param : void Comment : CmFilledList 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 4.5.10. LONG CmOpenInterestNext(void) - KOSPI 야간주문미결제약정조회연속조회 Param : void Comment : CmOpenInterest 서비스요청의응답에다음데이터가존재할경우에만사용가능합니다. 39 / 72
5. 시세조회및종목마스터관련함수 5.1. 시세조회요청함수 5.1.1. LONG KoPriceQtRequest(BSTR sdata, BOOL breg) - 시세조회국내시세 Param : sdata ( 종목 ) breg TRUE ( 시세요청 ) FASLE ( 시세중지요청 ) Comment : 다중입력가능합니다. 종목간구분은, 으로합니다. 서비스응답후국내체 결통보국내호가통보실시간데이터를요청합니다. * 시세조회서비스응답 OutRec 구조 - OutRec1 Series 32 종목 Time 6 시간 Bid_premium1 매수호가 5 단계 Bid_premium2 매수호가 5 단계 Bid_premium3 매수호가 5 단계 Bid_premium4 매수호가 5 단계 Bid_premium5 매수호가 5 단계 Ask_premium1 매도호가 5 단계 Ask_premium2 매도호가 5 단계 Ask_premium3 매도호가 5 단계 Ask_premium4 매도호가 5 단계 Ask_premium5 매도호가 5 단계 Bid_demand1 매수수량 5 단계 Bid_demand2 매수수량 5 단계 Bid_demand3 매수수량 5 단계 Bid_demand4 매수수량 5 단계 Bid_demand5 매수수량 5 단계 Ask_demand1 매도수량 5 단계 Ask_demand2 매도수량 5 단계 Ask_demand3 매도수량 5 단계 Ask_demand4 매도수량 5 단계 Ask_demand5 매도수량 5 단계 Bid_demand_sum 매수총수량 5 단계이외 수량포함 40 / 72
Ask_demand_sum Bid_orders1 Bid_orders2 Bid_orders3 Bid_orders4 Bid_orders5 Ask_orders1 Ask_orders2 Ask_orders3 Ask_orders4 Ask_orders5 Bid_orders_sum Ask_orders_sum Nowprice Theory_price Start High Low Nowvol Turnover_u Open_interest 매도총수량 5 단계이외수량포함매수주문수량 5 단계매수주문수량 5 단계매수주문수량 5 단계매수주문수량 5 단계매수주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매수총주문 5 단계이외수량포함매도총수문 5 단계이외수량포함현재가이론가시가고가저가체결수량거래량미결재약정 5.1.2. LONG GoPriceQtRequest (BSTR sdata, BOOL breg) 해외시세조회 Param : sdata ( 종목 ) breg TRUE ( 시세요청 ) FASLE ( 시세중지요청 ) Comment : 다중입력가능합니다. 종목간구분은, 으로합니다. 서비스응답후해외체결통보해외호가통보실시간데이터를요청합니다. * 시세조회서비스응답 OutRec 구조 - OutRec1 아이템명길이항목명 Series 32 종목 Date 일자 Time 6 시간 41 / 72
Bid_premium1 매수호가 5 단계 Bid_premium2 매수호가 5 단계 Bid_premium3 매수호가 5 단계 Bid_premium4 매수호가 5 단계 Bid_premium5 매수호가 5 단계 Ask_premium1 매도호가 5 단계 Ask_premium2 매도호가 5 단계 Ask_premium3 매도호가 5 단계 Ask_premium4 매도호가 5 단계 Ask_premium5 매도호가 5 단계 Bid_demand1 매수수량 5 단계 Bid_demand2 매수수량 5 단계 Bid_demand3 매수수량 5 단계 Bid_demand4 매수수량 5 단계 Bid_demand5 매수수량 5 단계 Ask_demand1 매도수량 5 단계 Ask_demand2 매도수량 5 단계 Ask_demand3 매도수량 5 단계 Ask_demand4 매도수량 5 단계 Ask_demand5 매도수량 5 단계 Bid_demand_sum 매수총수량 5 단계이외 수량포함 Ask_demand_sum 매도총수량 5 단계이외 수량포함 Bid_orders1 매수주문수량 5 단계 Bid_orders2 매수주문수량 5 단계 Bid_orders3 매수주문수량 5 단계 Bid_orders4 매수주문수량 5 단계 Bid_orders5 매수주문수량 5 단계 Ask_orders1 매도주문수량 5 단계 Ask_orders2 매도주문수량 5 단계 Ask_orders3 매도주문수량 5 단계 Ask_orders4 매도주문수량 5 단계 Ask_orders5 매도주문수량 5 단계 Bid_orders_sum 매수총주문 5 단계이외 수량포함 Ask_orders_sum 매도총수문 5 단계이외 42 / 72
Nowprice Theory_price Start High Low Nowvol Turnover_u 수량포함현재가이론가시가고가저가체결수량거래량 5.1.3. LONG CmPriceQtRequest(BSTR sdata) - CME 시세조회 Param : sdata ( 종목 ) breg TRUE ( 시세요청 ) FASLE ( 시세중지요청 ) Comment : 다중입력가능합니다. 종목간구분은, 으로합니다. 서비스응답후야간체 결통보야간호가통보실시간데이터를요청합니다. * 시세조회서비스응답 OutRec 구조 - OutRec1 Series 32 종목 Time 6 시간 Bid_premium1 매수호가 5 단계 Bid_premium2 매수호가 5 단계 Bid_premium3 매수호가 5 단계 Bid_premium4 매수호가 5 단계 Bid_premium5 매수호가 5 단계 Ask_premium1 매도호가 5 단계 Ask_premium2 매도호가 5 단계 Ask_premium3 매도호가 5 단계 Ask_premium4 매도호가 5 단계 Ask_premium5 매도호가 5 단계 Bid_demand1 매수수량 5 단계 Bid_demand2 매수수량 5 단계 Bid_demand3 매수수량 5 단계 Bid_demand4 매수수량 5 단계 Bid_demand5 매수수량 5 단계 Ask_demand1 매도수량 5 단계 43 / 72
Ask_demand2 Ask_demand3 Ask_demand4 Ask_demand5 Bid_demand_sum Ask_demand_sum Bid_orders1 Bid_orders2 Bid_orders3 Bid_orders4 Bid_orders5 Ask_orders1 Ask_orders2 Ask_orders3 Ask_orders4 Ask_orders5 Bid_orders_sum Ask_orders_sum Nowprice Theory_price Start High Low Nowvol Turnover_u Open_interest 매도수량 5 단계매도수량 5 단계매도수량 5 단계매도수량 5 단계매수총수량 5 단계이외수량포함매도총수량 5 단계이외수량포함매수주문수량 5 단계매수주문수량 5 단계매수주문수량 5 단계매수주문수량 5 단계매수주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매도주문수량 5 단계매수총주문 5 단계이외수량포함매도총수문 5 단계이외수량포함현재가이론가시가고가저가체결수량거래량미결재약정 44 / 72
5.1.4. LONG BankDollarQtRequest (BOOL breg) - 은행별원달러환율 Param : sdata ( 종목 ) breg TRUE ( 시세요청 ) FASLE ( 시세중지요청 ) Comment : 서비스응답후환율실시간데이터를요청합니다. * 시세조회서비스응답 OutRec 구조 - OutRec1 Filler 4 Filler openprice 10 시가 highprice 10 고가 lowprice 10 저가 mar 10 기준환율 bidprice1 10 매수최우선 askprice1 10 매도최우선 time 6 시간 - OutRec2 banknm 10 은행명 banknmkor 20 은행명한글 bidprice1 10 매수최우선 askprice1 10 매도최우선 minchk 1 매수값체크 maxchk 1 매도값체크 time 6 시간 - OutRec3 time 6 시간 banknm 10 은행명 banknmkor 20 은행명한글 bidprice1 10 매수최우선 askprice1 10 매도최우선 seqno 1 seqno 45 / 72
5.2. 종목마스터요청함수 5.2.1. LONG SeriesInfoRequest(LONG ntype) 종목정보를얻는함수 Param : LONG 1 ( 국내선물 ) 2 ( 국내옵션 ) 3 ( 국내스프레드 ) 4 ( 해외선물 ) 5 ( 국내선물품목정보 ) 6 ( 해외선물품목정보 ) Comment : 응답데이터는시장별분리하여사용해야합니다. 응답값은 200 Byte 입니다. * 국내선물응답데이터구조 ( 구분자 값으로나누어사용해야합니다.) -> 품목코드 종목코드 종목명 자산코드 종목코드 ( 영문 ) 만기년월 * 국내옵션응답데이터구조 ( 구분자 값으로나누어사용해야합니다.) -> 품목코드 종목코드 종목설명 ( 영문 ) 콜풋구분 만기년월 행사가격 ATM 대비 기초자산 ( 대상품목 ) 종목설명 * 국내스프래드응답데이터구조 ( 구분자 값으로나누어사용해야합니다.) -> 품목코드 종목코드 종목명 종목명 기초자산 * 해외선물응답데이터구조 ( 구분자 값으로나누어사용해야합니다.) -> 해외선물상품코드 종목코드 종목명 TICKSIZE TICKVALUE 월물순서 (01~99) 진법 진법자리수 ( 다음데이터사이즈 ) 소수점자리수 거래소가격표시정보 최종거래일 * 국내선물품목정보응답데이터구조 ( 구분자 값으로나누어사용해야합니다.) -> 품목코드 품목명 주식상품구분 상품구분번호 품목내일련번호 * 해외선물품목정보응답데이터구조 ( 구분자 값으로나누어사용해야합니다.) -> 품목코드 품목명 상품구분번호 거래소심볼 종목표시순서 1000 현물가표시여부 현물가소숫점정보 전산 / 비전산구분 (1: 전산,0: 비전산 ) 46 / 72
6. 서비스및실시간응답이벤트함수 6.1. 서비스응답이벤트함수 6.1.1. void OnReceiveProc(LONG nrqid, BSTR sproc, LONG bexistnext) - 서비스응답이에러일경우발생하는이벤트 Param : nrqid ( 서비스요청시리턴받은 RqID 값입니다.) sproc ( 서비스요청함수명입니다 ) bexistnext - 0 ( 다음데이터존재하지않습니다.) 1 ( 다음데이터존재합니다.) 6.1.2. void OnReceiveError(LONG nrqid, BSTR sproc, BSTR serrmsg) - 서비스응답이에러일경우발생하는이벤트 Param : nrqid ( 서비스요청시리턴받은 RqID 값입니다.) sproc ( 서비스요청함수명입니다.) serrmsg ( 서비스에러메세지입니다.) 6.2. 실시간응답이벤트함수 6.2.1. OnReceiveRealData(BSTR sreal) 실시간데이터응답이벤트 Param : sreal ( 실시간데이터명입니다.) sreal 값 설명 기타 KOCASTORDE 국내주문 주문확인 로그인후자동등록됨 KOCASTMODI 정정확인 로그인후자동등록됨 KOCASTCANC 취소확인 로그인후자동등록됨 KOCASTFILL 체결통보 로그인후자동등록됨 GOCASTPEND 해외주문 주문대기 로그인후자동등록됨 GOCASTORDE 주문확인 로그인후자동등록됨 GOCASTMODI 취소확인 로그인후자동등록됨 GOCASTCANC 정정확인 로그인후자동등록됨 GOCASTFILL 체결통보 로그인후자동등록됨 CMCASTORDE KOSPI 야간주문 주문확인 로그인후자동등록됨 CMCASTMODI 정정확인 로그인후자동등록됨 CMCASTCANC 취소확인 로그인후자동등록됨 CMCASTFILL 체결통보 로그인후자동등록됨 KOSISEDEAL 시세조회 국내체결통보 KoPriceQtRequest 요청후등록됨 KOSISEHOGA 국내호가통보 KoPriceQtRequest 요청후등록됨 GOSISEDEAL 해외체결통보 GoPriceQtRequest 요청후등록됨 GOSISEHOGA 해외호가통보 KoPriceQtRequest 요청후등록됨 47 / 72
CMSISEDEAL CMSISEHOGA 야간체결통보 CmPriceQtRequest 요청후등록됨 야간호가통보 CmPriceQtRequest 요청후등록됨 6.3. 실시간응답데이터구조 6.3.1. KOCASTORDE 국내주문확인 국내주문, 정정, 취소확인시 errortp == e 이면거부, n 이면정상으로처리. 48 / 72
6.3.2. KOCASTMODI 국내정정확인 국내주문, 정정, 취소확인시 errortp == e 이면거부, n 이면정상으로처리. 49 / 72
6.3.3. KOCASTCANC 국내주문취소확인 국내주문, 정정, 취소확인시 errortp == e 이면거부, n 이면정상으로처리. 50 / 72
6.3.4. KOCASTFILL - 국내주문체결통보 51 / 72
6.3.5. GOCASTPEND 해외주문주문대기 해외주문, 정정, 취소확인시 errortp!= 0 이면거부처리. 52 / 72
6.3.6. GOCASTORDE 해외주문주문확인 해외주문, 정정, 취소확인시 errortp!= 0 이면거부처리. 53 / 72
6.3.7. GOCASTMODI 해외주문취소확인 해외주문, 정정, 취소확인시 errortp!= 0 이면거부처리. 54 / 72
6.3.8. GOCASTCANC 해외주문정정확인 해외주문, 정정, 취소확인시 errortp!= 0 이면거부처리. 55 / 72
6.3.9. GOCASTFILL 해외주문체결통보 56 / 72
6.3.10. CMCASTORDE - KOSPI 야간주문주문확인 국내주문, 정정, 취소확인시 errortp == e 이면거부, n 이면정상으로처리. 57 / 72
6.3.11. CMCASTMODI - KOSPI 야간주문정정확인 국내주문, 정정, 취소확인시 errortp == e 이면거부, n 이면정상으로처리. 58 / 72
6.3.12. CMCASTCANC - KOSPI 야간주문취소확인 국내주문, 정정, 취소확인시 errortp == e 이면거부, n 이면정상으로처리. 59 / 72
6.3.13. CMCASTFILL - KOSPI 야간주문체결통보 60 / 72
6.3.14. KOSISEDEAL 시세조회국내체결통보 61 / 72
6.3.15. KOSISEHOGA 시세조회국내호가통보 62 / 72
6.3.16. GOSISEDEAL 시세조회해외호가통보 63 / 72
6.3.17. GOSISEHOGA 시세조회해외호가통보 64 / 72
6.3.18. CMSISEDEAL 시세조회야간체결통보 65 / 72
6.3.19. CMSISEHOGA 시세조회야간호가통보 66 / 72
6.3.20. MBSHOGA 원달러환율시세조회통보 - 종목코드는 MBSHOGA 로표시됩니다. 7. 서비스및실시간응답데이터얻는함수 7.1. 실시간응답데이터구하는함수 7.1.1. void GetRealData(BSTR sreal, VARIANT* arritem, VARIANT* arrdata) - 시세조회요청함수명으로항목과데이터를얻는함수 Param : sreal ( 시세조회요청함수명 ) *parritem ( 시세조회아이템명칭 - 1 차원배열 ) *parrdata ( 시세조회결과데이터 - 1 차원배열 ) Return : void Comment : 선언한 VARIANT* 형을 COleSafeArray 로변환하여데이터를입력합니다. 7.1.2. BSTR ReceiveReal(BSTR sreal, BSTR sitem) 시세조회요청함수명과아이템명칭으로데이터를얻는함수 Param : sreal ( 시세조회요청함수명 ) sitem ( 시세조회 ) Return : 해당아이템의값 Comment : 아이템명은시세조회요청함수를참고하세요 67 / 72
7.1.3. LONG ReceiveRealDataArr(BSTR sreal, VARIANT* parrdata) 시세조회명칭으로데이터를얻는함수 Param : sreal ( 시세조회명칭 ) *parrdata ( 시세조회결과데이터 - 1 차원배열 ) Return : parrdata 배열의개수 Comment : 선언한 VARIANT* 형을 COleSafeArray 로변환하여데이터를입력합니다. 7.1.4. LONG GetRealItemArr(BSTR sreal, VARIANT* parritem) - 시세조회명칭으로아이템명칭을얻는함수 Param : sreal ( 시세조회명칭 ) * parritem( 시세조회결과아이템명칭 - 1 차원배열 ) Return : parritem 배열의개수 Comment : 선언한 VARIANT* 형을 COleSafeArray 로변환하여데이터를입력합니다. 7.2. 서비스응답데이터구하는함수 7.2.1. LONG ReceiveProcOutRecCnt(LONG nrqid, BSTR sproc, LONG noutrecindex) RqID( 서비스요청고유값 ) 로서비스응답데이터건수를얻는함수 Param : nrqid ( 서비스요청시리턴받은값 ) sproc ( 서비스요청함수명칭 ) noutrecindex ( 서비스응답 OutRec 의순번 ) Return : 해당서비스의 OutRec 의데이터건수 Comment : nrqid 를먼저검사한후해당값이없는경우 sproc 값을검색합니다. 7.2.2. void GetProcData(LONG nrqid, BSTR sproc, LONG noutrecindex, VARIANT* parritem, VARIANT* parrdata) - RqID 값으로서비스응답아이템명칭과데이터를얻는함수 Param : nrqid ( 서비스요청시리턴받은값 ) sproc ( 서비스요청함수명칭 ) noutrecindex ( 서비스 OutRec 의순번 ) *parritem ( 서비스응답아이템명칭 - 1 차원배열 ) *parrdata ( 서비스응답결과데이터 - 2 차원배열 ) Return : void Comment : nrqid 를먼저검사한후해당값이없는경우 sproc 값을검색합니다. 선언한 VARIANT* 형을 COleSafeArray 로변환하여데이터를입력합니다. 68 / 72
7.2.3. LONG ReceiveProcDataArr(LONG nrqid, BSTR sproc, LONG noutrecindex, VARIANT* parrdata) - RqID 값으로서비스응답 OutRec 의데이터를얻는함수 Param : nrqid ( 서비스요청시리턴받은값 ) sproc ( 서비스요청함수명칭 ) noutrecindex ( 서비스 OutRec 의순번 ) *parrdata ( 서비스응답데이터 - 2 차원배열 ) Return : noutrecindex 의 OutRec 갯수 Comment : 선언한 VARIANT* 형을 COleSafeArray 로변환하여데이터를입력합니다. 7.2.4. LONG GetProcItemArr(LONG nrqid, BSTR sproc, LONG noutrecindex, VARIANT* parritem) - RqID 값으로서비스응답 OutRec 의아이템명칭을얻는함수 Param : nrqid ( 서비스요청시리턴받은값 ) sproc ( 서비스요청함수명칭 ) noutrecindex ( 서비스 OutRec 의순번 ) *parritem ( 서비스아이템명칭 - 1 차원배열 ) Return : parritem 배열의개수 Comment : 선언한 VARIANT* 형을 COleSafeArray 로변환하여데이터를입력합니다. 69 / 72
8. 서비스요청시에러코드 RqID 값 설명 -1000 입력데이터에러 -1001 잘못된계좌번호입력 -1002 연속조회를할수없음 -1003 이전요청서비스응답이오지않은경우 ( 동기식 ) -1004 Proc I/O 정보를얻지못하는경우 -1005 주문시인증서에러 -1006 시세요청후 1 분뒤에할수있음 70 / 72
9. 기타 9.1. 2010.Net VC++ 래퍼클래스만드는법 - 클래스마법사에서 ActiveX 컨트롤의 MFC 클래스 (A).. 선택합니다. - FuturesNetS 가설치된폴더에서 FNDirect.ocx 를찾아서인터페이스를추가하여래퍼 클래스를만듭니다 9.2. 6.0 VC++ 래퍼클래스만드는법 - 리소스의 Dialog 에서오른쪽마우스팝업메뉴에서 Insert ActiveX Control.. 을선택 합니다. - FNDirect Control 을선택합니다. ( Insert ActiveX Control 창에는레지스트리에등록 된 OCX 만표시됩니다. FNDirect Control 이보이지않는경우 regsvr32 명령어로등록 을하거나 FnDirectClient.exe 실행하면레지스트리에등록됩니다.) - dialog 에 FNDiect 컨트롤이추가되면클래스위저드의 Memver Variables 에서 FNDirect 의컨트롤을더블클릭하여래퍼클래스를만듭니다. 71 / 72
- 래퍼클래스를만들면 Dialog 에있는 FNDirect 컨트롤은삭제합니다. 72 / 72