하나금융투자 (Open API) 개발자가이드 (v 1.3) Last Update

Transcription

1 하나금융투자 (Open API) 개발자가이드 (v 1.3) Last Update

2 문서이력 날짜 버전 내 용 2016/06/ 하나금융투자 Open API 개발가이드최초작성 2016/06/ 업종지수종목리스 ( 마스터 ) FID / 업종실시간가이드추가 2016/07/ 로그인, Tran 통신관련가이드추가 2016/08/ 일부내용보완및수정 2016/10/ API 인터페이스함수설명, 통신 I/O 설명추가및보안 2016/11/ API 인터페이스함수설명, 기타설명보안 2016/11/ /11/ /11/ /12/ /01/ /08/ API 에이전트이벤트핸들러추가 API 에이전트긴급공지, 다중접속알림이벤트핸들러추가 < 수정없음 > 종목마스터 FID 조회미니선물옵션실시간 res 가이드추가 Tr 전송제한안내문 페이지 2 / 103

3 ** 목차 1. Open API 사용자주의사항 면책사항공지 API Tran 전송제한사항 Overview Open API 란? 하나금융투자 Open API 특징 제공서비스 Sample Source 제공 사용절차 하나금융투자 Open API 폴더구조 폴더구성 레지스트리등록예시 Open API 에이전트컨트롤개발환경 Open API 에이전트컨트롤등록 / 사용 에이전트컨트롤등록 에이전트컨트롤사용 Open API 에이전트컨트롤 Interface 간략설명 메소드 Interface 이벤트 Interface Open API 에이전트컨트롤 Interface 상세 메소드상세 통신관련...15 페이지 3 / 103

4 리소스관련 통신조회관련공통 Tran조회관련 FID조회관련 실시간관련 부가적인메소드 계좌관련메소드 이벤트상세 통신 I/O 정보리소스파일 Tran조회정보리소스파일 Tran조회란? Tran 입출력정보리소스파일구조예시 (/TranRes/*.res) FID조회정보리소스파일 FID조회란? FID조회정보리소스파일구조 실시간 I/O정보리소스파일 실시간등록 / 해제 실시간데이터블록리소스파일구조예시 (/RealRes/*.res) 통신조회예제 Tran 조회 FID 단건조회 ( 응답데이터가단건 ) Open API 에이전트컨트롤 FID 단건조회예시 FID 복수건조회 ( 응답데이터가복수건 ) Open API 에이전트컨트롤 FID 복수건조회예시 실시간등록 / 해제예제 실시간등록 FID 통신전문가이드...41 페이지 4 / 103

5 8.1. FID 입력조건시장분류코드 투자정보 FID 투자정보공통입력 (Input) FID 출력 GID 1000 기본시세 ( 단건응답 -single) 출력 GID 1001 기본당일체결 ( 복수건응답 - array) 출력 GID 1003 기본디스크체결 ( 복수건응답 - array) 출력 GID 5000 관심종목 ( 복수건응답 - array) 기타 FID 조회 지수 FID 조회 ( 실시간 : U00.res) 외국계거래원순매수 / 매도상위 종목리스트 ( 마스터 ) FID 주식종목리스트 FID 업종종목리스트 FID ELW종목리스트 FID 지수선물종목리스트 지수옵션종목리스트 주식선물종목리스트 FID 주식옵션종목리스트 FID 야간선물종목리스트 FID 해외선물종목리스트 FID EUREX 종목리스트 FID FX마진종목리스트 FID 차트 FID 주식시장차트 FID ELW시장차트 FID 선물시장차트 FID 옵션시장차트 FID 해외선물시장차트 FID FX마진시장차트 FID Tran / 실시간리소스파일분류및설명 Tran 리소스파일분류및설명 (/TranRes/*.res) 실시간리소스파일분류및설명 (/RealRes/*.res) 해외선물주문...77 페이지 5 / 103

6 해외선물주문 I/O - 일반주문 ( 매수 / 매도 ) - OTS5901U01.res 해외선물주문 I/O - 정정주문 - OTS5901U02.res 해외선물주문 I/O - 취소주문 - OTS5901U03.res 국내지수 / 주식선물옵션주문 국내지수 / 주식선물옵션주문 I/O - 매도주문 - OTS2100U10.res 국내지수 / 주식선물옵션주문 I/O - 매수주문 - OTS2100U20.res 국내지수 / 주식선물옵션주문 I/O - 정정주문 - OTS2100U30.res 국내지수 / 주식선물옵션주문 I/O - 취소주문 - OTS2100U40.res 야간선물옵션주문 야간선물옵션주문 I/O - 매도 / 매수주문 - OTS2850U30.res 야간선물옵션주문 I/O - 정정주문 - OTS2850U32.res 야간선물옵션주문 I/O - 취소주문 - OTS2850U33.res FX마진주문 FX마진주문 I/O - 일반주문 - OTS5901U31.res FX마진주문 I/O - 정정주문 - OTS5901U32.res FX마진주문 I/O - 취소주문 - OTS5901U33.res 주식주문 주식주문 I/O - 매도 - OTS1111U10.res 주식주문 I/O - 매수 - OTS1111U20.res 주식주문 I/O - 정정 - OTS1111U30.res 주식주문 I/O - 취소 - OTS1111U40.res Open API 예제파일설명 Visual Studio 2013 C++(MFC) 예제파일 소스파일구성 Visual Studio 2013 C# 예제 소스파일구성 부가사항들 계좌체계설명 페이지 6 / 103

7 1. Open API 사용자주의사항 1.1. 면책사항공지 가 ) 회사는사용자가변경프로그램으로인해발생하는모든결과에대해책임을지지않으며, 사용자는이로인한모든손실에대하여배상하여야한다. 나 ) 변경프로그램은오로지사용자의이익과필요에따라사용자에의하여구성된것이며변경프로그램으로인하여본서비스에어떠한장애가발생할수있으며이로인한모든손실은사용자가부담하며배상하여야한다. 다 ) 본서비스와변경프로그램중원인발생이불분명한경우변경프로그램의하자로추정되며, 반대되는사실에대한입증책임은사용자에게있다. 라 ) 본서비스를사용한변경프로그램을제3의사용자에게제공했을경우해당프로그램으로인해발생되는문제에대한책임은회사에있지아니하고사용자에게있다. 마 ) 본서비스를이용해서취하게되는데이터의사용권은해당사용자에게만주어지며, 제3자에게양도될수없다. 바 ) 전산장애, 통신장애, 기타천재지변등으로인해회사가신의성실의원칙에따른상당한주의로서업무처리를하였음에도불구하고본서비스의장애또는중단됨을이유로불가피하게발생하는손해등사고에대하여회사는책임을지지않는다. 사 ) 사용자의전산기기의조작오류, 업무처리의오류처리등사용자의귀책사유로인하여발생하는손해등에대하여회사는책임을지지않는다. 아 ) 사용자의신청계좌, 계좌비밀번호, 접속아이디, 접속비밀번호등의개인비밀사항에대한사용자의누설로인해발생하는손해등에대하여회사는책임을지지않는다. 자 ) 사용자는관계법령및규정을준수하여야하며, 대여계좌로사용하거나사용되게하여서는아니된다 API Tran 전송제한사항 가 ) 동일 Tran 을 1초이내에 5건초과전송하는것을제한한다. 제한시간이내초과전송되는 Tran은오류처리가된다. 단, 주문 Tran과연속조회 ( 이전, 다음 ) Tran은초과전송건수에포함되지않는다. 나 ) 동일 Tran 오류발생을 50회이하로제한한다. 동일 Tran에서 50회초과하여오류발생시해당 Tran은 Tran전송이정지되며프로그램재실행이후에 Tran 전송재개가가능하다. 페이지 7 / 103

8 2. Overview 2.1. Open API 란? 프로그램개발이가능한고객들을위한 HTS 연결프로그램입니다. 제공되는인터페이스를통해투자정보를제공받을수있습니다. Visual C++(2013) 으로작성되었으며, OCX 형태 (Active-X) 로제공됩니다. Active-X 의 Automation 기능을이용가능한개발언어를지원합니다. ( Visual C++(MFC), C#, VB, Delphi, Excel 등 ) 2.2. 하나금융투자 Open API 특징 스크립트수준의간편, 직관적이고호환성높아진 API 인터페이스제공. - C++, C#, VB, Excel 등동일한인터페이스그대로사용가능. 통신정보리소스파일제공. - 프로그래밍에서구조체, 통신전문작성등의필요가없어코딩의복잡도가낮아졌다. - 통신 (Tran/ 실시간 ) 리소스파일로인해 API Agent 컨트롤에서자동처리할것과개발자가프로그래밍해야될것들이분리 / 캡슐화되어직관성및편의성이높아졌다 제공서비스 주식 지수선물 / 옵션 해외선물 FX 마진 CME & EUREX 연계 KOSPI200 선물 / 옵션야간거래 2.4. Sample Source 제공 Visual C++(MFC) C# 2.5. 사용절차 가까운지점을방문하여계좌개설을한다. 하나금융투자서비스변경에관한특별약정 을신청한다. 서비스승인후하나금융투자이용한다. 지점방문 1Q Pro(API) 개발지원 시스템구축 계좌개절 사용계약 ( 게시판 ) 페이지 8 / 103

9 2.6. 하나금융투자 Open API 폴더구조 폴더구성 RootDirectory 아래에 "/system", "/RealRes", "/TranRes", "/Cert" 폴더가구성되어있어야한다. 각폴더에포함된파일은아래와같다.( 필수구성파일들 ) ROOT / /system comms.ini 통신연결정보파일 realdata.dat 실시간데이터정보 /TranRes *.res Tran조회 I/O Block정보리소스파일 /RealRes *.res 실시간 I/O Block정보리소스파일 /Cert mobile-test-cert.der 암호화인증서 /AddIn /ScpAgt 패킷암호화모듈폴더 HFCommAgent.dll Open API 에이전트컨트롤모듈 reghfcommagent.bat HFCommAgent.dll 모듈레지스트리등록배치파일 HFComms.exe 통신모듈 CommApi.dll 통신인터페이스모듈 xmclient260.dll 암호화모듈 LinkInfoMng.dll 정보보관모듈 CodeMaster.dlll 코드정보관련모듈 SrShare.dll 공통함수라이브러리모듈 bugslayerutil.dll Crash report 모듈 fpbp3220.dll Device 관련 < 기타공인인증등 dll 파일설명은생략한다.> OpenAPI 프로그램실행시매번 reghfcommagent.bat 배치파일을실행 HFCommAgent.dll 모듈정보를 레지스트리에등록할것을강력히권장한다 레지스트리등록예시 reghfcommagent.bat 배치파일을실행하면아래와같이레지스트리에정보가등록된것을볼수있다. 경로 : " 컴퓨터 \HKEY_LOCAL_MACHINE\SOFTWARE\Classes\HFCOMMAGENT.HFCommAgentCtrl.1" 페이지 9 / 103

10 2.7. Open API 에이전트컨트롤개발환경 에이전트컨트롤은 Visual Studio 2013( 버전 Update 5) 에서개발및 32bit 빌드배포된다. (Visual Studio Professional 2013 시작화면 ) 사용자 PC 에 Visual Studio 2013 c++ 설치이력이없을경우, 받드시 "Visual Studio 2013 용 C++ 재배포가 능패키지 (vcredist_x86.exe)" 설치하여에이전트컨트롤에종속된 MFC dll 버전에문제가없도록해야된다. ( 재포배미설치시오류발생 ) OpenAPI 에이전트컨트롤을사용하여프로그램개발시에는 Visual Studio2013 보다하위 / 상위버전으로개발 해도상관없다. 페이지 10 / 103

11 개발한프로그램은관리자권한으로실행되어야한다. 그렇지않으면 DLL 함수포인터얻기실패등의오류가발생할수있다. 또한 VS2013로개발시윈도우 XP, 윈도우 Vista에서프로그램을구동시키기위해서는아래와같이프로젝트속성설정이필요하다. 관리자권한 : 링커 -> 모든옵션 -> UAC 실행준 -> requireadministrator(/level='requireadministrator') XP/Vista 호환 : 일반 -> 플랫폼도구집합 -> Visual Studio Windows XP (v120_xp) 페이지 11 / 103

12 2.8. Open API 에이전트컨트롤등록 / 사용 에이전트컨트롤등록 레지스트리등록방법 reghfcommagent.bat 파일을관리자권한으로실행한다 에이전트컨트롤사용 선언 #include "hfcommagent.h" CHFCommAgent m_commagent; //Open API Agent control 구현 (Open API Agent 컨트롤윈도우생성 ) BOOL brtn = m_commagent.create("hfcommagent.hfcommagentctrl.1", NULL, WS_CHILD, CRect(0, 0, 0, 0), this, IDC_HFCOMMAGENTCTRL1); if (!brtn) { ::AfxMessageBox("Open API Agent 컨트롤윈도우생성을실패했습니다!"); } 페이지 12 / 103

13 3. Open API 에이전트컨트롤 Interface 간략설명 3.1. 메소드 Interface 분류1 분류2 ID 반환 메소드이름 설명 1 LONG CommInit 통신모듈초기화및연결 접속 2 void CommTerminate 통신연결해제 3 LONG CommGetConnectState 통신연결상태확인 통신 4 LONG CommLogin 로그인처리 관련 5 LONG CommLogout 로그아웃처리 로그인 6 LONG GetLoginState 로그인상태확인 7 Void SetLoginMode 로그인모드설정 8 LONG GetLoginMode 로그인모드확인 리소스 Tran 10 LONG LoadTranResource Tran I/O Block정보리소스파일로드실시간 11 LONG LoadRealResource 실시간Block정보리소스파일로드 조회 RQ ID 15 LONG CreateRequestID 조회고유ID 생성 ( 통신조회시필수 ) 공통 옵션값 16 LONG GetCommRecvOptionValue 조회결과부가정보 / 옵션값반환 Tran 조회 FID 조회실시간처리 입력 20 LONG SetTranInputData Tran조회항목별입력값입력 21 LONG RequestTran Tran조회요청 22 LONG GetTranOutputRowCnt Tran조회응답데이터건수반환 출력 23 BSTR GetTranOutputData Tran조회응답데이터항목별값반환 24 LONG SetTranInputArrayCnt Tran조회입력데이터건수설정 25 LONG SetTranInputArrayData Tran조회복수건입력 30 LONG SetFidInputData FID조회항목별입력값입력 입력 31 LONG RequestFid FID조회요청 ( 응답이단건-single) 32 LONG RequestFidArray FID조회요청 ( 응답이복수건-array) 33 LONG GetFidOutputRowCnt FID조회응답데이터건수반환 출력 34 BSTR GetFidOutputData FID조회응답데이터항목별값반환 35 LONG GetCommFidDataBlock 1 FID조회응답데이터포인터반환 (C++) 36 LONG SetPortfolioFidInputData 관심종목형 (Portfolio) FID 조회 등록 40 LONG RegisterReal 실시간등록 해제 41 LONG UnRegisterReal 실시간등록해제 해제 42 LONG AllUnRegisterReal 모든실시간등록해제 출력 43 BSTR GetRealOutputData 실시간수신데이터항목별반환 44 LONG GetCommRealRecvDataBlock 2 실시간수신데이터포인터반환 (C++) 1 GetCommFidDataBlock: 차트, 종목리스트 ( 마스터 ) 와같은대량의데이터 FID조회시좀더빠른처리성능을위해메모리블럭포인터를제공하며, C++ 개발환경에서만사용이가능하다. 2 GetCommRealRecvDataBlock: 짧은시간안에대량의실시간처리시좀더빠른성능을위해메모리블럭포인터접근을제공하며, C++ 개발환경에서만사용이가능하다. Visual C++(MFC) 예제소스기준초로측정한결과, 10만개항목의대량데이터처리시메모리인덱스접근이항상좋은성능을보이지만, 소량의데이터처리시에는빈도는낮지만메모리인덱스접근이항상좋은 페이지 13 / 103

14 부가 계좌 메시지 50 BSTR GetLastErrMsg 마지막으로발생한오류메시지반환 경로 51 BSTR GetApiAgentModulePath OpenAPI 에이전트모듈파일경로반환 암호 52 BSTR GetEncrpyt 데이터암호화 메시지 53 void SetOffAgentMessageBox API 에이전트메시지박스실행방지 옵션 54 BSTR SetOptionalFunction 부가적인옵션처리 정보 60 BSTR GetAccInfo 계좌정보 개수 61 LONG GetUserAccCnt 보유계좌수 계좌 62 BSTR GetUserAccNo 보유계좌반환 3.2. 이벤트 Interface 분류 1 분류 2 ID 반환메소드이름설명 조회 / 실시간 1 Void OnGetTranData Tran조회에대한응답이벤트 응답 2 Void OnGetFidData FID조회에대한응답이벤트 / 3 Void OnGetRealData 실시간데이터수신이벤트 수신 4 void OnAgentEventHandler 에이전트이벤트핸들러참고 ( 통신 / 공지이벤트등, 예제소스참고 ) 성능을보이지는않는다. 결론적으로 PC 환경과하드웨어성능에따른변수로인해차이는있지만, 대량의데 이터처리가아니라면벡터인덱스접근이항상좋은성능을보이는것은아니다. 페이지 14 / 103

15 4. Open API 에이전트컨트롤 Interface 상세 4.1. 메소드상세 통신관련 ID 1 (0x01) 원형 LONG CommInit(void) 기능 통신모듈초기화및연결 호출 로그인처리전에호출한다. 인자 void 없음 반환 LONG 0 : 성공, 음수 : 오류 기타 ID 2 (0x02) 원형 void CommTerminate(LONG bsocketclose) 기능 연결해제 호출 로그아웃처리이후에호출한다. 인자 LONG bsocketclose 1 : 통신모듈종료및연결해제, 0 : 통신모듈과연결해제 반환 void 없음 기타 ID 3 (0x03) 원형 LONG CommGetConnectState(void) 기능 통신연결상태확인 호출 CommInit 메소드호출후통신연결상태확인을위해호출한다. 인자 void 없음 반환 LONG 0 : 연결끊김, 1 : 연결 기타 ID 4 (0x04) 원형 LONG CommLogin(BSTR suserid, BSTR spwd, BSTR scertpwd) 기능 로그인처리 호출 CommInit 호출이후통신연결이완료된이후에호출한다. 인자 BSTR suserid BSTR spwd BSTR scertpwd 로그인 ID 로그인비밀번호공인인증비밀번호 반환 LONG 0 : 실패, 1 : 성공 기타 페이지 15 / 103

16 ID 5 (0x05) 원형 LONG CommLogout(BSTR suserid) 기능 로그아웃처리 호출 CommTerminate 호출전에호출한다. 인자 BSTR suserid 로그인 ID 반환 LONG 0 : 성공 기타 ID 6 (0x06) 원형 LONG GetLoginState(void) 기능 로그인상태확인 호출 CommLogin 메소드호출이후, 로그인상태확인목적으로호출한다. 인자 void 없음 반환 LONG 0 : 로그아웃, 1 : 로그인 기타 ID 7 (0x07) 원형 void SetLoginMode(LONG noption, LONG nmode) 기능 로그인모드설정 호출 CommLogin 메소드호출전, 로그인접속설정을한다.. 인자 LONG noption LONG nmode 0 : 모의투자구분, 1 : 시세전용구분 noption(0) 0: 실거래, 1: 국내모의, 2: 해외모의 noption(1) 0: 공인인증, 1: 시세전용예 ) m_commagentctrl.setloginmode(0, 0) // 실거래로그인 m_commagentctrl.setloginmode(0, 1) // 국내모의로그인 m_commagentctrl.setloginmode(1, 1) // 시세전용로그인 ( 인증서 X) 반환 void 기타 ID 8 (0x08) 원형 LONG GetLoginMode (LONG noption) 기능 로그인상태확인 호출 CommLogin 메소드호출이후, 로그인상태확인목적으로호출한다. 인자 LONG noption 0 : 모의투자체크, 1 : 시제전용, 2 : 직원 / 고객로그인 반환 LONG -1 : 실패, 성공 : -1 보다큰양수 기타 페이지 16 / 103

17 리소스관련 ID 10 (0x0A) 원형 LONG LoadTranResource(BSTR strfilepath) 기능 Tran 조회 I/O Block 정보리소스파일로드 호출 Tran 조회시에반드시리소스파일이에이전트컨트롤에적재되어있어야한다. 인자 BSTR strfilepath Tran I/O Block 정보리소스파일 (*.res) 경로 반환 LONG 0 : 실패, 1 : 성공 기타 ID 11 (0x0B) 원형 LONG LoadRealResource(BSTR strfilepath) 기능 실시간 Block 정보리소스파일로드 호출 실시간등록시에반드시리소스파일이에이전트컨트롤에적재되어있어야한다. 인자 BSTR strfilepath 실시간 Block 정보리소스파일 (*.res) 경로 반환 LONG 0 : 실패, 1 : 성공 기타 페이지 17 / 103

18 통신조회관련공통 ID 15 (0x0F) 원형 LONG CreateRequestID(void) 기능 조회고유 ID 생성 (Request ID) 호출 Tran/FID 조회시, RQ ID 를먼저생성한다. 인자 Void 없음 반환 LONG 신규 RQ ID 반환 ( 음수 : 실패, 2 보다큰정수 : 성공 ) 기타 ID 16 (0x10) 원형 BSTR GetCommRecvOptionValue(LONG noptiontype) 기능 조회응답부가정보 / 옵션값반환 호출 Tran/FID 조회 (OnGetTranData, OnGetFidData) 응답이벤트안에서만호출한다. 인자 LONG noptiontype CommRecvOpt::TranCode = 0 : Tr 코드 CommRecvOpt::PrevNextCode = 1 : 연속데이타구분 (0: 없음, 1: 이전, 2: 다음, 3: 이전 / 다음 ) CommRecvOpt::PrevNextKey = 2 : 연속조회키 CommRecvOpt::MsgCode = 3 : 메시지코드 CommRecvOpt::Msg = 4 : 메시지 CommRecvOpt::SubMsgCode = 5 : 부가메시지코드 CommRecvOpt::SubMsg = 6 : 부가메시지 반환 BSTR noptiontype 에대응하는문자열값반환 기타 ID 17 (0x11) 원형 LONG ReleaseRqId(LONG nrqid) 기능 조회고유 ID(Request ID) 할당해제 호출 CreateRequestID 함수로생성 ( 할당 ) 한 RQ ID 를해제할때사용. 인자 LONG nrqid CreateRequestID 로생성 ( 할당 ) 받은 RQ ID 반환 void 없음 기타 페이지 18 / 103

19 Tran 조회관련 ID 20 (0x14) 원형 LONG SetTranInputData(LONG nrqid, BSTR strtrcode, BSTR strrecname, BSTR stritem, BSTR strvalue) 기능 Tran 조회, 항목별입력값을입력한다 호출 RequestTran 호출전에통신 Input 데이터입력목적으로호출한다. 인자 LONG nrqid BSTR strtrcode BSTR strrecname BSTR stritem BSTR strvalue 조회고유 ID(Request ID) - CreateRequestID 메소드로생성서비스 Tr 코드 (Tran 리소스파일 (*.res) 파일의 ' TR_CODE=' 항목 ) Input 레코드명 (Tran 리소스파일 (*.res) 파일의 ' REC_NAME=' 항목 ) Input 항목명 (Tran 리소스파일 (*.res) 파일의 'ITEM=' 항목 ) Input 항목에대응하는입력값 반환 LONG 0 : 실패, 1 : 성공 기타 ID 원형 21 (0x15) LONG RequestTran(LONG nrqid, BSTR strcode, BSTR sisbenefit, BSTR sprevornext, BSTR sprevnextkey, BSTR sscreenno, BSTR strantype, LONG nrequestcount) 기능 Tran 조회요청 호출 서버에 Tran 조회요청시호출 인자 LONG nrqid BSTR strcode BSTR sisbenefit BSTR sprevornext BSTR sprevnextkey BSTR sscreenno BSTR strantype LONG RequestCount 조회고유 ID(Request ID) - (CreateRequestID 메소드로생성 ) 서비스 Tr 코드 (Tran 리소스파일 (*.res) 파일의 ' TR_CODE=' 항목 ) 수익계좌여부 ("Y", "N") 연속조회구분 ("0" : 일반조회, "1" : 연속조회첫조회, "2" : 이전조회, "3" : 다음조회 ) 다음 / 이전조회시연속구분이되는키값입력 ( 조회응답으로내려온다.) 화면번호 (ex-> "9999") Q': 조회, 'U':Update( 보통조회는 'Q', 주문등은 'U' 를입력한다.) 조회응답으로받을최대데이터건수 (Maxium : 9999) 반환 LONG 음수 : 실패, 0 보다큰정수 : 성공 기타 ID 원형 기능 22 (0x16) LONG GetTranOutputRowCnt(BSTR strtrcode, BSTR strrecname) Tran 조회응답데이터건수반환 호출 Tran 조회응답이벤트 (OnGetTranData) 안에서만호출한다. 인자 BSTR strtrcode BSTR strrecname 서비스 Tr 코드 (Tran 리소스파일 (*.res) 파일의 ' TR_CODE=' 항목 ) Input 레코드명 (Tran 리소스파일 (*.res) 파일의 ' REC_NAME=' 항목 ) 반환 LONG 0 : 데이터없음, 0 보다큰정수 : 데이터건수 기타 페이지 19 / 103

20 ID 23 (0x17) 원형 BSTR GetTranOutputData(BSTR strtrcode, BSTR strrecname, BSTR stritemname, LONG nrow) 기능 Tran 조회항목별응답데이터반환호출 Tran 조회응답이벤트 (OnGetTranData) 안에서만호출한다. 인자 BSTR strtrcode BSTR strrecname BSTR stritemname LONG nrow 반환 BSTR 기타 ID 24 (0x18) 원형 LONG SetTranInputArrayCnt(LONG nrqid, BSTR strtrcode, BSTR strrecname, LONG nreccnt) 기능 Tran 조회입력데이터건수설정호출 RequestTran 호출전에통신 Input 데이터건수입력목적으로호출한다. 인자 LONG nrqid BSTR strtrcode BSTR strrecname : 입력레코드명 LONG nreccnt : 데이터입력건수반환 LONG 0 : 실패, 1 : 성공기타 ID 25 (0x19) 원형 LONG SetTranInputArrayData(LONG nrqid, BSTR strtrcode, BSTR strrecname, BSTR stritem, BSTR strvalue, LONG narrayindex) 기능 Tran 조회복수건입력호출 RequestTran 호출전에통신복수건 Input 데이터입력목적으로호출한다. 인자 LONG nrqid BSTR strtrcode BSTR strrecname : 입력레코드명 BSTR stritem : 항목명 BSTR strvalue : 입력값 LONG narrayindex : 레코드인덱스 (0 부터시작 ) 반환 LONG 0 : 실패, 1 : 성공기타 페이지 20 / 103

21 FID조회관련 ID 30 (0x1E) 원형 기능 LONG SetFidInputData(LONG nrqid, BSTR strfid, BSTR strvalue) FID 조회시, 항목별입력값입력 호출 RequestFid 또는 RequestFidArray 호출전에조회 Input 데이터입력목적으로호출한다. 인자 LONG nrqid BSTR strfid BSTR strvalue 조회고유 ID(Request ID) - CreateRequestID 메소드로생성 FID 번호 (ex-> "9002") 반환 LONG 0 : 실패, 1 : 성공 기타 FID 번호에대응하는입력값 (ex-> "000660") ID 31 (0x1F) 원형 LONG RequestFid(LONG nrqid, BSTR stroutputfidlist, BSTR strscreenno) 기능 FID 조회요청 - 응답데이터가단건 (single) 호출 서버에 FID 조회요청시호출 ( 응답으로받을데이터단건일경우에사용 ) 인자 LONG nrqid BSTR stroutputfidlist BSTR strscreenno 조회고유 ID(Request ID) - CreateRequestID 메소드로생성응답으로받을 FID 번호들 (ex-> "4,6,5,7,11,28,13,14,15") 화면번호 (ex-> "9999") 반환 LONG 음수 : 실패, 1 : 성공 : 2 보다큰정수 기타 ID 32 (0x20) 원형 LONG RequestFidArray(LONG nrqid, BSTR stroutputfidlist, BSTR strprenext, BSTR strprenextcontext, BSTR strscreenno, LONG nrequestcount) 기능 FID 조회요청 - 응답데이터가복수건 (array) 호출 서버에 FID 조회요청시호출 ( 응답받을데이터가복수건인경우에사용 ) 인자 LONG nrqid BSTR stroutputfidlist BSTR strprenext BSTR strprenextcontext BSTR strscreenno LONG nrequestcount 조회고유 ID(Request ID) - CreateRequestID 메소드로생성응답으로받을 FID 번호들 (ex-> "4,6,5,7,11,28,13,14,15") 연속조회구분 ("0" : 일반, "1" : 연속첫조회, "2" : 이전조회, "3" : 다음조회 ) 조회응답으로받은연속거래키화면변호 (ex-> "9999") 조회응답으로받을최대데이터건수 (Maxium : 9999) 반환 LONG 음수 : 실패, 1 : 성공 : 2 보다큰정수 기타 ID 33 (0x21) 원형 LONG GetFidOutputRowCnt(LONG nrequestid) 기능 FID 조회응답데이터건수 호출 FID 조회응답이벤트 (OnGetFidData) 안에서만호출한다. 인자 LONG nrequestid 조회고유 ID(Request ID) - CreateRequestID 메소드로생성 반환 LONG 0 : 데이터없음, 0 보다큰정수 : 데이터건수 기타 페이지 21 / 103

22 ID 34 (0x22) 원형 BSTR GetFidOutputData(LONG nrequestid, BSTR strfid, LONG nrow) 기능 FID 조회항목별응답데이터반환 호출 FID 조회응답이벤트 (OnGetFidData) 안에서만호출한다. 인자 LONG nrequestid BSTR strfid LONG nrow 조회고유 ID(Request ID) - CreateRequestID 메소드로생성응답받은 FID 번호 (ex-> "4") 항목값이위치한행인덱스 - 단건 (single) : 0 - 복수건 (array) : 해당행의인덱스번호 반환 BSTR FID 에대응한응답데이터 기타 ID 35 (0x23) 원형 LONG GetCommFidDataBlock(LONG pvvector); 기능 FID 조회응답데이터메모리블럭포인터 호출 FID 조회응답이벤트 (OnGetFidData) 안에서만호출한다. 인자 LONG pvvector 응답데이터접근데이터블럭포인터 Ex) CCommRecvData fidcommrecvdata; // 선언 m_commagent. GetCommFidDataBlock((long)&fidCommRecvData); 반환 LONG 0 : 실패, 1 : 성공 기타 차트, 종목리스트 ( 마스터 ) 와같은대량의데이터처리시좀더빠른처리성능을위해메모리인덱스 접근을제공하며, C++ 개발환경에서만사용이가능하다. 대량의데이터처리가아니라면메모리인덱스접근이항상좋은성능을보이는것은아니다. ID 36 (0x24) 원형 LONG SetPortfolioFidInputData(LONG nrqid, BSTR strsymbolcode, BSTR strsymbolmarket) 기능 관심종목형 (Portfolio) FID 조회시, 항목별입력값입력 호출 RequestFid 또는 RequestFidArray 호출전에조회 Input 데이터입력목적으로호출한다. 인자 LONG nrqid BSTR strsymbolcode BSTR strsymbolmarket 조회고유 ID(Request ID) - CreateRequestID 메소드로생성종목코드종목시장코드 반환 LONG 0 : 실패, 1 : 성공 기타 페이지 22 / 103

23 실시간관련 ID 40 (0x28) 원형 LONG RegisterReal(BSTR strrealname, BSTR strrealkey) 기능 실시간등록한다. 호출 로그인처리가완료된이후또는 Tran/FID 조회응답이벤트안에서호출한다. 인자 BSTR strrealname BSTR strrealkey 실시간등록할실시간코드명실시간리소스파일 (*.res) 파일의 ' REAL_NAME=' 항목 (ex-> "S00") 실시간수신시데이터구분키가될값 (ex-> "000660" : SK 하이닉스종목코드 ) 반환 LONG 음수 : 실패, 0 : 성공 기타 ID 41 (0x29) 원형 LONG UnRegisterReal(BSTR strrealname, BSTR strrealkey) 기능 실시간등록해제한다. 호출 RegisterReal 함수호출이후에호출한다. 인자 BSTR strrealname BSTR strrealkey 실시간등록해제할실시간코드명실시간리소스파일 (*.res) 파일의 ' REAL_NAME=' 항목 (ex-> "S00") 실시간등록해제할실시간등록키 (ex-> "000660" : SK 하이닉스종목코드 ) 반환 LONG 음수 : 실패, 1 : 성공 기타 ID 42 (0x2A) 원형 LONG AllUnRegisterReal(void) 기능 모든실시간등록해제한다. 호출 RegisterReal 함수호출이후에호출한다. 인자 없음 반환 LONG 음수 : 실패, 1 : 성공 기타 ID 43 (0x2B) 원형 BSTR GetRealOutputData(BSTR strrealname, BSTR stritemname) 기능 항목별실시간수신데이터를반환한다. 호출 실시간데이터수신이벤트 (OnGetRealData) 안에서만호출한다. 인자 BSTR strrealname BSTR stritemname 실시간수신데이터실시간코드명실시간리소스파일 (*.res) 파일의 ' REAL_NAME=' 항목 (ex-> "S00") 실시간리소스파일 (*.res) 파일의 ' ITEM=' 항목 (ex-> " SHRN_ISCD") 반환 BSTR 해당 stritemname 에대응하는데이터값반환 기타 페이지 23 / 103

24 ID 44 (0x2C) 원형 LONG GetCommRealRecvDataBlock(LONG pvector) 기능 실시간수신데이터메모리블럭포인터제공 호출 실시간데이터수신이벤트 (OnGetRealData) 안에서만호출한다. 인자 LONG pvector 응답데이터직접접근에사용될메모리포인터 Ex) CCommRecvData realcommrecvdata; m_commagent.getcommrealrecvdatablock((long)&realcommvector); 반환 BSTR 0 : 실패, 1 : 성공 기타 짧은시간안에대량의실시간데이터건수처리시좀더빠른성능을위해메모리인덱스접근을 제공하며, C++ 개발환경에서만사용이가능하다. 대량의데이터처리가아니라면메모리인덱스접근이항상좋은성능을보이는것은아니다. 페이지 24 / 103

25 부가적인메소드 ID 50 (0x32) 원형 기능 BSTR GetLastErrMsg(void) 에러메시지확인 호출 API 메소드에서에러가발생했을경우, 에러메시지확인하기위해호출한다. 인자 없음 반환 BSTR 마지막으로호출된 API 메소드에서에러가발생했을경우에러메시지반환 기타 ID 원형기능호출인자 51 (0x33) BSTR GetApiAgentModulePath(void) OpenAPI 에이전트모듈파일경로반환에이전트오브젝트생성이후에호출없음 반환 BSTR OpenAPI 에이전트모듈파일경로반환 기타 ID 원형 52 (0x34) BSTR GetEncrpyt (BSTR strplaintext) 기능 평문을암호화한다 ( 계좌비밀번호암호화등에사용된다.) 호출인자 BSTR 평문 반환 BSTR 암호문 기타 ID 원형 53 (0x35) void SetOffAgentMessageBox (LONG noption) 기능에이전트에띄우는메시박스를막는다. 호출 CommInit 함수호출전 SetOffAgentMessageBox 함수를호출해야된다. 인자 LONG 0 : 에이전트메시지박스실행, 1 : 에이전트메시지박스실행안함 반환 없음 기타 ID 원형 54 (0x36) BSTR SetOptionalFunction(LONG noption, LONG nvalue1, LONG nvalue2, BSTR strvalue1, BSTR strvalue2) 기능부가적인옵션처리 ( 옵션세부설정은신규추가시가이드문서에포함재배포 ) 호출 인자 없음 반환 BSTR 옵션처리결과문자열 페이지 25 / 103

26 기타 계좌관련메소드 ID 원형 기능 호출 인자 60 (0x32) BSTR GetAccInfo(LONG noption, BSTR szaccno) 계좌정보 LONG noption BSTR szaccno 0 : 계좌대체번호, 1 : 계좌상품번호, 198 : 대리인등록여부 ("Y" : 주문대리계좌 ) 계좌번호 반환 BSTR 옵션에해당하는값 기타 ID 61 (0x3D) 원형 LONG GetUserAccCnt() 기능 보유계좌수 호출 인자 없음 반환 LONG 보유계좌수 기타 ID 62 (0x3E) 원형 BSTR GetUserAccNo(LONG nindex) 기능 보유계좌반환 호출인자 LONG nindex 보유계좌인덱스 반환 BSTR 계좌번호반환 ( 종합계좌번호 (8) + 계좌상품번호 (3)) 기타 페이지 26 / 103

27 4.2. 이벤트상세 ID 원형설명호출인자반환기타 1 (0x01) void OnGetTranData(LONG nrequestid, BSTR pblock, long nblocklength) Tran 조회응답이벤트 API 에이전트컨트롤 CallBack LONG nrequestid 조회고유 ID(Request ID) - CreateRequestID 메소드로생성 BSTR pblock 응답데이터블록 long nblocklength 응답데이터블록크기없음 ID 원형설명호출인자반환기타 2 (0x02) void OnGetFidData(LONG nrequestid, BSTR pblock, long nblocklength) FID 조회응답이벤트 API 에이전트컨트롤 CallBack LONG nrequestid 조회고유 ID(Request ID) - CreateRequestID 메소드로생성 BSTR pblock 응답데이터블록 long nblocklength 응답데이터블록크기없음 ID 원형설명호출인자반환기타 3 (0x03) void OnGetRealData(BSTR strrealname, BSTR strrealkey, LPCTSTR pblock, long nblocklength) 실시간데이터수신이벤트 API 에이전트컨트롤 CallBack BSTR strrealname 실시간수신데이터실시간코드명실시간리소스파일 (*.res) 파일의 ' REAL_NAME=' 항목 (ex-> "S00") BSTR strrealkey 실시간수신실시간등록키 (ex-> "000660" : SK 하이닉스종목코드 ) LPCTSTR pblock 수신데이터블록 long nblocklength 수신데이터블록크기없음 페이지 27 / 103

28 ID 원형설명호출인자반환기타 4 (0x04) void OnAgentEventHandler(long neventtype, long nparam, LPCTSTR strparam); 통신접속해제등이벤트 API 에이전트컨트롤 CallBack long neventtype 통신이벤트 : 100 이상, 공지이벤트 : 150 이상 long nparam 옵션값 LPCTSTR strparam 옶션값없음 StockSiseDlg.cpp, FFutOptOrdDlg.cpp 예제참고 페이지 28 / 103

29 5. 통신 I/O정보리소스파일 5.1. Tran조회정보리소스파일 Tran조회란? 고정된입출력데이터블록으로데이터를주고받는것을 Tran조회라한다. Tran조회는정해진서비스코드명과입력구조 (I/O Layout) 에맞춰조회를요청하고서버응답역시정해진출력구조에맞춰받게된다. OpenAPI에서는 Tran조회입출력데이터블록구조를리소스파일로제공하고있으며, 확장자는 *.res이며서비스코드명이파일명이된다. 주문체결내역입출력정보리소스파일, 서비스코드명이파일명이다. ex) OTS1201Q00.res Tran 입출력정보리소스파일구조예시 (/TranRes/*.res) BEGIN_TRAN_LAYOUT TR_CODE=OTS1201Q00, TR_NAME= 주문체결내역체결단가별, SERVER=B, ENCODE=0, COMPRESS=0, CERT=0; BEGIN_RECORD '******************************************* '* 통신입력부분입니다. '******************************************* REC_NAME=OTS1201Q00_in, INOUT=0, ARRAY=0, ARRINFO=; BEGIN_INPUT0_ITEM SEQ=0, TYPE=string, SIZE=64, ITEM=PWD, CAPTION= 비밀번호 ; SEQ=1, TYPE=string, SIZE=9, ITEM=CTNO, CAPTION= 종합계좌대체번호 ; < 생략 > SEQ=13, TYPE=string, SIZE=1, ITEM=SELL_BUY_DCD, CAPTION= 매도매수구분코드 ; END_INPUT0_ITEM '******************************************* '* 통신출력부분입니다. '******************************************* REC_NAME=OTS1201Q00_out, INOUT=1, ARRAY=0, ARRINFO=; BEGIN_OUTPUT0_ITEM SEQ=0, TYPE=string, SIZE=5, ITEM=MNGM_BDCD, CAPTION= 관리부점코드 ; SEQ=1, TYPE=string, SIZE=19, ITEM=SELL_CNCS_QNT, CAPTION= 매도체결수량 ; < 생략 > SEQ=4, TYPE=string, SIZE=19, ITEM=BUY_CNCS_AMT, CAPTION= 매수체결금액 ; END_OUTPUT0_ITEM REC_NAME=OTS1201Q00_out_sub01, INOUT=1, ARRAY=1, ARRINFO=; 페이지 29 / 103

30 END_RECORD END_TRAN_LAYOUT BEGIN_OUTPUT1_ITEM END_OUTPUT1_ITEM SEQ=0, TYPE=string, SIZE=11, ITEM=ORDR_SN, CAPTION= 주문일련번호 ; SEQ=1, TYPE=string, SIZE=11, ITEM=OR_ORDR_SN, CAPTION= 원주문일련번호 ; < 생략 > SEQ=25, TYPE=string, SIZE=40, ITEM=ORDR_PRCS_STTS_DVSN_NM, CAPTION= 주문처리상태구분명 ; TR_CODE : Tran 서비스코드 REC_NAME : 입력 / 출력블록별구분하는레코드 ARRAY : 0 - 싱글형 ( 단건 ), 0 이아닌값은배열형 ( 복수건 ) SEQ : 각항목들의순서인덱스번호 TYPE: 항목값의데이터유형 SIZE: 항목값의 BYTE 크기 ITEM : 블록을구성하는항목명 리소스파일하단에보면다음과같이소스템플릿이생성되어있다. API 개발자는필요하면해당소스를복사 & 붙여넣기하여사용하면된다. /********************************************** 개발편의를위한 SetTranInputData 메소드 MFC 소스템플릿 I N - P U T **********************************************/ CString strpwd; CString strctno; CString strapno; // 비밀번호 // 종합계좌대체번호 // 계좌상품번호 < 생략 > /********************************************** 개발편의를위한 GetTranOutputData 메소드 MFC 소스템플릿 O U T - P U T **********************************************/ int nrow = 0; < 생략 > 페이지 30 / 103

31 5.2. FID조회정보리소스파일 FID조회란? 서비스단위의고정된데이터블록으로데이터를주고받는 Tran조회와다르게, FID조회는응답받을데이터유형을구분하는 GID와일부필수입력 FID항목만입력형식에맞춰주면, 자유롭게응답항목을구성하여원하는데이터를요청 / 응답받을수있다 FID조회정보리소스파일구조고정된크기의데이터블록을사용하는 Tran조회 / 실시간처리와는다르게 FID조회는고정된정보가필요하지않아입출력정보리소스파일을별도관리하지않는다. Open API 개발자는응답데이터유형별 GID와항목별 FID번호가이드문서를참고개발을진행하면된다. 페이지 31 / 103

32 5.3. 실시간 I/O정보리소스파일 실시간등록 / 해제 실시간데이터를서버로부터수신받기위해서는실시간서비스코드 (ex:"s00") 와리얼등록키 (ex:"000660" 종목코드 ) 로서버에등록요청을해야하며, 등록요청이완료된시점부터실시간데이터를수신받게된다. 실시간데이터수신을해제하기위해서는실시간등록시점에입력했던실시간서비스코드와리얼등록키로서버에등록해제요청한다 실시간데이터블록리소스파일구조예시 (/RealRes/*.res) BEGIN_FUNCTION_MAP REAL_TYPE=20, REAL_NAME=S00, DESCRIPTION= 주식체결 ; BEGIN_DATA_MAP begin SEQ=0, TYPE=string, SIZE=9, KEY=1, ITEM=SHRN_ISCD, CAPTION= 종목코드, FID=0; SEQ=1, TYPE=string, SIZE=8, KEY=0, ITEM=BSOP_DATE, CAPTION= 실시간일자, FID=0; SEQ=2, TYPE=string, SIZE=6, KEY=0, ITEM=STCK_CNTG_HOUR, CAPTION= 체결시간, FID=0; SEQ=3, TYPE=string, SIZE=1, KEY=0, ITEM=HOUR_CLS_CODE, CAPTION= 시간구분코드, FID=0; SEQ=4, TYPE=string, SIZE=1, KEY=0, ITEM=ANTC_NMIX_CLS_CODE, CAPTION= 예상지수구분코드, < 생략 > SEQ=42, TYPE=string, SIZE=18, KEY=0, ITEM=RLTV, CAPTION= 체결강도, FID=0; SEQ=43, TYPE=string, SIZE=1, KEY=0, ITEM=RLTV_CLR, CAPTION=[RLTV] 색참조 (+ 상승,-하락), FID=0; SEQ=44, TYPE=string, SIZE=12, KEY=0, ITEM=SELN_CNTG_CSNU, CAPTION= 매도체결건수, FID=0; SEQ=45, TYPE=string, SIZE=12, KEY=0, ITEM=SHNU_CNTG_CSNU, CAPTION= 매수체결건수, FID=0; end END_DATA_MAP END_FUNCTION_MAP REAL_NAME : 실시간코드명 ( 실시간등록 / 해제시에필요 ) SEQ : 각항목들의순서인덱스번호 TYPE: 항목값의데이터유형 SIZE: 항목값의 BYTE 크기 ITEM : 블록을구성하는항목명 페이지 32 / 103

33 리소스파일하단에보면다음과같이소스템플릿이생성되어있다. API 개발자는필요하면해당소스를복사 & 붙여넣기하여사용하면된다. /********************************************** 개발편의를위한 GetRealOutputData 메소드 MFC 소스템플릿 **********************************************/ CString strshrn_iscd = m_commagent.getrealoutputdata("s00", "SHRN_ISCD"); // 종목코드 < 생략 > /********************************************** 개발편의를위한벡터 MFC 소스템플릿 ( 벡터는 C++ 에서만사용가능 ) **********************************************/ CHARVECTOR realcommvector; m_commagent.getcommrealvectorptr((long)&realcommvector); < 생략 > 페이지 33 / 103

34 6. 통신조회예제 6.1. Tran조회 1. Open API 에이전트컨트롤 Tran 조회예시 CHFCommAgent m_commagent; //Open Agent control 선언 Int m_nrqid; //Request ID 2. Tran조회요청 ( 구현파일 ) CString strtrcode = "TESTTRQ00"; //Tran코드( 리소스파일참고 ) CString strinrecname = "TESTTRQ00_in "; // 입력레코드명 ( 리소스파일참고 ) CString stritem1 = "PRDT_CD"; // 상품코드항목명 ( 리소스파일참고 ) CString stritem2 = "ORDR_DT"; CString strvalue1 = " "; CString strvalue2 = " "; // 주문일자항목명 // 종목코드값 // 주문일자값 //[1] Request ID 생성 m_nrqid = m_commagent.createrequestid(); //[2] Tran 조회입력값을입력한다. m_commagent.settraninputdata(m_nrqid, strtrcode, strinrecname, stritem1, strvalue1); m_commagent.settraninputdata(m_nrqid, strtrcode, strinrecname, stritem2, strvalue2); CString strbenefitacc = "N"; // 수익증권계좌구분 CString strprenext = "1"; // 연속조회 ("0"- 일반, "1"- 연속조회첫조회, "2"- 이전조회, "3"- 다음조회 ) CString strscreenno = "9999"; // 화면번호 Int nrequestdatacnt = 0; // 응답데이터건수 (0 으로입력하면 Default 응답건수가입력된다. //[3] 서버에 Tran 조회요청한다. m_commagent.requesttran(m_nrqid, strtrcode, strbenefitacc, strprenext, strscreenno, 0); 3. Tran조회응답이벤트 ( 구현파일 ) 이벤트콜백함수원형 : void OnGetTranData(LONG nrequestid, LPCTSTR pblock, long nblocklength) // 연속조회 (0 : 연속조회미사용, 1 : 이전데이터있음, 2 : 다음데이터있음, 3 : 이전 / 다음데이터있음 ) CString strprenext = m_commagent.getcommrecvoptionvalue(commrecvopt::prevnextcode); // 연속조회키 CString strprenextcontext = m_commagent.getcommrecvoptionvalue(commrecvopt::prevnextkey); // 조회응답메시지코드 페이지 34 / 103

35 CString strmsgcode // 조회응답메시지 CString strmsg // 조회응답부가메시지코드 CString strsubmsgcode // 조회응답부가메시지 CString strsubmsg = m_commagent.getcommrecvoptionvalue(commrecvopt::msgcode); = m_commagent.getcommrecvoptionvalue(commrecvopt::msg); = m_commagent.getcommrecvoptionvalue(commrecvopt::submsgcode); = m_commagent.getcommrecvoptionvalue(commrecvopt::submsg); if(nrequestid == m_nrqid) { CString strtrcode = "TESTTRQ00"; //Tran코드( 리소스파일참고 ) CString stroutrecname = "TESTTRQ00_out "; // 출력레코드명 ( 리소스파일참고 ) CString stritem1 = "ORDR_SN"; // 주문일련번호항목명 ( 리소스파일참고 ) CString stritem2 = " OR_ORDR_SN "; // 원주문일련번호항목명 ( 리소스파일참고 ) // 조회응답데이터건수 int ndatacnt = m_commagent.gettranoutputrowcnt(strtrcode, stroutrecname); int nrow = 0; // 응답데이터건수만큼반복, 항목별데이터값을추출한다. for(int i = 0; i < ndatacnt; i++) { nrow = i; // 주문일련번호데이터값추출 CString strvalue1 = m_commagent.gettranoutputdata(strtrcode, stroutrecname, stritem1, nrow); // 원주문일련번호데이터값추출 CString strvalue2 = m_commagent.gettranoutputdata(strtrcode, stroutrecname, stritem2, nrow); } } // 사용이끝난 RQ ID 는반드시 0 으로초기화 m_nrqid =.0; 페이지 35 / 103

36 6.2. FID 단건조회 ( 응답데이터가단건 ) Open API 에이전트컨트롤 FID 단건조회예시 1. Open API 에이전트컨트롤선언 ( 헤더파일 ) CHFCommAgent m_commagent; //Open Agent control 선언 Int m_nrqid; //Request ID 2. 조회요청 ( 구현파일 ) //[1] Request ID 생성 m_nrqid = m_commagent.createrequestid(); m_commagent.settraninputdata(m_nrqid, strtrcode, strinrecname, stritem1, strvalue1); m_commagent.settraninputdata(m_nrqid, strtrcode, strinrecname, stritem2, strvalue2); CString strmarketcode; strmarketcode = "J"; // 시장구분 //[2] FID 조회입력값을입력한다. m_commagent.setfidinputdata(m_nrqid, "9002", "000660");// 종목코드 m_commagent. SetFidInputData (m_nrqid, "9001", strmarketcode); // 시장구분 m_commagent. SetFidInputData (m_nrqid, "GID", "1000");// 응답데이터유형을결정하는 GID CString stroutputfidlist; // 서버에서응답으로받을 FID 항목들을콤마로구분변수에저장 // 시간 (8), 체결가 (4) stroutputfidlist = "8,4"; CString strscreenno; strscreenno = "9999"; CString strscreenno = "9999"; //[3] 서버에 FID 조회 ( 응답데이터가단건 ) 요청한다. m_commagent. RequestFidArray(m_nRqId, stroutputfidlist, strscreenno); 3. FID 조회단건응답이벤트 ( 구현파일 ) 이벤트콜백함수원형 : void OnGetFidData(LONG nrequestid, LPCTSTR pblock, long nblocklength) // 연속조회 (0 : 연속조회미사용, 1 : 이전데이터있음, 2 : 다음데이터있음 3 : 이전 / 다음데이터있음 ) CString strprenext = m_commagent.getcommrecvoptionvalue(commrecvopt::prevnextcode); // 연속조회키 CString strprenextcontext = m_commagent.getcommrecvoptionvalue(commrecvopt::prevnextkey); // 조회응답메시지코드 CString strmsgcode = m_commagent.getcommrecvoptionvalue(commrecvopt::msgcode); // 조회응답메시지 CString strmsg = m_commagent.getcommrecvoptionvalue(commrecvopt::msg); // 조회응답부가메시지코드 CString strsubmsgcode = m_commagent.getcommrecvoptionvalue(commrecvopt::submsgcode); // 조회응답부가메시지 CString strsubmsg = m_commagent.getcommrecvoptionvalue(commrecvopt::submsg); 페이지 36 / 103

37 if(nrequestid == m_nrqid) { // 조회응답데이터건수 int ndatacnt = m_commagent.getfidoutputrowcnt(nrequestid); /********************************************************************** 방법 1 - GetFidOutputData 메소드로항목별값추출 **********************************************************************/ // 시간데이터값추출 CString strtime = m_commagent.getfidoutputdata(nrequestid, "8", nrow); // 체결가데이터값추출 CString strprice = m_commagent.getfidoutputdata(nrequestid, "4", nrow); /********************************************************************** 방법 2-2 차원벡터인덱스접근으로데이터가저오는방식 (C++ 에서만사용가능하다 ) **********************************************************************/ CHARVECTOR2 fidcommvvector; int nvecrowcnt = 0; // 데이터건수 ( 행 ) int nveccolcnt = 0; // 데이터항목건수 ( 열 ) //FID 조회응답데이터인덱싱이중벡터 (C++ 에서만사용가능 ) if (m_commagent.getcommfidvvectorptr( (long) &fidcommvvector ) == TRUE) { nvecrowcnt = fidcommvvector.size(); // 데이터건수 ( 행 ) nveccolcnt = fidcommvvector[0].size(); // 데이터항목건수 ( 열 ) } ndatacnt = nvecrowcnt; int nindex = 0; // 시간데이터값추출 FID : 8 CString strtime = fidcommvvector[nindex][0]; // 체결가데이터값추출 FID : 4 CString strprice = fidcommvvector[nindex][1]; } // 사용이끝난 RQ ID 는반드시 0 으로초기화 m_nrqid =.0; 페이지 37 / 103

38 6.3. FID 복수건조회 ( 응답데이터가복수건 ) Open API 에이전트컨트롤 FID 복수건조회예시 1. Open API 에이전트컨트롤선언 ( 헤더파일 ) CHFCommAgent m_commagent; //Open Agent control 선언 Int m_nrqid; //Request ID CString m_strprenextkey; // 연속조회키 ( 이전 / 다음조회시사용 ) 2. 조회요청 ( 구현파일 ) //[1] Request ID 생성 m_nrqid = m_commagent.createrequestid(); m_commagent.settraninputdata(m_nrqid, strtrcode, strinrecname, stritem1, strvalue1); m_commagent.settraninputdata(m_nrqid, strtrcode, strinrecname, stritem2, strvalue2); CString strmarketcode; strmarketcode = "J"; // 시장구분 //[2] FID 조회입력값을입력한다. m_commagent.setfidinputdata(m_nrqid, "9002", "000660"); // 종목코드 m_commagent. SetFidInputData (m_nrqid, "9001", strmarketcode); // 시장구분 m_commagent. SetFidInputData (m_nrqid, "GID", "1001"); // 응답데이터유형을결정하는 GID CString stroutputfidlist; // 서버에서응답으로받을 FID 항목들을콤마로구분변수에저장 // 시간 (8), 체결가 (4) stroutputfidlist = "8,4"; CString strscreenno; strscreenno = "9999"; // 연속조회옵션 : '0': 미사용, '1' 사용, '2' : 이전데이터조회, '3' : 다음데이터조회 CString strprenext = "1"; CString strscreenno = "9999"; int nrequestcnt = 0; // 응답데이터건수설정 (0 입력시 Default 건수가입력된다.) //[3] 서버에 FID 조회 ( 응답데이터가복수건 ) 요청한다. m_commagent. RequestFidArray(m_nRqId, stroutputfidlist, strprenext, m_strprenextkey, strscreenno, nrequestcnt); 3. FID 조회복수건응답이벤트 ( 구현파일 ) 이벤트콜백함수원형 : void OnGetFidData(LONG nrequestid, LPCTSTR pblock, long nblocklength) // 연속조회 (0 : 연속조회미사용, 1 : 이전데이터있음, 2 : 다음데이터있음 3 : 이전 / 다음데이터있음 ) CString strprenext = m_commagent.getcommrecvoptionvalue(commrecvopt::prevnextcode); // 연속조회키 CString strprenextcontext = m_commagent.getcommrecvoptionvalue(commrecvopt::prevnextkey); // 조회응답메시지코드 CString strmsgcode = m_commagent.getcommrecvoptionvalue(commrecvopt::msgcode); // 조회응답메시지 CString strmsg = m_commagent.getcommrecvoptionvalue(commrecvopt::msg); // 조회응답부가메시지코드 CString strsubmsgcode = m_commagent.getcommrecvoptionvalue(commrecvopt::submsgcode); // 조회응답부가메시지 페이지 38 / 103

39 CString strsubmsg = m_commagent.getcommrecvoptionvalue(commrecvopt::submsg); if(nrequestid == m_nrqid) { // 이전 / 다음데이터조회시, 사용하기위해연속키를저정해놓는다. m_strprenextkey = strprenextcontext; // 조회응답데이터건수 int ndatacnt = m_commagent.getfidoutputrowcnt(nrequestid); int nrow = 0; /********************************************************************** 방법 1 - GetFidOutputData 메소드로항목별값추출 **********************************************************************/ // 응답데이터건수만큼반복, 항목별데이터값을추출한다. for(int i = 0; i < ndatacnt; i++) { nrow = i; // 시간데이터값추출 CString strtime = m_commagent.getfidoutputdata(nrequestid, "8", nrow); } // 체결가데이터값추출 CString strprice = m_commagent.getfidoutputdata(nrequestid, "4", nrow); /********************************************************************** 방법 2 - 메모리인덱스접근으로데이터가저오는방식 (C++ 에서만사용가능하다 ) **********************************************************************/ CCommRecvData fidcommrecvdata; int nvecrowcnt = 0; // 데이터건수 ( 행 ) int nveccolcnt = 0; // 데이터항목건수 ( 열 ) //FID 조회응답데이터브럭포인터 (C++ 에서만사용가능 ) if (m_commagent.getcommfiddatablock((long) &fidcommrecvdata) == TRUE) { nvecrowcnt = fidcommrecvdata.getrowcnt(); // 데이터건수 ( 행 ) nveccolcnt = fidcommrecvdata.getcolcnt(); // 데이터항목건수 ( 열 ) } ndatacnt = nvecrowcnt; int nindex = 0; for (int i = 0; i < ndatacnt; i++) { nindex = i; // 시간데이터값추출 FID : 8 CString strtime = fidcommrecvdata.getitem(nindex, 0); } // 체결가데이터값추출 FID : 4 CString strprice = fidcommrecvdata.getitem(nindex, 0); } // 사용이끝난 RQ ID는반드시 0으로초기화 m_nrqid =.0; 페이지 39 / 103

40 7. 실시간등록 / 해제예제 7.1. 실시간등록 1. Open API 에이전트컨트롤실시간등록 / 해제예시 CHFCommAgent m_commagent; //Open Agent control 선언 2. 실시간등록요청 ( 구현파일 ) // 실시간리소스파일을로드한다.( 리소스파일로드는한번만호출하면된다.) if (!m_commagent.loadrealresource(strapidagentmodulepath + "RealRes/S00.res")) ::AfxMessageBox(m_CommAgent.GetLastErrMsg()); CString strrealname = "S01"; // 실시간코드명 ( 주식체결 ) CString strrealkey = "000660"; // 리얼등록키 ( 종목코드등 ) // 실시간등록 m_commagent.registerreal(strrealname, strrealkey); 3. 실시간데이터수신이벤트 ( 구현파일 ) 원형 : void OnGetRealData(LPCTSTR strrealname, LPCTSTR strrealkey, LPCTSTR pblock, long nblocklength); if (!_tcscmp(strrealname, "S00")) { /********************************************************************** 방법 1 - GetRealOutputData 메소드로항목별값추출 **********************************************************************/ // 항목명으로현재가값추출 CString strcurprice = m_commagent.getrealoutputdata(strrealname, "STCK_PRPR"); // 항목명으로부호값추출 CString strdiffsign = m_commagent. GetRealOutputData (strrealname, "PRDY_VRSS_SIGN"); /********************************************************************** 방법 2 - 메모리인덱스접근으로데이터가저오는방식 (C++ 에서만사용가능하다 ) **********************************************************************/ CCommRecvData realcommrecvdata; int nitemcnt = 0; } if(m_commagent. GetCommRealRecvDataBlock ( (long)& realcommrecvdata) == TRUE) nitemcnt = realcommrecvdata.getcolcnt(); // 항목건수 if(nitemcnt > 0) { //S00.res 파일의 SEQ필드의번호로벡터인덱스로사용한다. // 현재가 CString strcurprice = realcommrecvdata.getitem(0, 0); // 부호 CString strdiffsign = realcommrecvdata.getitem(0, 1); } 3. 실시간등록해제요청 ( 구현파일 ) CString strrealname = "S01"; // 실시간코드명 ( 주식체결 ) CString strrealkey = "000660"; // 리얼등록키 ( 종목코드등 ) //SK 하이닉스 (000660) 종목의주식체결실시간등록해제 m_commagent.unregisterreal(strrealname, strrealkey); //Open API 에이전트컨트롤에등록된모든실시간등록을해제할때 페이지 40 / 103

41 m_commagent.allunregisterreal(); 8. FID 통신전문가이드 8.1. FID 입력조건시장분류코드 시장명 시장코드 시장명 시장코드 시장명 시장코드 주식 J 주식선물 JF Eurex EU ELW W 주식옵션 JO FX 마진 FX 지수선물 F 야간선물 CM 업종 U 지수옵션 O 해외선물 FF 8.2. 투자정보 FID 투자정보공통입력 (Input) FID FID FID 한글명 FID FID 한글명 FID FID 한글명 9000 입력시장구분코드 9035 입력날짜 입력델타 입력조건시장분류코드 9036 입력시간 입력델타 입력종목코드 입력시간 입력세타 입력종목코드 입력가격 입력세타 입력종목코드 입력가격 입력레버리지값 입력기초자산종목코드 9040 입력가격 입력레버리지값 입력파생단축종목코드 9041 입력가격 입력내재변동성 입력가격구분코드 9042 입력지수가격 입력내재변동성 입력시간구분코드 9043 입력지수가격 입력주식전환비율 입력시간정렬구분코드 9044 입력등락율 입력주식전환비율 입력장운영구분코드 9045 입력등락율 입력잔존일수 입력일 / 주 / 월 / 년 9046 입력거래량 입력잔존일수 입력과거데이터포함여부 9047 입력거래량 입력만기수 9013 입력허봉여부 9048 입력거래량 입력 LP 만기수 9014 입력수정주가 / 원주가 9049 입력거래량 입력 LP 비중수 9015 입력옵션 9050 입력수 입력 CD 금리 9016 입력선택여부 9051 입력수 입력배당수익율 9017 입력소속구분코드 9052 입력수 입력역사적변동성 9018 입력구간구분코드 9053 입력수 입력입력만기년월 9019 입력분류구분코드 9054 입력옵션 입력입력일련번호 9020 입력대상구분코드 9055 입력옵션 입력뉴스제공업체코드 9021 입력대상제외구분코드 9056 입력행사가 입력타이틀 입력사유구분코드 9057 입력행사가 입력타이틀 입력제외구분코드 9058 입력자본지지점 입력타이틀 3 페이지 41 / 103

42 9024 입력기타구분코드 9059 입력자본지지점 입력내용 9025 입력투자유의구분코드 9060 입력패리티 입력검색명 9026 입력투자자구분코드 9061 입력패리티 입력사용자 ID 9027 입력순위정렬구분코드 입력 E 기어링값 입력업종코드 9028 입력순위정렬구분코드 입력 E 기어링값 입력일자구분코드 9029 입력 N 전월 9064 입력손익분기비율 입력현재가 입력 N 전일 9065 입력손익분기비율 입력현재가 입력조건화면분류코드 9066 입력프리미엄값 입력액면가 입력조건누적분류코드 9067 입력프리미엄값 입력액면가 입력조건시장구분코드 9068 입력기어링 입력시가총액 입력날짜 입력기어링 입력시가총액 2 FID FID 한글명 FID FID 한글명 FID FID 한글명 9108 입력거래대금 이동평균구분 9178 입력상장일자 입력거래대금 상품구분코드 9179 입력상장일자 입력고저구분코드 입력투자의견구분코드 9180 입력최종거래일자 입력고저구분코드 N 일역사적변동성 9181 입력최종거래일자 입력고저구분코드 입력섹터그룹코드 9182 입력발행가격 입력고저구분코드 입력주식구분코드 9183 입력발행가격 입력순매수매도구분코드 9149 입력섹터그룹구분코드 9184 입력상장주수 입력회원사구분코드 9150 입력 EFP/FLEX 구분코드 9185 입력상장주수 입력 ETF 구분코드 9151 입력뉴스원구분코드 9186 입력사유구분코드 입력회원사종목코드 9152 입력뉴스페이지구분코드 9187 입력조기종료평가여부 9118 입력투자자상품코드 9153 입력뉴스 KEY 9188 입력전일구분코드 9119 입력 X 틱분틱일별구분코드 9154 입력장마감여부 9189 입력주주구분코드 9120 입력신고저가구분코드 9155 입력프로그램매매 9190 입력채권구분코드 9121 입력운용사구분코드 9156 입력전일거래량대비 9191 입력결산구분코드 9122 입력비율 9157 입력통합구분코드 9192 입력재무구분코드 9123 입력종목검색코드 9158 입력공통사항등락률구분 9193 입력 LP 보유비율 입력예상대비구분코드 9159 입력사용자설정코드 9194 입력전일거래량 9125 입력예상체결가구분코드 9160 입력해외지수구분코드 9195 입력소매채권종류구분코드 9126 입력예상체결량구분코드 9161 입력 RS_KEY 코드 9196 입력 N 일후 9127 입력예상체결등락율 입력거래량 입력사유구분코드 입력예상체결등락율 입력고저구분코드 입력채권투자기간 9129 입력신용구분코드 9164 입력갭구분코드 9199 입력이자종류 9130 입력등락구분코드 9165 입력발행시장코드 9200 입력표면금리 9131 입력권리유형구분코드 9166 입력증권그룹구분코드 9201 입력신용등급 9132 입력금액거래량구분코드 9167 입력체결강도구분코드 9202 입력해당일전체표시여부 9133 입력월물구분코드 9168 입력 N 일역사적변동성 입력해외증시구분코드 9134 입력유효값구분코드 9169 입력전일대비율 입력돌파구분코드 페이지 42 / 103

43 9135 입력외국계여부구분코드 9170 입력전일대비율 입력고저구분코드 입력잔고기준구분코드 9171 입력거래량 매트릭스기간 9137 입력상하한가포함여부 9172 입력이론가 입력임의종목명여부 9138 입력차트여부 9173 입력이론가 일별시간별구분코드 9139 ATM 구분코드 9174 입력 LP 보유비율 수량 / 비율구분코드 9140 기준시간사용여부 9175 입력 LP 보유비율 입력 N 전일구분코드 9141 N 분전 9176 입력 LP 종료날짜 입력조회기간여부 9142 골든데드크로스구분 9177 입력 LP 종료날짜 입력연결구분코드 FID FID 한글명 FID FID 한글명 FID FID 한글명 9217 입력탭구분코드 9224 입력종목코드 입력증권그룹구분코드 입력 VI 적용구분코드 9234 입력 VI 종류코드 9235 입력연속횟수 9236 입력증거금구분코드 9237 입력기초자산국내외코드 9238 입력 ETF/ETN 구분코드 9239 대상증거금구분코드 9240 입력 NAV 입력 NAV 입력괴리율 입력괴리율 입력괴리율 입력괴리율 입력추적오차율 입력추적오차율 입력전일과표기준가격 입력전일과표기준가격 입력추적지수 입력추적지수 입력추적수익률배수 입력추적수익률배수 2 페이지 43 / 103

44 출력 GID 1000 기본시세 ( 단건응답 -single) FID FID 한글명 FID FID 한글명 FID FID 한글명 1 종목코드 34 매도호가 6 68 매도호가잔량 6 2 표준종목코드 35 매도호가 7 69 매도호가잔량 7 3 한글종목명 36 매도호가 8 70 매도호가잔량 8 4 현재가 37 매도호가 9 71 매도호가잔량 9 5 전일대비 38 매도호가 매도호가잔량 10 6 전일대비부호 39 매수호가 1 73 매수호가잔량 1 7 전일대비율 40 매수호가 2 74 매수호가잔량 2 8 시간 41 매수호가 3 74 매수호가잔량 3 9 일자 42 매수호가 4 76 매수호가잔량 4 10 전일종가 43 매수호가 5 77 매수호가잔량 5 11 누적거래량 44 매수호가 6 78 매수호가잔량 6 12 누적거래대금 45 매수호가 7 79 매수호가잔량 7 13 시가 46 매수호가 8 80 매수호가잔량 8 14 고가 47 매수호가 9 81 매수호가잔량 9 15 저가 48 매수호가 매수호가잔량 기준가 주최고가 83 체결량 17 상한가 주최고가일자 89 총매도수량 1 18 하한가 주최저가 104 총매수수량 1 19 시가총액 주최저가일자 115 최고가시간 21 외인보유비율 53 액면가 116 최저가시간 22 외국인한도수량 54 대용가 117 상승종목수 23 외국인보유수량 55 상장주수 118 하락종목수 24 외국인주문가능수량 56 자본금 119 보합종목수 26 외국인소진율 57 결산월 120 상한종목수 28 전일거래량 58 전일대비거래량비율 121 하한종목수 29 매도호가 1 63 매도호가잔량 상장종목수 30 매도호가 2 64 매도호가잔량 상장회사수 31 매도호가 3 65 매도호가잔량 거래량비중 32 매도호가 4 66 매도호가잔량 미결제약정수량 33 매도호가 5 67 매도호가잔량 서킷브레이커적용상한가 페이지 44 / 103

45 FID FID 한글명 FID FID 한글명 FID FID 한글명 127 서킷브레이커적용하한가 178 시가대비기준가비율 220 투자자기관계전일순매수수량 128 상장중고가 181 고가대비기준가비율 221 투자자외국인전일순매수수량 129 상장중저가 184 저가대비기준가비율 222 당사신용비율 130 상장중고가일자 185 예상체결가 223 체결강도 131 상장중저가일자 186 예상체결대비 224 NAV 전일대비율 132 최종거래일자 187 예상체결대비부호 225 결산월 133 잔존일수 188 예상체결전일대비율 226 상장일자 148 수익비율 189 예상체결량 227 미결제약정수량증감 149 거래형성종목수 190 PER 228 기초자산단축종목코드 150 환산현재가 191 EPS 229 기초자산현재가 151 매도호가잔량증감 외국인계순매수거래대금 230 기초자산전일대비 152 매도호가잔량증감 기관순매수거래대금 231 기초자산전일대비부호 153 매도호가잔량증감 총매도호가건수 261 순매수호가잔량 154 매도호가잔량증감 총매수호가건수 262 최근월물의제약정가격 155 매도호가잔량증감 매도호가건수 기초자산누적거래량 156 매도호가잔량증감 매도호가건수 이론가 157 매도호가잔량증감 매도호가건수 괴리율 158 매도호가잔량증감 매도호가건수 이론베이시스 159 매도호가잔량증감 매도호가건수 시장베이시스 160 매도호가잔량증감 매수호가건수 기준가대비시가비율 161 매수호가잔량증감 매수호가건수 기준가대비고가비율 162 매수호가잔량증감 매수호가건수 기준가대비저가비율 163 매수호가잔량증감 매수호가건수 괴리도 164 매수호가잔량증감 매수호가건수 피벗 2 차디저항 165 매수호가잔량증감 주최고가대비현재가비율 273 피벗 1 차디저항 166 매수호가잔량증감 주최저가대비현재가비율 274 피벗포인트 167 매수호가잔량증감 연중최고가 275 피벗 1 차디지지 168 매수호가잔량증감 연중최고가일자 276 피벗 2 차디지지 169 매수호가잔량증감 연중최저가 278 총매도호가잔량증감 170 매수호가잔량증감 연중최저가일자 279 총매수호가잔량증감 171 총매도호가잔량 215 연중최고가대비현재가비율 296 디저항 172 총매수호가잔량 216 연중최저가대비현재가비율 297 디지지 173 시간외총매도호가잔량 217 가중평균가 298 디마크포인트 174 시간외총매수호가잔량 218 시가대비등락율비율 299 거래량회전율 175 순매수호가잔량 219 시가시간 300 CD 금리 페이지 45 / 103

46 FID FID 한글명 FID FID 한글명 FID FID 한글명 301 델타 540 전일종가대비시가 577 ETF 기초자산전일대비부호 302 감마 541 전일종가대비최고가 578 ETF 기초자산전일대비율 303 세타 542 전일종가대비최저가 일이동평균가격 304 베가 543 추적오차율 일이동평균가격 305 로우 544 ETF 기초자산현재가 일이격도 306 대표업종한글종목명 545 거래대금회전율 일이격도 327 예상거래량 546 전일최종 NAV 일이격도 328 예상거래대금 547 피벗 3 차디저항 일거래량이동평균 329 최대내재변동성 548 피벗 3 차지지 일거래량이동평균 330 총매도회원사수량 549 디마크디저항 일거래량이동평균 331 총매수회원사수량 550 디마크디지지 일거래량이동평균 374 기초자산시가 551 LP 매도호가잔량 레버리지 375 기초자산고가 552 LP 매도호가잔량 K.O 접근도 376 기초자산저가 553 LP 매도호가잔량 행사가 378 장운영구분코드 554 LP 매도호가잔량 패리티 379 NAV 555 LP 매도호가잔량 기어링 380 NAV 전일대비 556 LP 매도호가잔량 자본지지점 381 NAV 전일대비부호 557 LP 매도호가잔량 스프레드 383 합산거래량 558 LP 매도호가잔량 차근월물스프레드대비 384 합산거래대금 559 LP 매도호가잔량 차근월물스프레드대비 398 외국계순매수수량 560 LP 매도호가잔량 차근월물스프레드대비 413 외국인계순매수수량 561 LP 매수호가잔량 예상매도호가 종목변동성 562 LP 매수호가잔량 예상매수호가 업종변동성 563 LP 매수호가잔량 행사기간종료일자 500 내재가치 564 LP 매수호가잔량 결제일자 507 외국인순매수수량 565 LP 매수호가잔량 신용잔고율 520 ETF 설정 CU 566 LP 매수호가잔량 신용융자공여율 529 외국인한도비율 567 LP 매수호가잔량 신용융자잔고율 533 과세유형 568 LP 매수호가잔량 시간외단일가현재가 534 ETF 구성종목수 569 LP 매수호가잔량 시간외단일가전일대비 535 ETF 순자산총액 570 LP 매수호가잔량 시간외단일가전일대비부호 일이동평균가격 571 LP 총매도호가잔량 728 시간외단일가거래량 일이동평균가격 572 LP 총매수호가잔량 729 시간외단일가거래대금 일이동평균가격 575 ETF 기초자산종목명 730 시간외단일가상한가 일이동평균가격 576 ETF 기초자산전일대비 731 시간외단일가하한가 페이지 46 / 103

47 FID FID 한글명 FID FID 한글명 FID FID 한글명 732 시간외단일가시가 797 시간외단일가총매도호가잔량 918 매도호가건수 시간외단일가최고가 798 시간외단일가총매수호가잔량 919 매도호가건수 시간외단일가최저가 799 시간외단일가총매도호가잔량증감 920 매도호가건수 시간외단일가매도호가증감 시간외단일가총매수호가잔량증감 921 매수호가건수 시간외단일가매도호가증감 시간외단일가체결량 922 매수호가건수 시간외단일가매도호가증감 시간외단일가전일대비율 923 매수호가건수 시간외단일가매도호가증감 시간가치 924 매수호가건수 시간외단일가매도호가증감 상장중최고가대비현재가비율 925 매수호가건수 시간외단일가매수호가증감 상장중최저가대비현재가비율 926 연누적거래량 746 시간외단일가매수호가증감 매수잔량비율 927 연누적거래대금 747 시간외단일가매수호가증감 PBR 928 공모가격 748 시간외단일가매수호가증감 PCR 값 929 벤처기업구분 749 시간외단일가매수호가증감 BPS 930 발행회사명 755 시간외단일가매도호가잔량 현재내재변동성 937 기업구분 756 시간외단일가매도호가잔량 시간외단일가전일거래량 938 매매개시일 757 시간외단일가매도호가잔량 역사적변동성 939 투자유의내용 758 시간외단일가매도호가잔량 연속상승일수 940 불성실공시사유 759 시간외단일가매도호가잔량 일최고가대비현재가비율 941 외부감사의견 765 시간외단일가매수호가잔량 일최고가대비현재가비율 942 외부감사적정성 766 시간외단일가매수호가잔량 주당순이익비율 947 전일가중평균가격 767 시간외단일가매수호가잔량 증권종류 950 주식전환비율 768 시간외단일가매수호가잔량 존립개시일자 951 행사기간개시일자 769 시간외단일가매수호가잔량 발행가격 952 LP 회원사명 775 시간외단일가매도호가 매도체결량합계 953 LP 보유수량 776 시간외단일가매도호가 매수체결량합계 954 현재가 시간외단일가매도호가 거래급등율 958 LP 보유비율 778 시간외단일가매도호가 신장운영구분코드 961 기초자산매도호가 779 시간외단일가매도호가 ETF 선물괴리율 962 기초자산매수호가 785 시간외단일가매수호가 ETF 선물괴리도 963 N 일역사적변동성 786 시간외단일가매수호가 ETFKOSPI200 괴리율 964 확정지급가격 787 시간외단일가매수호가 ETFKOSPI200 괴리도 965 손익분기비율 788 시간외단일가매수호가 ETFNAV 괴리율 966 환산가 789 시간외단일가매수호가 ETFNAV 괴리도 968 기초자산종목명 795 시간외총매도호가증감 916 매도호가건수 기초자산전일대비율 796 시간외총매수호가증감 917 매도호가건수 ELW 조기종료발생기준가격 페이지 47 / 103

48 FID FID 한글명 FID FID 한글명 FID FID 한글명 972 ETF 분류명 1117 현재가대비고가 1217 기초자산종목코드 ETFCU 단위증권수 1118 현재가대비저가 1218 기초자산종목코드 ETF 배당주기월 1119 현재가대비시가부호 1219 기초자산종목코드 ETF 지수대비율 1120 현재가대비고가부호 1220 기초자산구성비율 전일대비거래량증감 1121 현재가대비저가부호 1221 기초자산구성비율 전일거래대금 1122 현재가대비시가비율 1222 기초자산구성비율 프리미엄 1123 현재가대비고가비율 1223 기초자산구성비율 ELW 지급일자 1124 현재가대비저가비율 1224 기초자산구성비율 만기일자 1125 현재가대비상한가 1225 ELW 기초자산기초가격 982 LP 주문가능여부 1126 현재가대비하한가 1226 LP 종료일자 984 전일대비거래량 1127 상한가대비율 1227 ELW 권리형태 일미결제증감 1128 하한가대비율 1228 가격상승률 990 권리행사명 1129 상하한등락폭 1229 ELW 조기종료권리행사내용 991 권리유형명 1130 상하한등락율 1230 ELW 조기종료평가가격방식 992 결제방법명 1133 연속상승일수 1233 시간구분코드 993 보상율 1134 연속하락일수 일역사적변동성 994 만기평가내용 1150 내재가치대비 일역사적변동성 995 만기권리행사내용 1151 시간가치대비 일역사적변동성 996 LP 매도량 1163 현재투자의견 일역사적변동성 1000 선물최근월물현재가 1165 투자의견증권사명 1244 투자심리도 1001 선물최근월물대비 1166 목표주가 1245 VR 1002 선물최근월물대비부호 1169 데이터코드 1246 삼선전환도 1003 선물최근원물거래량 1170 국가구분코드 1251 시장경고구분코드 1007 기초자산종목코드 1171 통화코드 1252 불성실공시여부 1008 LP 회원사명 한국날짜 1253 거래정지여부 1009 LP 회원사명 한국시간 1254 정리매매여부 1010 LP 회원사명 업종지수현재가 1255 액면가변경구분코드 1011 LP 회원사명 시장구분명 1256 락구분코드 1012 LP 회원사명 일역사적변동성 1257 KOSPI200 채용구분코드 주최저가대비최고가비율 일역사적변동성 1258 관리종목여부 1022 연중최저가대비최고가비율 일역사적변동성 1259 임의종료가능여부 1024 E 기어링 일역사적변동성 1260 배분적용구분코드 1096 지정신청사명 일역사적변동성 1261 배분처리구분코드 1098 전일대비부호 일역사적변동성 1262 주가탄력 1116 현재가대비시가 1216 기초자산종목코드 관리종목명 페이지 48 / 103

49 FID FID 한글명 FID FID 한글명 FID FID 한글명 1268 통화코드 1357 시간외하락종목수 1562 이자종류명 1272 배당액지수미래가치 1358 시간외하한종목수 1563 상장가 1273 선물최근월물대비율 1361 KOSPI50 종목여부 1564 이자구분명 1276 전일미결제약정수량 1362 KRX 정보통신여부 1565 이자결정방법 1305 뉴욕현재일자 1365 총합산거래대금 일 MA 대비율 1306 뉴욕현재시간 1367 ELW 총합산거래대금 1567 전일동시간거래량대비율 1307 시카고현재일자 1368 전일시가 1568 표면금리 1308 시카고현재시간 1369 전일고가 1569 만기보장수익률 1309 런던현재일자 1370 전일저가 1570 전환청구장소 1310 런던현재시간 일이격도 1571 전환가액 1311 홍콩현재일자 1395 LP 호가스프레드 1572 주간사 1312 홍콩현재시간 1396 틱 Value 1573 보증기관 1313 대만현재일자 1414 날짜 현재가대비가중평균가 1314 대만현재시간 1415 날짜 현재가대비가중평균가비율 1315 시간외단일전일종가 1416 조기종료평가종료일 주최고가대비현재가 1316 시간외단일가최종시간 1417 평가기간최고가 주최저가대비현재가 1318 시간외단일가예상체결가 1418 평가기간최저가 일전평균가 1319 시간외단일가예상거래량 1423 조기종료 ELW 평가완료여부 1579 현재가대비 5 일전평균가 1320 시간외단일가예상체결량 1452 환율지수 1580 현재가대비 5 일전평균가비율 1321 시간외단일가예상체결대비 1469 만기잔존일수 1581 거치기간일자 1322 시간외단일가예상체결대비부호 1470 이전만기일수 1582 분할상환횟수 1323 시간외단일가예상체결전일대비율 1483 조기종료발생일자 1583 배당기산일 1324 시간외단일가예상체결직전가 1484 조기종료발생시간 1584 전환주식종목코드 1334 전일시가총액 1485 조기종료평가종료시간 1585 전환청구개시일 1335 OBV 1493 조기종료평가가격 1586 전환청구종료일 1336 예상지수 1494 바스켓구분코드 1587 매출일자 1337 예상전일대비 1495 조기종료발생여부코드 1588 상장여부명 1338 예상전일대비부호 1496 결산년월 1589 채권구분 1339 예상전일대비율 1514 매출액증가율 1590 채권보증구분코드 1346 ELW 합산거래량 1515 순이익증가율 1591 소매채권구분코드 1347 ELW 합산거래대금 1526 부채비율 1592 만기상환비율 1351 원월물의제약정가격 1536 배당수익율 1593 분할상환구분코드 1354 시간외상승종목수 1537 목적표준종목코드 1594 스크립트구분코드 1355 시간외상한종목수 1560 발행일 1595 거래정지사유코드 1356 시간외보합종목수 1561 상환일 1596 선매출이자지급방법 페이지 49 / 103

50 FID FID 한글명 FID FID 한글명 FID FID 한글명 1597 하이브리드채권여부 1692 시간외단일가상승종목수 2163 장종료후시간외바스켓거래량 1598 이자원단위미만처리구분코드 1693 시간외단일가보합종목수 2174 투자자외국인 5 일간순매수수량 1599 직전이자지급일자 1694 시간외단일가하락종목수 2175 투자자기관계 5 일간순매수수량 1600 차기이자지급일자 1695 시간외단일가하한종목수 2176 기초자산기준가대비시가비율 1602 이자지급계산월수 1700 매매단위 2177 기초자산기준가대비고가비율 1603 소매채권분류코드 일이동평균가격 2178 기초자산기준가대비저가비율 1604 채권거래정지구분코드 1724 삼선전환도 2179 ELW 지급 2 대리인명 1605 결산년월 호가접수시간 2180 LP 호가내재변동성 1616 잔존년월일 1761 ISIN_CODE 2184 기준가대비시가 1636 시가수익률 1772 거래단위 2185 기준가대비시가부호 1637 고가수익률 1773 거래승수 2186 기준가대비고가 1638 저가수익률 1780 전일조정종가 2187 기준가대비고가부호 1639 기초자산배당수익비율 1870 시작시간 2188 기준가대비저가 1640 전일수익률 1871 끝시간 2189 기준가대비저가부호 1641 기초자산종목수 1893 증권그룹구분코드 2234 전일종가대비시가부호 1642 지수채권순가격 1940 ETF 복제방법구분코드 2235 ETN 구성종목수 1643 지수채권시장가격 1941 ETF 상품유형코드 2236 LP 최소호가수량 1644 지수채권 CALL 재투자지수 1987 거래소코드 2238 추적수익률배수 1645 듀레이션 2006 정규장매매수량단위 2239 시간외단일가기준가대비시가비율 1646 YTM 2015 전일과표기준가격 2240 시간외단일가기준가대비고가비율 1648 ELW 지급일자 2016 전일배당전과표기준가격 2241 시간외단일가기준가대비저가비율 1653 ETF 시가총액합계 2017 전일현금배당금액 2294 존립종료일자 1654 상환가격 2072 시간외단일가기준가 2295 호가단위 1659 상승비중 2124 매수체결량비중 2298 지수명 1662 기초자산전일거래량 2128 지정자문사명 2299 손익분기점 1664 매도호가수익률 주최고가대비현재가부호 2300 실시간상한가 1665 매수호가수익률 주최저가대비현재가부호 2301 실시간하한가 1667 예상내재변동성 2155 장중거래량 2378 목적표준종목명 1675 지수종목코드 2156 장개시전시간외종가거래량 2379 매매방식명 1678 전전일대비율 2157 장종료후시간외종가거래량 2454 상장중최고가대비현재가 1682 단기과열종목구분코드 2158 장중대량거래량 2455 상장중최저가대비현재가 1687 원금지금기관 2159 장개시전시간외대량거래량 2456 가격소수점 1688 등록기관 2160 장종료후시간외대량거래량 2457 진법 1689 이자월말구분 2161 장중바스켓거래량 2460 상품별증거금 1691 시간외단일가상한종목수 2162 장개시전시간외바스켓거래량 2462 정산가 페이지 50 / 103

51 FID FID 한글명 FID FID 한글명 FID FID 한글명 2466 스프레드부호 2566 연중최저가일자누적거래량 2467 거래대상구분 2567 현재가대비 52 주최고가 2468 PIP 가치 2568 현재가대비 52 주최고가부호 2469 종목그룹 주최고가일자누적거래량 2484 전전일대비 2570 현재가대비 52 주최저가 2485 전전일대비부호 2571 현재가대비 52 주최저가부호 2486 시작시간 주최저가일자누적거래량 2487 끝시간 시가총액규모구분코드 2502 ETF 기초자산종목코드 2575 환율지수대비 2503 ETF 기초자산괴리도 2576 환율지수대비부호 2504 ETF 기초자산괴리율 2577 환율지수대비율 2505 ETF 최근월물괴리도 2578 환산현재가대비 2506 ETF 최근월물괴리율 2579 환산현재가대비부호 2507 NAV 기초자산괴리도 2580 환산현재가대비율 2508 NAV 기초자산괴리율 2585 국가구분명 2509 NAV 최근월물괴리도 2586 원유로환율지수 2510 NAV 최근월물괴리율 2587 원엔환율지수 2548 현재가대비전일종가 2549 현재가대비전일종가부호 2550 현재가대비전일종가대비율 일전종가 2552 현재가대비 5 일전종가 2553 현재가대비 5 일전종가부호 2554 현재가대비 5 일전종가대비율 일전누적거래량 일전종가 2557 현재가대비 20 일전종가 2558 현재가대비 20 일전종가부호 2559 현재가대비 20 일전종가대비율 일전누적거래량 2561 현재가대비연중최고가 2562 현재가대비연중최고가부호 2563 연중최고가일자누적거래량 2564 현재가대비연중최저가 2565 현재가대비연중최저가부호 페이지 51 / 103

52 출력 GID 1001 기본당일체결 ( 복수건응답 - array) FID FID 한글명 FID FID 한글명 FID FID 한글명 1 종목코드 303 세타 3 한글종목명 304 베가 4 현재가 305 로우 5 전일대비 383 합산거래량 6 전일대비부호 500 내재가치 7 전일대비율 659 레버리지 8 시간 662 패리티 9 일자 664 기어링 10 전일종가 665 자본지지점 11 누적거래량 803 시간가치 12 누적거래대금 819 현재내재변동성 13 시가 825 역사적변동성 14 고가 862 매도체결량합계 15 저가 863 매수체결량합계 29 매도호가 손익분기비율 39 매수호가 매수체결량 63 매도호가잔량 매도체결량 73 매수호가잔량 직전체결구분코드 83 체결량 1215 체결구분코드 117 상승종목수 1233 시간구분코드 118 하락종목수 1276 전일미결제약정수량 119 보합종목수 1642 지수채권순가격 120 상한종목수 1643 지수채권시장가격 121 하한종목수 1644 지수채권 CALL 재투자지수 125 미결제약정수량 1645 듀레이션 171 총매도호가잔량 1646 YTM 172 총매수호가잔량 1681 건별거래량 223 체결강도 2292 매도건수 227 미결제약정수량증감 2293 매수건수 229 기초자산현재가 2465 누적거래량증감 262 최근월물의제약정가격 264 이론가 267 시장베이시스 301 델타 302 감마 페이지 52 / 103

53 FID FID 한글명 FID FID 한글명 FID FID 한글명 4 현재가 2609 해외종목코드 5 전일대비 6 전일대비부호 7 전일대비율 8 시간 9 일자 10 전일종가 11 누적거래량 13 시가 14 고가 15 저가 29 매도호가 1 30 매도호가 2 31 매도호가 3 32 매도호가 4 33 매도호가 5 39 매수호가 1 40 매수호가 2 41 매수호가 3 42 매수호가 4 43 매수호가 5 83 체결량 125 미결제약정수량 223 체결강도 227 미결제약정수량증감 666 스프레드 1098 전일대비부호 한국날짜 1174 한국시간 1215 체결구분코드 1220 기초자산구성비율 기초자산구성비율 건별거래량 2466 스프레드부호 2468 PIP 가치 페이지 53 / 103

54 출력 GID 1003 기본디스크체결 ( 복수건응답 - array) FID FID 한글명 FID FID 한글명 FID FID 한글명 4 현재가 2609 해외종목코드 5 전일대비 6 전일대비부호 7 전일대비율 8 시간 9 일자 10 전일종가 11 누적거래량 13 시가 14 고가 15 저가 29 매도호가 1 30 매도호가 2 31 매도호가 3 32 매도호가 4 33 매도호가 5 39 매수호가 1 40 매수호가 2 41 매수호가 3 42 매수호가 4 43 매수호가 5 83 체결량 125 미결제약정수량 223 체결강도 227 미결제약정수량증감 666 스프레드 1098 전일대비부호 한국날짜 1174 한국시간 1215 체결구분코드 1220 기초자산구성비율 기초자산구성비율 건별거래량 2466 스프레드부호 2468 PIP 가치 페이지 54 / 103

55 출력 GID 5000 관심종목 ( 복수건응답 - array) FID FID 한글명 FID FID 한글명 FID FID 한글명 1 종목코드 187 예상체결대비부호 1368 전일시가 3 한글종목명 188 예상체결전일대비율 1369 전일고가 4 현재가 189 예상체결량 1370 전일저가 5 전일대비 224 NAV 전일대비율 일이격도 6 전일대비부호 227 미결제약정수량증감 1462 KRW 기준 7 전일대비율 264 이론가 2466 스프레드부호 8 시간 265 괴리율 2468 PIP 가치 9 일자 266 이론베이시스 10 전일종가 267 시장베이시스 11 누적거래량 271 괴리도 12 누적거래대금 300 CD 금리 13 시가 306 대표업종한글종목명 14 고가 327 예상거래량 15 저가 379 NAV 16 기준가 380 NAV 전일대비 17 상한가 381 NAV 전일대비부호 18 하한가 666 스프레드 28 전일거래량 차근월물스프레드대비 29 매도호가 차근월물스프레드대비 39 매수호가 차근월물스프레드대비 54 대용가 725 시간외단일가현재가 83 체결량 726 시간외단일가전일대비 117 상승종목수 727 시간외단일가전일대비부호 118 하락종목수 728 시간외단일가거래량 119 보합종목수 775 시간외단일가매도호가 상한종목수 785 시간외단일가매수호가 하한종목수 802 시간외단일가전일대비율 122 상장종목수 819 현재내재변동성 125 미결제약정수량 일역사적변동성 133 잔존일수 일역사적변동성 149 거래형성종목수 1272 배당액지수미래가치 171 총매도호가잔량 1336 예상지수 172 총매수호가잔량 1337 예상전일대비 185 예상체결가 1338 예상전일대비부호 186 예상체결대비 1339 예상전일대비율 페이지 55 / 103

56 8.3. 기타 FID 조회 지수 FID 조회 ( 실시간 : U00.res) <Input> ( 시장구분 ) : U ( 종목코드 ) : 001(KOSPI 종합 ) / 101(KOSPI 200) / 201(KOSDAQ 종합 ) ( 기준일자 ) : ex) GID : 1007 <Output - 단건출력 > - 4( 현재가 ), 5( 전일대비 ), 7( 전일대비율 ), 11( 누적거래량 ), 28( 전일거래량 ), 12( 누적거래대금 ), 977( 전일거래대금 ) 외국계거래원순매수 / 매도상위 /********************************** * FID 입력항목 **********************************/ m_commagent.setfidinputdata(m_nrqid, "9117", "000"); // 입력회원사종목코드 (000: 전체 ) m_commagent.setfidinputdata(m_nrqid, "9034", " "); // 입력날짜 1( 조회시작일 ) m_commagent.setfidinputdata(m_nrqid, "9035", " "); // 입력날짜 2( 조회마지막일 ) m_commagent.setfidinputdata(m_nrqid, "9027", "107"); // 입력순위정렬구분코드 1(107: 순매금액, 108: 순매도금액, 26: 순매수량, 27: 순매수량 ) m_commagent.setfidinputdata(m_nrqid, "GID", "2112"); /********************************** * FID 출력항목 **********************************/ /* 종목명 (2639), 종목코드 (1), 순매수금액 (377), 순매도금액 (407), 매수금액 (406), 매도금액 (405), 순매수량 (404), 매수량 (403), 매도량 (402), 순매도량 (874), 종가 (4), 대비부호 (6), 대비 (5), 등락률 (7), 거래량 (11) */ // 금액또는수량등원하는기준으로출력 FID 항목을만든다. CString stroutputfidlist = "2639,1,377,406,405,4,6,5,7,11"; // 순매수금액으로조회시출력항목들 CString stroutputfidlist = "2639,1,407,406,405,4,6,5,7,11"; // 순매도금액으로조회시출력항목들 CString stroutputfidlist = "2639,1,404,403,402,4,6,5,7,11"; // 순매수수량으로조회시출력항목들 CString stroutputfidlist = "2639,1,874,403,402,4,6,5,7,11"; // 순매도수량으로조회시출력항목들 페이지 56 / 103

57 8.4. 종목리스트 ( 마스터 ) FID 주식종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( J : 주식 ) GID 1199 < OUTPUT FID - array> 0002 : 표준종목코드 0001 : 단축코드 0003 : 한글종목명 0827 : 시장구분 ( 1: KOSPI, 4: KOSDAQ, A: ETN ) 1893 : 증권그룹구분코드 2574 : 시가총액규모구분코드 /* 제외종목 : 0 */ /* 코스피 1: 대형주, 2: 중형주, 3: 소형주 */ /* 코스닥 4: KOSDAQ100 5:KOSDAQmid300 6:KOSDAQsmall */ 1993 : 지수업종대분류코드 1994 : 지수업종중분류코드 1995 : 지수업종소분류코드 2604 : 제조업구분코드 (Y: 해당 N: 비해당 ) => mnin_cls_code 2605 : 배당지수종목여부 ( Y, N ) => dvdn_nmix_issu_yn 2606 : 지배구조우수구분 ( Y,N ) => sprn_strr_sprr_yn 1257 : KOSPI200 구분 /* 0: 업종미분류 1: 건설 2: 중공업 3: 철강소재 */ /* 4: 에너지화학 5: 정보통신 6: 금융 7: 필수소비재 */ /* 8: 자유소비재 9: 산업재 A: 건강관리 */ 1998 : KOSPI100,50 구분 /* 1:KOSPI100, 2:KOSPI50 */ 2607 : 벤처기업여부 Y,N => sprn_strr_nmix_issu_yn 1996 : KRX100 종목여부 0225 : 결산월 0053 : 주식액면가 0016 : 주식기준가 0056 : 자본금 0055 : 상장주수 2067 : 배당수익율 0684 : 신용잔고비율 1253 : 거래정지여부 (N: 정상, Y: 거래정지 ) 1254 : 정리매매여부 (N: 정상, Y: 정리매매 ) 1258 : 관리종목여부 (N: 정상, Y: 관리종목 ) 1251 : 시장경고구분코드 /* 00: 정상 01: 주의 02: 경고 03: 위험 */ 2608 : 시장경고예고구분코드 Y,N => mrkt_alrm_risk_adnt_yn 1252 : 불성실공시지정여부 Y,N 1992 : 우회상장구분 Y,N 1256 : 락구분코드 /* 00: 해당없음 01: 권리락 02: 배당락 */ /* 03: 분배락 04: 권배락 05: 중간배당락 */ /* 06: 권리중간배당락 99: 기타 */ 0222 : 당사신용비율 2129 : 고위험종목구분값 1: 해당 0: 비해당 2148 : Equity Rating 정보 A,B,C,D,F 비산출 X 0019 : 시가총액 ( 억 ) 0021 : 외국인보유비율 1896 : 우선주구분코드 (0: 보통주, 그외 : 우선주 ) /* 0: 해당없음 ( 보통주 ) */ /* 1: 구형우선주 */ /* 2: 신형우선주 */ /* 9: 종류주권 */ /* ST 에만해당 */ 페이지 57 / 103

58 업종종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( U : 업종 ) GID 1298 < OUTPUT FID - array> 0001 : 업종코드 0003 : 한글업종명 ELW 종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( W : ELW ) GID 1399 < OUTPUT FID - array> 0001 : 단축코드 0003 : 한글종목명 1877 : 기초자산코드 : 기초자산코드 : 기초자산코드 : 기초자산코드 : 기초자산코드 : 발행사한글종목명 2614 : 발행사코드 0661 : 행사가 0132 : 최종거래일 0133 : 잔존일수 2615 : 권리유형구분코드 /* 'C': 콜 'E': 기타 'P': 풋 */ 0002 : 표준코드 2616 : ELW 권리형태 /* 0 : 표준옵션 */ /* 1 : 디지털옵현 */ /* 2: 조기종료옵션 */ 1226 : LP 종료일자 지수선물종목리스트 < INPUT FID > 9001 : 시장구분코드 ( F : 지수선물, KF : 미니선물 ) GID 1499 < OUTPUT FID - array> 0001 : 단축코드 0002 : 표준종목코드 0003 : 한글종목명 0016 : 기준가 2624 : 실시간가격제한여부 지수옵션종목리스트 < INPUT FID > 9001 : 시장구분코드 ( O : 지수옵션, KO : 미니옵션 ) GID 1899 < OUTPUT FID - array> 0001 : 단축코드 0002 : 표준코드 0003 : 한글종목명 1373 : ATM 구분코드 ( 1:ATM 2:ITM 3:OTM ) 페이지 58 / 103

59 1773 : 거래승수 2624 : 실시간가격제한여부 1770 : ( 월물구분 ) 2295 : ( 호가단위 ) 주식선물종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( JF : 주식선물 ) GID 1499 < OUTPUT FID - array> 0001 : 단축코드 0002 : 표준종목코드 0003 : 한글종목명 1373 : ATM 구분코드 ( 1:ATM 2:ITM 3:OTM ) 1877 : 기초자산코드 1773 : 거래승수 0016 : 기준가 2624 : 실시간가격제한여부 주식옵션종목리스트 FID <INPUT FID> 9001 : 시장구분코드 ( JO : 주식옵션 ) GID : 1899 <OUTPUT FID - array> 0001 : 단축코드 0002 : 표준코드 0968 : 기초자산명 0003 : 한글종목명 1449 : 콜풋구분 ( 2: 콜, 3: 풋 ) 1203 : 만기년월 0661 : 행사가 1373 : ATM 구분코드 ( 1:ATM 2:ITM 3:OTM ) 1773 : 거래승수 2624 : 실시간가격제한여부 야간선물종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( CM : 야간선물 ) GID 1499 < OUTPUT FID - array> 0001 : 단축코드 0002 : 표준종목코드 0003 : 한글종목명 0016 : 기준가 2624 : 실시간가격제한여부 페이지 59 / 103

60 해외선물종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( FF : 해외선물 ) GID 3299 < OUTPUT FID - array> 0001 : 종목코드 ( 내부 ) 0002 : 시세종목코드 0003 : 해외파생상품명 1448 : 품목코드 2083 : 해외파생품목명 0661 : 행사가격 1170 : 국가코드 1987 : 거래소코드 2467 : 품목유형구분명 2456 : 가격소수점정보 2457 : 진법 2295 : Tick Size 1396 : 최소가격변동금액 1773 : 환산승수 1772 : 계약단위, 계약크기 1731 : 위탁증거금 2460 : 유지증거금 0226 : 상장일자 0132 : 최종거래일 (LTD) 0981 : 만기일자 (Expire Date) 1203 : 만기년월 (Expire Month/Year) 1268 : 결제통화 ( 거래통화?) 1171 : 표시통화 2459 : 근월물순서 0133 : 잔존일수 1759 : Active Flag 0016 : 기준가 0010 : 전일종가 0028 : 전일거래량 1762 : 거래가능여부 1870 : 시작시간 1871 : 종료시간 2486 : 장시작시간 ( 한국 ) 2487 : 장종료시간 ( 한국 ) 0815 : 직전거래일 0009 : 현영업일, 거래일자 0128 : 상장후고가 0129 : 상장후저가 페이지 60 / 103

61 EUREX 종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( EU : EUREX ) GID 1899 < OUTPUT FID - array> 0001 : 단축코드 0002 : 표준코드 0003 : 한글종목명 1373 : ATM 구분코드 ( 1:ATM 2:ITM 3:OTM ) 1773 : 거래승수 2624 : 실시간가격제한여부 FX 마진종목리스트 FID < INPUT FID > 9001 : 시장구분코드 ( FX : FX 마진 ) GID 4199 < OUTPUT FID - array> HTS CODE 통화 통화 Quote Mode 가격소수점 가격소수점보정 고객소수점 고객소수점보정 딜링룸코드 PL 계산통화 PL 계산방법 Pair ID FCM_CD FX 상품명 매입이자율 매도이자율 FDM 매입이자율 FDM 매도이자율 페이지 61 / 103

62 8.5. 차트 FID 주식시장차트 FID 1. 틱차트 FID( 주식시장 ) <INPUT FID> 9001 : 시장구분코드 ( J : 주식 ) 9002 : 종목코드 9008 : 시간구분코드 ( 4 : 장중 ) 9034 : 입력일자 : 입력일자2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 2. N틱차트 FID( 주식시장 ) <INPUT FID> 9001 : 시장구분코드 ( J : 주식 ) 9002 : 종목코드 9008 : 시간구분코드 ( 4 : 장중 ) 9119 : 입력틱구분코드 ( N : N틱 ) 9034 : 입력일자 : 입력일자2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 페이지 62 / 103

63 3. 분차트 FID( 주식시장 ) <INPUT FID> 9001 : 시장구분코드 ( J : 주식 ) 9002 : 종목코드 9119 : 입력분틱구분코드 ( 30: 30초, 60: 1분, 600: 10분, 3600: 60분, 60N: N분 ) 9034 : 입력일자 : 입력일자2 GID : 1005 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 4. 일차트 FID( 주식시장 ) <INPUT FID> 9001 : 시장구분코드 ( J : 주식 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1007 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 5. 주 / 월차트 ( 주식시장 ) <INPUT FID> 9001 : 시장구분코드 ( J : 주식 ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( W : 주, M : 월 ) 9034 : 입력일자 : 입력일자 2 GID : 1009 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 페이지 63 / 103

64 ELW 시장차트 FID 1. 틱차트 FID(ELW 시장 ) <INPUT FID> 9001 : 시장구분코드 ( W : ELW ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 2. N 틱차트 FID(ELW 시장 ) <INPUT FID> 9001 : 시장구분코드 ( W : ELW ) 9002 : 종목코드 9119 : 입력틱구분코드 ( N : N 틱 ) 9034 : 입력일자 : 입력일자 2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 3. 분차트 FID(ELW 시장 ) <INPUT FID> 9001 : 시장구분코드 ( W : ELW ) 9002 : 종목코드 9119 : 입력분틱구분코드 ( 30: 30 초, 60: 1 분, 600: 10 분, 3600: 60 분, 60N: N 분 ) 9034 : 입력일자 : 입력일자 2 GID : 1005 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 페이지 64 / 103

65 4. 일차트 FID(ELW 시장 ) <INPUT FID> 9001 : 시장구분코드 ( W : ELW ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1007 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 5. 주 / 월차트 FID(ELW 시장 ) <INPUT FID> 9001 : 시장구분코드 ( W : ELW ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( W : 주, M : 월 ) 9034 : 입력일자 : 입력일자 2 GID : 1009 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 페이지 65 / 103

66 선물시장차트 FID 1. 틱차트 FID( 선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( F : 지수선물, JF : 주식선물, CM : 야간선물 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 2. N 틱차트 FID( 선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( F : 지수선물, JF : 주식선물, CM : 야간선물 ) 9002 : 종목코드 9119 : 입력틱구분코드 ( N : N 틱 ) 9034 : 입력일자 : 입력일자 2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 3. 분차트 FID( 선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( F : 지수선물, JF : 주식선물, CM : 야간선물 ) 9002 : 종목코드 9119 : 입력분틱구분코드 ( 30: 30 초, 60: 1 분, 600: 10 분, 3600: 60 분, 60N: N 분 ) 9034 : 입력일자 : 입력일자 2 GID : 1005 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 페이지 66 / 103

67 4. 일차트 FID( 선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( F : 지수선물, JF : 주식선물, CM : 야간선물 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1007 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 5. 주 / 월차트 FID( 선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( F : 지수선물, JF : 주식선물, CM : 야간선물 ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( W : 주, M : 월 ) 9034 : 입력일자 : 입력일자 : 입력일자 2 GID : 1009 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 페이지 67 / 103

68 옵션시장차트 FID 1. 틱차트 FID( 옵션시장 ) <INPUT FID> 9001 : 시장구분코드 ( O : 지수옵션, JO : 주식옵션, EU : 야간옵션 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 2. N 틱차트 FID( 옵션시장 ) <INPUT FID> 9001 : 시장구분코드 ( O : 지수옵션, JO : 주식옵션, EU : 야간옵션 ) 9002 : 종목코드 9119 : 입력틱구분코드 ( N : N 틱 ) 9034 : 입력일자 : 입력일자 2 GID : 1002 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 3. 분차트 FID( 옵션시장 ) <INPUT FID> 9001 : 시장구분코드 ( O : 지수옵션, JO : 주식옵션, EU : 야간옵션 ) 9002 : 종목코드 9119 : 입력분틱구분코드 ( 30: 30 초, 60: 1 분, 600: 10 분, 3600: 60 분, 60N: N 분 ) 9034 : 입력일자 : 입력일자 2 GID : 1005 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 페이지 68 / 103

69 4. 일차트 FID( 옵션시장 ) <INPUT FID> 9001 : 시장구분코드 ( O : 지수옵션, JO : 주식옵션, EU : 야간옵션 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1007 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 5. 주 / 월차트 FID( 옵션시장 ) <INPUT FID> 9001 : 시장구분코드 ( O : 지수옵션, JO : 주식옵션, EU : 야간옵션 ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( W : 주, M : 월 ) 9034 : 입력일자 : 입력일자 2 GID : 1009 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 페이지 69 / 103

70 해외선물시장차트 FID 1. 틱차트 FID( 해외선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( FF : 해외선물 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1003 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 2. N 틱차트 FID( 해외선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( FF : 해외선물 ) 9002 : 종목코드 9119 : 입력틱구분코드 ( N : N 틱 ) 9034 : 입력일자 : 입력일자 2 GID : 1003 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 3. 분차트 FID( 해외선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( FF : 해외선물 ) 9002 : 종목코드 9119 : 입력분틱구분코드 ( 30: 30 초, 60: 1 분, 600: 10 분, 3600: 60 분, 60N: N 분 ) 9034 : 입력일자 : 입력일자 2 GID : 1006 <OUTPUT FID - array> 0009 : 일자 0008 : 시간 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0083 : 체결량 0011 : 거래량 페이지 70 / 103

71 4. 일차트 FID( 해외선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( FF : 해외선물 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1008 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 5. 주차트 FID( 해외선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( FF : 해외선물 ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( W : 주 ) 9034 : 입력일자 : 입력일자 2 GID : 1009 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 6. 월차트 FID( 해외선물시장 ) <INPUT FID> 9001 : 시장구분코드 ( FF : 해외선물 ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( M : 월 ) 9034 : 입력일자 : 입력일자 2 GID : 1010 <OUTPUT FID - array> 0009 : 일자 0004 : 종가 0013 : 시가 0014 : 고가 0015 : 저가 0011 : 거래량 페이지 71 / 103

72 FX 마진시장차트 FID 1. 틱차트 FID(FX 마진시장 ) <INPUT FID> 9001 : 시장구분코드 ( FX : FX 마진 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1003 <OUTPUT FID - array> 시간 일자 매도시가 매도고가 매도저가 매도종가 전일대비부호 ( 실제필드명 : 매수부호 ) 매수시가 매수고가 매수저가 매수종가 매도부호 스프레드 2. N 틱차트 FID(FX 마진시장 ) <INPUT FID> 9001 : 시장구분코드 ( FX : FX 마진 ) 9002 : 종목코드 9119 : 입력틱구분코드 ( N : N 틱 ) 9034 : 입력일자 : 입력일자 2 GID : 1003 <OUTPUT FID - array> 시간 일자 매도시가 매도고가 매도저가 매도종가 전일대비부호 ( 실제필드명 : 매수부호 ) 매수시가 매수고가 매수저가 매수종가 매도부호 스프레드 페이지 72 / 103

73 3. 분차트 FID(FX 마진시장 ) <INPUT FID> 9001 : 시장구분코드 ( FX : FX 마진 ) 9002 : 종목코드 9119 : 입력분틱구분코드 ( 30: 30 초, 60: 1 분, 600: 10 분, 3600: 60 분, 60N: N 분 ) 9034 : 입력일자 : 입력일자 2 GID : 1006 <OUTPUT FID - array> 시간 일자 매도시가 매도고가 매도저가 매도종가 전일대비부호 ( 실제필드명 : 매수부호 ) 매수시가 매수고가 매수저가 매수종가 매도부호 스프레드 4. 일차트 FID(FX 마진시장 ) <INPUT FID> 9001 : 시장구분코드 ( FX : FX 마진 ) 9002 : 종목코드 9034 : 입력일자 : 입력일자 2 GID : 1008 <OUTPUT FID - array> 시간 일자 매도시가 매도고가 매도저가 매도종가 전일대비부호 ( 실제필드명 : 매수부호 ) 매수시가 매수고가 매수저가 매수종가 매도부호 스프레드 페이지 73 / 103

74 5. 주차트 FID(FX 마진시장 ) <INPUT FID> 9001 : 시장구분코드 ( FX : FX 마진 ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( W : 주 ) 9034 : 입력일자 : 입력일자 2 GID : 1009 <OUTPUT FID - array> 시간 일자 매도시가 매도고가 매도저가 매도종가 전일대비부호 ( 실제필드명 : 매수부호 ) 매수시가 매수고가 매수저가 매수종가 매도부호 스프레드 6. 월차트 FID(FX 마진시장 ) <INPUT FID> 9001 : 시장구분코드 ( FX : FX 마진 ) 9002 : 종목코드 9011 : 주 / 월구분코드 ( M : 월 ) 9034 : 입력일자 : 입력일자 2 GID : 1010 <OUTPUT FID - array> 시간 일자 매도시가 매도고가 매도저가 매도종가 전일대비부호 ( 실제필드명 : 매수부호 ) 매수시가 매수고가 매수저가 매수종가 매도부호 스프레드 페이지 74 / 103

75 9. Tran / 실시간리소스파일분류및설명 9.1. Tran 리소스파일분류및설명 (/TranRes/*.res) 파일명 서비스코드 설명 비고 OTS5991Q03.res OTS5991Q03 해외모의보유계좌조회 해외모의보유계좌 HHTACCNM01.res HHTACCNM01 계좌목록조회 ( 설정 )-실거래서버 실거래서버계좌목록 OTS1111U10.res OTS1111U10 매도 주식주문 OTS1111U20.res OTS1111U20 매수 주식주문 OTS1111U30.res OTS1111U30 정정 주식주문 OTS1111U40.res OTS1111U40 취소 주식주문 OTS2100U10.res OTS2100U10 매도 국내파생선옵주문 OTS2100U20.res OTS2100U20 매수 국내파생선옵주문 OTS2100U30.res OTS2100U30 정정 국내파생선옵주문 OTS2100U40.res OTS2100U40 취소 국내파생선옵주문 OTS5901U01.res OTS5901U01 매도 / 매수 해외선물주문 OTS5901U02.res OTS5901U02 정정 해외선물주문 OTS5901U03.res OTS5901U03 취소 해외선물주문 OTS5901U31.res OTS5901U31 매도 / 매수 FX마진주문 OTS5901U32.res OTS5901U32 정정 FX마진주문 OTS5901U33.res OTS5901U33 취소 FX마진주문 OTS2850U30.res OTS2850U30 매도 / 매수 야간선물주문 OTS2850U32.res OTS2850U32 정정 야간선물주문 OTS2850U33.res OTS2850U33 취소 야간선물주문 OTS5911Q41.res OTS5911Q41 미체결내역 해외선물 OTS5911Q52.res OTS5911Q52 체결내역 해외선물 OTS5921Q41.res OTS5921Q41 전체 ( 미체결 / 체결 ) 내역 해외선물 OTS5943Q01.res OTS5943Q01 예수금내역 해외선물 OTS5919Q41.res OTS5919Q41 잔고내역 해외선물 OTS2850Q82.res OTS2850Q82 잔고내역 국내파생선옵 OTS2850Q81.res OTS2850Q81 예수금내역 국내파생선옵 OTS2850Q80.res OTS2850Q80 주문 ( 미체결 / 체결 ) 내역 국내파생선옵 OTS2850Q18.res OTS2850Q18 잔고내역 야간선물 OTS2850Q17.res OTS2850Q17 예수금내역 야간선물 OTS2850Q12.res OTS2850Q12 주문체결내역 야간선물 OTS5919Q51.res OTS5919Q51 잔고내역 FX마진 OTS5913Q53.res OTS5913Q53 미체결내역 FX마진 OTS5913Q52.res OTS5913Q52 체결내역 FX마진 OTS5914Q51.res OTS5914Q51 예수금내역 FX마진 OTS1240Q41.res OTS1240Q41 주문 ( 미체결 / 체결 ) 내역 주식 OTS1841Q00.res OTS1841Q00 예수금 / 잔고내역 주식 Tran 리소파일을열어하단을보면, OpenAPI사용자의개발편의를위한템플릿소스가생성되어있다. 필요 한경우템플릿소스를복사 & 붙여넣기로사용하면된다. 페이지 75 / 103

76 9.2. 실시간리소스파일분류및설명 (/RealRes/*.res) 파일명 실시간코드명 설명 비고 S00.res S00 주식체결 시세정보 S01.res S01 주식호가 시세정보 U00.res U00 업종체결 시세정보 F00.res F00 선물체결 시세정보 F01.res F01 선물호가 시세정보 O00.res O00 지수옵션체결 시세정보 O01.res O01 지수옵션호가 시세정보 F40.res F40 CME선물체결 시세정보 F41.res F41 CME선물호가 시세정보 O30.res O30 Eurex옵션체결 시세정보 O31.res O31 Eurex옵션호가 시세정보 V00.res V00 FX마진호가 시세정보 V10.res V10 해외선물체결 시세정보 V11.res V11 해외선물호가 시세정보 IS0.res IS0 주식주문확인 / 체결 / 미체결 ( 정정 / 취소 ) 주식주문통보 IF0.res IF0 선옵주문확인 / 체결 / 미체결 ( 정정 / 취소 ) 국내파생주문통보 EF1.res EF1 해외선물체결 해외선물주문통보 EF4.res EF4 해외선물미체결 ( 정정 / 취소 ) 해외선물주문통보 FX0.res FX0 미체결 / 체결 FX마진주문통보 EF5.res EF5 야간선물주문확인 / 체결 / 미체결 ( 정정 / 취소 ) 야간선물주문통보 F90.res F90 미니선물체결 미니선물체결 F91.res F91 미니선물호가 미니선물호가 O90.res O90 미니옵션체결 미니옵션체결 O91.res O91 미니옵션호가 미니옵션호가 실시간리소파일을열어하단을보면, OpenAPI사용자의개발편의를위한템플릿소스가생성되어있다. 필 요한경우템플릿소스를복사 & 붙여넣기로사용하면된다. 페이지 76 / 103

77 주문 / 주문체결 / 잔고 Tran I/O 설명 9.3. 해외선물주문 해외선물주문 I/O - 일반주문 ( 매수 / 매도 ) - OTS5901U01.res 입력항목입력설명필수옵션값소수점비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 PWD 비밀번호 PRDT_CD 상품코드 SELL_BUY_DCD 매도매수구분코드 S: 매도, B: 매수 PRC_CND_DCD 가격조건구분코드 1: 지정가, 2: 시장가, 3:STOPMARKET ODRV_ORDR_PRC 해외파생주문가격 8 ORDR_QNT 주문수량 STLS_APPN_PRC 스탑로스지정가격 8 * 가격조건구분코드 '3' 일때만입력 ORDR_HND_DCD 주문조작구분코드 C: 일반주문, M: 반대매매, F: 강제청산, D:FND 반대매매 기본값 'C' ORDR_DCD 주문구분코드 O: 자동청산, C: 지정청산기본값 'O' ETC_ORDR_DCD 기타주문구분코드 CNCS_CND_DCD 체결조건구분코드 1:FAS(DAY), 6:GTD 기본값 "1" CLR_PST_NO ORDR_EXPR_DT 출력항목 ODRV_ODNO 청산포지션번호 주문만료일자 출력설명 해외파생주문번호 해외선물주문 I/O - 정정주문 - OTS5901U02.res 입력항목입력설명필수옵션값소수점비고 ODRV_OR_ODNO 해외파생원주문번호 CTNO 종합계좌대체번호 APNO 계좌상품번호 PWD 비밀번호 PRDT_CD 상품코드 PRC_CND_DCD 가격조건구분코드 1: 지정가, 2: 시장가, 3:STOPMARKET ODRV_RVSE_PRC 해외파생정정가격 8 RVSE_QNT 정정수량 STLS_APPN_PRC 스탑로스지정가격 8 RMN_QNT_YN 출력항목 ODRV_ODNO 잔여수량여부 출력설명 해외파생주문번호 해외선물주문 I/O - 취소주문 - OTS5901U03.res * 가격조건구분코드 '3' 일때만입력 입력항목입력설명팔수옵션값소수점기본 ( 고정 ) 값 페이지 77 / 103

78 ODRV_OR_ODNO 해외파생원주문번호 CTNO 종합계좌대체번호 APNO 계좌상품번호 PWD 비밀번호 PRDT_CD 상품코드 CNCL_QNT 취소수량 ODRV_RMN_QNT_DVSN 출력항목 ODRV_ODNO 해외파생잔여수량구분 출력설명 해외파생주문번호 페이지 78 / 103

79 9.4. 국내지수 / 주식선물옵션주문 국내지수 / 주식선물옵션주문 I/O - 매도주문 - OTS2100U10.res 입력항목 입력설명 필수 옵션값 비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 ACNT_PWD 계좌비밀번호 SELL_BUY_DCD 매도매수구분코드 1: 매도 * 기본값 '1' PRDT_CD 상품코드 DRVS_NMPR_DCD 파생상품호가구분코드 01: 지정가, 02: 조건부지정가, 03: 시장가, 04: 최유리지정가 ORDR_PRC 주문가격 ORDR_QNT 주문수량 EMR_ORDR_MDIA_DCD DFRT_HDGE_DCD GRUP_ORDR_YN ORDR_GRUP_NM BNDL_ORDR_GRUP_NO DRVS_WRAP_ORDR_DCD RCMD_ORTN_PRDT_CD BSK_TRDE_ORDR_SN 비상주문매체구분코드차익헷지구분코드그룹주문여부주문그룹명일괄주문그룹번호파생상품 WRAP 주문구분코드추천운용상품코드바스켓매매주문일련번호 DRVS_ORDR_CND_DCD 파생상품주문조건구분코드 F.FOK, I.IOC PWD_CNFM_YN 비밀번호확인여부 Y:YES CVRG_YN 반대매매여부 N:NO * 기본값 'Y' * 기본값 'N' MDIA_ORDR_SN 매체주문일련번호 ADIT_WMY_BNDL_ORDR_YN 추가증거금일괄주문여부 WRN_ORDR_CNFM_YN ETC_ORDR_DCD ORDR_ANGT_ORDR_DCD ORDR_RPRC_YN 출력항목 ORDR_SN 경고주문확인여부기타주문구분코드주문대리인주문구분코드주문재처리여부출력설명주문인련번호 페이지 79 / 103

80 국내지수 / 주식선물옵션주문 I/O - 매수주문 - OTS2100U20.res 입력항목 입력설명 필수 옵션값 비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 ACNT_PWD 계좌비밀번호 SELL_BUY_DCD 매도매수구분코드 2: 매수 * 기본값 '2' PRDT_CD 상품코드 DRVS_NMPR_DCD 파생상품호가구분코드 01: 지정가, 02: 조건부지정가, 03: 시장가, 04: 최유리지정가 ORDR_PRC 주문가격 ORDR_QNT 주문수량 EMR_ORDR_MDIA_DCD DFRT_HDGE_DCD GRUP_ORDR_YN ORDR_GRUP_NM BNDL_ORDR_GRUP_NO DRVS_WRAP_ORDR_DCD RCMD_ORTN_PRDT_CD BSK_TRDE_ORDR_SN 비상주문매체구분코드차익헷지구분코드그룹주문여부주문그룹명일괄주문그룹번호파생상품 WRAP 주문구분코드추천운용상품코드바스켓매매주문일련번호 DRVS_ORDR_CND_DCD 파생상품주문조건구분코드 F.FOK, I.IOC PWD_CNFM_YN 비밀번호확인여부 Y:YES CVRG_YN 반대매매여부 N:NO * 기본값 'Y' * 기본값 'N' MDIA_ORDR_SN ADIT_WMY_BNDL_ORDR_Y N WRN_ORDR_CNFM_YN ETC_ORDR_DCD ORDR_ANGT_ORDR_DCD ORDR_RPRC_YN 출력항목 ORDR_SN 매체주문일련번호추가증거금일괄주문여부경고주문확인여부기타주문구분코드주문대리인주문구분코드주문재처리여부출력설명주문인련번호 페이지 80 / 103

81 국내지수 / 주식선물옵션주문 I/O - 정정주문 - OTS2100U30.res 입력항목 입력설명 필수 옵션값 비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 ACNT_PWD 계좌비밀번호 ORDR_BDCD 주문부점코드 OR_ORDR_SN 원주문일련번호 DRVS_NMPR_DCD 파생상품호가구분코드 01: 지정가, 02: 조건부지정가, 03: 시장가, 04: 최유리지정가 ORDR_PRC 주문가격 ORDR_QNT 주문수량 ALL_YN 전체여부 Y:YES, N:NO EMR_ORDR_MDIA_DCD 비상주문매체구분코드 DFRT_HDGE_DCD GRUP_ORDR_YN ORDR_GRUP_NM 차익헷지구분코드 그룹주문여부 주문그룹명 DRVS_ORDR_CND_DCD 파생상품주문조건구분코드 F.FOK, I.IOC PWD_CNFM_YN 비밀번호확인여부 Y:YES CVRG_YN 반대매매여부 N:NO * 기본값 'Y' * 기본값 'N' MDIA_ORDR_SN WRN_ORDR_CNFM_YN ETC_ORDR_DCD ORDR_RPRC_YN 출력항목 ORDR_SN 매체주문일련번호경고주문확인여부기타주문구분코드주문재처리여부출력설명주문일련번호 페이지 81 / 103

82 국내지수 / 주식선물옵션주문 I/O - 취소주문 - OTS2100U40.res 입력항목 입력설명 필수 옵션값 비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 ACNT_PWD 계좌비밀번호 ORDR_BDCD 주문부점코드 OR_ORDR_SN 원주문일련번호 ORDR_PRC 주문가격 ORDR_QNT 주문수량 ALL_YN 전체여부 Y:YES, N:NO EMR_ORDR_MDIA_DCD DFRT_HDGE_DCD GRUP_ORDR_YN ORDR_GRUP_NM 비상주문매체구분코드차익헷지구분코드그룹주문여부주문그룹명 PWD_CNFM_YN 비밀번호확인여부 Y:YES * 기본값 'Y' MDIA_ORDR_SN ETC_ORDR_DCD ORDR_RPRC_YN 출력항목 ORDR_SN 매체주문일련번호기타주문구분코드주문재처리여부출력설명주문일련번호 페이지 82 / 103

83 9.5. 야간선물옵션주문 야간선물옵션주문 I/O - 매도 / 매수주문 - OTS2850U30.res 입력항목 입력설명 필수 옵션값 비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 ACNT_PWD 계좌비밀번호 SELL_BUY_DCD 매도매수구분코드 1: 매도, 2: 매수 * 기본값 '1' PRDT_CD 상품코드 DRVS_NMPR_DCD 파생상품호가구분코드 01: 지정가, 02: 조건부지정가, 03: 시장가, 04: 최유리지정가 ORDR_PRC 주문가격 ORDR_QNT 주문수량 EMR_ORDR_MDIA_DCD DFRT_HDGE_DCD GRUP_ORDR_YN ORDR_GRUP_NM BNDL_ORDR_GRUP_NO DRVS_WRAP_ORDR_DCD RCMD_ORTN_PRDT_CD BSK_TRDE_ORDR_SN 비상주문매체구분코드차익헷지구분코드그룹주문여부주문그룹명일괄주문그룹번호파생상품 WRAP 주문구분코드추천운용상품코드바스켓매매주문일련번호 DRVS_ORDR_CND_DCD 파생상품주문조건구분코드 F.FOK, I.IOC PWD_CNFM_YN 비밀번호확인여부 Y:YES CVRG_YN 반대매매여부 N:NO * 기본값 'Y' * 기본값 'N' MDIA_ORDR_SN 매체주문일련번호 ADIT_WMY_BNDL_ORDR_YN 추가증거금일괄주문여부 WRN_ORDR_CNFM_YN ETC_ORDR_DCD ORDR_ANGT_ORDR_DCD 출력항목 ORDR_SN 경고주문확인여부기타주문구분코드주문대리인주문구분코드출력설명주문인련번호 페이지 83 / 103

84 야간선물옵션주문 I/O - 정정주문 - OTS2850U32.res 입력항목 입력설명 필수 옵션값 비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 ACNT_PWD 계좌비밀번호 ORDR_BDCD 주문부점코드 OR_ORDR_SN 원주문일련번호 DRVS_NMPR_DCD 파생상품호가구분코드 01: 지정가, 02: 조건부지정가, 03: 시장가, 04: 최유리지정가 ORDR_PRC 주문가격 ORDR_QNT 주문수량 ALL_YN 전체여부 Y:YES, N:NO EMR_ORDR_MDIA_DCD DFRT_HDGE_DCD GRUP_ORDR_YN ORDR_GRUP_NM 비상주문매체구분코드차익헷지구분코드그룹주문여부주문그룹명 DRVS_ORDR_CND_DCD 파생상품주문조건구분코드 F.FOK, I.IOC PWD_CNFM_YN 비밀번호확인여부 Y:YES CVRG_YN 반대매매여부 N:NO * 기본값 'Y' * 기본값 'N' MDIA_ORDR_SN WRN_ORDR_CNFM_YN ETC_ORDR_DCD 출력항목 ORDR_SN 매체주문일련번호경고주문확인여부기타주문구분코드출력설명주문일련번호 페이지 84 / 103

85 야간선물옵션주문 I/O - 취소주문 - OTS2850U33.res 입력항목 입력설명 필수 옵션값 비고 CTNO 종합계좌대체번호 APNO 계좌상품번호 ACNT_PWD 계좌비밀번호 ORDR_BDCD 주문부점코드 OR_ORDR_SN 원주문일련번호 ORDR_PRC 주문가격 ORDR_QNT 주문수량 ALL_YN 전체여부 Y:YES, N:NO EMR_ORDR_MDIA_DCD DFRT_HDGE_DCD GRUP_ORDR_YN ORDR_GRUP_NM 비상주문매체구분코드차익헷지구분코드그룹주문여부주문그룹명 PWD_CNFM_YN 비밀번호확인여부 Y:YES * 기본값 'Y' MDIA_ORDR_SN ETC_ORDR_DCD 출력항목 ORDR_SN 매체주문일련번호기타주문구분코드출력설명주문일련번호 페이지 85 / 103

86 9.6. FX 마진주문 FX 마진주문 I/O - 일반주문 - OTS5901U31.res 주문유형 ( 가격조건구분 ) 신규 입력항목입력설명필수비고 1. 지정가 2. 시장가 청산 4.STOP 청산 4.LIMIT 청산 5.OCO 청산 6.T.Stop 3.STOP CTNO 종합계좌대체번호 O O O O O O APNO 계좌상품번호 O O O O O O PWD 비밀번호 O O O O O O FDM_UNQ_NO 딜링하우스고유번호 O D04: FXCM D05: MP O O O O O PRDT_CD 상품코드 O ex) EUR/USD O O O O O NMPR_UNQ_NO 호가고유번호 ENTR_CLR_DCD 진입청산구분코드 O O:OPEN( 신규 ) C:CLOSE( 청산 ) O O O O O PST_NO 포지션번호 청산주문시셋팅 O O O O ODRV_SELL_BUY_DCD 해외파생매도매수구분코드 O B: 매수 S: 매도 O O O O O 신규 : 1. 지정가 2. 시장가 3.STOP PRC_CND_DCD 가격조건구분코드 O 청산 : 4.STOP/LIMIT 5.OCO 6.Trailing Stop 신규 : 1. 지정가시지정가격셋팅 O O O O O ODRV_ORDR_PRC 해외파생주문가격 2. 시장가시 0 O 3.STOP 시 스탑가격셋팅 청산 : 0 ORDR_QNT 주문수량 O O O O O O SQ1_STLS_YN 1 차스탑로스여부 Y/N. 청산주문시사용 O O O SQ1_APMPR_YN 1 차지정가여부 Y/N. 청산주문시사용 O O 1 차스탑로스여부 SQ1_STLS_PRC 1 차스탑로스가격 가 'Y' 인경우 O O O 셋팅 SQ1_APPN_PRC 1 차지정가격 1 차지정가여부가 'Y' 인경우셋팅 O O 가격조건구분이 SQ1_CHAS_STLS_PRC 1 차추적손절매가격 6.Trailing Stop 의 O 경우 PIP 설정 페이지 86 / 103

87 Y/N. SQ2_STLS_YN 2 차스탑로스여부 가격조건구분이 6.Trailing Stop 의 O 경우 SQ2_APMPR_YN 2 차지정가여부 사용안함 SQ2_STLS_PRC 2 차스탑로스가격 사용안함 SQ2_APPN_PRC 2 차지정가격 사용안함 SQ2_CHAS_STLS_PRC 2 차추적손절매가격 사용안함 N. 일반주문 ORDR_DRCN_DCD 주문방향구분코드 O ORDR_SRC_DCD 주문원천구분코드 O TRDE_PRC_DFRN_CTN 매매가격차이내용 S W. 대기주문. 일반주문만사용함. C: 일반주문 F: 강제청산 (1:Forc e clearing- 장중실시간 ) M: 반대매매 (2:Mar gin adding- 정산시추가증거금 ) 사용안함 O O O O O O O O O O 출력항목 ODRV_ODNO 출력설명 해외파생주문번호 페이지 87 / 103

88 FX 마진주문 I/O - 정정주문 - OTS5901U32.res 항목영문명 항목명 필수 비고 ODRV_OR_ODNO 해외파생원주문번호 O CTNO 종합계좌대체번호 O APNO 계좌상품번호 O PWD 비밀번호 O ODRV_SELL_BUY_DCD 해외파생매도매수구분코드 O B: 매수 S: 매도 FDM_UNQ_NO 딜링하우스고유번호 O D04:MP D05:FXCM PRDT_CD 상품코드 O NMPR_UNQ_NO 호가고유번호 CNCS_CND_DCD 체결조건구분코드 O 1:FAS 2:FOK 3:FAK(IOC) 4:GTD 5:GTC 6:AOG ORDR_EXPR_DT 주문만료일자 PRC_CND_DCD 가격조건구분코드 O 신규 : 1. 지정가 2. 시장가 3.STOP 청산 : 4.STOP/LIMIT 5.OCO 6.Trailing Stop ODRV_ORDR_PRC 해외파생주문가격 신규 : 1. 지정가시지정가격셋팅 2. 시장가시 0 3.STOP 시스탑가격셋팅청산 : 0 ORDR_QNT 주문수량 O SQ1_STLS_YN 1 차스탑로스여부 Y/N. 청산주문시사용 SQ1_APMPR_YN 1 차지정가여부 Y/N. 청산주문시사용 SQ1_STLS_PRC 1 차스탑로스가격 1 차스탑로스여부가 'Y' 인경우셋팅 SQ1_APPN_PRC 1 차지정가격 1 차지정가여부가 'Y' 인경우셋팅 SQ1_CHAS_STLS_PRC 1 차추적손절매가격 가격조건구분이 6.Trailing Stop 의경우 PIP 설정 SQ2_STLS_YN 2 차스탑로스여부 Y/N. 가격조건구분이 6.Trailing Stop 의경우 SQ2_STLS_PRC 2 차스탑로스가격 사용안함 SQ2_APMPR_YN 2 차지정가여부 사용안함 SQ2_APPN_PRC 2 차지정가격 사용안함 SQ2_CHAS_STLS_PRC 2 차추적손절매가격 사용안함 ORDR_DRCN_DCD 주문방향구분코드 N. 일반주문 W. 대기주문. 일반주문만사용함. TRDE_PRC_DFRN_CTNS 매매가격차이내용 사용안함 출력항목 ODRV_ODNO 출력설명 해외파생주문번호 페이지 88 / 103

89 FX 마진주문 I/O - 취소주문 - OTS5901U33.res 항목영문명 항목명 필수 비고 ODRV_OR_ODNO 해외파생원주문번호 O CTNO 종합계좌대체번호 O APNO 계좌상품번호 O PWD 비밀번호 O FDM_UNQ_NO 딜링하우스고유번호 D04:MP D05:FXCM PRDT_CD ORDR_QNT 상품코드 주문수량 ORDR_DRCN_DCD 주문방향구분코드 N. 일반주문 W. 대기주문. 일반주문만사용함. 출력항목 ODRV_ODNO 출력설명 해외파생주문번호 페이지 89 / 103

90 9.7. 주식주문 주식주문 I/O - 매도 - OTS1111U10.res 입력항목입력설명필수코드값비고 ORDR_DT 주문일자 O CTNO 종합계좌대체번호 O APNO 계좌상품번호 O FTS_CTNO 선물대용종합계좌대체번호 선물대용주문구분코드 00 이아닌경우입력 FTS_APNO 선물대용계좌상품번호 선물대용주문구분코드 00 이아닌경우입력 ACNT_PWD 계좌비밀번호 O PRDT_CD 상품코드 O BUY_DT 매수일자 SPTX_DCD 분리과세구분코드 O 1: 종합과세 2: 분리과세 LOAN_SN 대출일련번호 O 신용이아닌경우 0 CRDT_TR_DCD 신용거래구분코드 O 00: 보통매매 01: 융자매수 03: 융자매수 04: 유통차입매도 05: 대주매도 06: 대용융자매수 07: 대주매도 08: 예탁담보대출 09: 공모주대출 11: 융자매도상환 12: 융자현금상환 33: 융자매도상환 34: 융자현금상환 44: 유통차입매수상환 45: 유통차입현물상환 55: 대주매수상환 56: 대주현물상환 66: 대용융자매도상환 67: 대용융자현금상환 77: 대주매수상환 78: 대주현물상환 88: 예탁담보대출매도상환 89: 예탁담보대출현금상환 99: 공모주대출상환 ALMN_RDMP_DCD 전액상환구분코드 0: 수량 ( 일부상환방식 ) 1: 금액 ( 전부상환방식 ) SSS_NMPR_DCD 공매도호가구분코드 O 00: 정상 01: 차입주식매도 02: 기타공매도 03: 결제전매도 05: 증거금미징수 09: 권리공매도 페이지 90 / 103

91 FTS_ORDR_DCD 선물대용주문구분코드 O 00: 보통 01: 코스피선물대용 ( 일반 ) 02: 코스피선물대용 ( 반대 ) 03: 코스닥선물대용 ( 일반 ) 04: 코스닥선물대용 ( 반대 ) 05: 권리현금매수 ( 일반 ) 06: 권리현금매수 ( 반대 ) 07: 권리현금매도 ( 일반 ) 08: 권리현금매도 ( 반대 ) NMPR_DCD 호가구분코드 O 00: 일반 ( 지정가 ) 03: 시장가 05: 조건부지정가 06: 최유리지정가 07: 최우선지정가 09: 자사주 10: 자사주스톡옵션 12: 자사주신탁 61: 장개시전시간외 72: 시간외대량 77: 시간외대량자사주신탁 79: 시간외대량자사주 81: 시간외종가 91: 시간외단일가 ORDR_CND_DCD 주문조건구분코드 O 00: 없음 01:IOC 02:FOK RSVN_ORDR_DCD 예약주문구분코드 O 0: 정상 1: 일반예약 2: 잔량예약 3: 수량예약 CVRG_PRCS_DCD 반대매매처리구분코드 O 00: 일반 01: 전산반대매매 02: 지점처리주문 00 ORDR_QNT 주문수량 O ORDR_UNPR 주문단가 O EMR_ORDR_MDIA_DCD 비상주문매체구분코드 O 000: 정상 0I2: 홈페이지 ARS:ARS HA1: 오토고객 HH1:HTS( 고객 ) HHY:AirPost HHZ:Micess PP1:SKT PP6:KTF PP9:LGT TT1: 업무단말 TT2: 콜센터 WH1:WTS RSV_ORDR_SN 예비주문일련번호 FIX_ODNO FIX 주문번호 WRAP_ORDR_KND_DCD WRAP 주문종류구분코드 O 00: 해당없음 01: 복수 02: 일괄 03: 집합 04: 멀티 RCMD_ORTN_PRDT_CD GRUP_ODNO BSK_ORDR_SN 추천운용상품코드 그룹주문번호 바스켓주문일련번호 페이지 91 / 103

92 ORDR_ANGT_ORDR_DCD 주문대리인주문구분코드 O 0: 일반 1: 대리인주문 ( 오프라인 ) 2: 대리인주문 ( 온라인 ) MTS_KEY HTS_ORDR_PSBL_MDIA_Y N NMPR_PROP_XCP_YN BNDL_SELL_ORDR_YN MTS 키 HTS 주문가능매체여부 호가적정성예외여부 일괄매도주문여부 AGCP_OPPS_SELL_DCD 대행사반대매도구분코드 0: 일반 1: 대행사반대매도 PGM_NMPR_DCD PRTR_PANC_DCD 프로그램호가구분코드 프로그램매매공시구분코드 O 00: 일반 01: 차익거래 02: 비차익거래 03: 주식옵션차익거래 04:ETF 차익거래 ( 비차익제외 ) 05:ETF 설정거래 ( 비차익제외 ) 06:ETF 차익거래 ( 비차익 ) 07:ETF 설정거래 ( 비차익 ) 08:DR 차익거래 09:ELW 헤지거래 10:ETF 헤지거래 11: 선물헤지거래 12: 장외파생상품헤지거래 14:ETN 차익거래 ( 비차익 ) 15:ETN 차익거래 ( 비차익제외 ) 16:ETN 헤지거래 HTRD_NEGO_NO 대량매매협상번호 O 11: 설정 12: 해소 13: 이월 20: 차익거래 21: 인덱스매매 22:PI(Portfolio Insurance) 23: 자산배분 24:Hedge 거래 25: 기타 기본값 '0' 기본값 '00' 기본값 '00' HTRD_SRV_NO 대량매매서버번호 HTRD_USR_NO 대량매매사용자번호 BOND_ORDR_OR_UN_DC 채권주문원단위구분코드 D SMLN_YN 시뮬레이션여부 O 기본값 'N' 출력항목 출력설명 ORDR_SN 주문일련번호 MSG_CD 메시지코드 MSG_CTNS 메시지내용 페이지 92 / 103

93 주식주문 I/O - 매수 - OTS1111U20.res 입력항목입력설명필 수 ORDR_DT 주문일자 O CTNO 종합계좌대체번호 O APNO 계좌상품번호 O 코드값 FTS_CTNO 선물대용종합계좌대체번호 선물대용주문구분코드 00 이아닌경우입력 FTS_APNO 선물대용계좌상품번호 선물대용주문구분코드 00 이아닌경우입력 ACNT_PWD 계좌비밀번호 O PRDT_CD 상품코드 O BUY_DT 매수일자 O SPTX_DCD 분리과세구분코드 O 1: 종합과세 2: 분리과세 LOAN_SN 대출일련번호 O 신용이아닌경우 0 CRDT_TR_DCD 신용거래구분코드 O 00: 보통매매 01: 융자매수 03: 융자매수 04: 유통차입매도 05: 대주매도 06: 대용융자매수 07: 대주매도 08: 예탁담보대출 09: 공모주대출 11: 융자매도상환 12: 융자현금상환 33: 융자매도상환 34: 융자현금상환 44: 유통차입매수상환 45: 유통차입현물상환 55: 대주매수상환 56: 대주현물상환 66: 대용융자매도상환 67: 대용융자현금상환 77: 대주매수상환 78: 대주현물상환 88: 예탁담보대출매도상환 89: 예탁담보대출현금상환 99: 공모주대출상환 ALMN_RDMP_DCD 전액상환구분코드 0: 수량 ( 일부상환방식 ) 1: 금액 ( 전부상환방식 ) SSS_NMPR_DCD 공매도호가구분코드 O 00: 정상 01: 차입주식매도 02: 기타공매도 03: 결제전매도 05: 증거금미징수 09: 권리공매도 FTS_ORDR_DCD 선물대용주문구분코드 O 00: 보통 01: 코스피선물대용 ( 일반 ) 02: 코스피선물대용 ( 반대 ) 03: 코스닥선물대용 ( 일반 ) 04: 코스닥선물대용 ( 반대 ) 05: 권리현금매수 ( 일반 ) 06: 권리현금매수 ( 반대 ) 07: 권리현금매도 ( 일반 ) 08: 권리현금매도 ( 반대 ) 비고 페이지 93 / 103

94 NMPR_DCD 호가구분코드 O 00: 일반 ( 지정가 ) 03: 시장가 05: 조건부지정가 06: 최유리지정가 07: 최우선지정가 09: 자사주 10: 자사주스톡옵션 12: 자사주신탁 61: 장개시전시간외 72: 시간외대량 77: 시간외대량자사주신탁 79: 시간외대량자사주 81: 시간외종가 91: 시간외단일가 ORDR_CND_DCD 주문조건구분코드 O 00: 없음 01:IOC 02:FOK RSVN_ORDR_DCD 예약주문구분코드 O 0: 정상 1: 일반예약 2: 잔량예약 3: 수량예약 CVRG_PRCS_DCD 반대매매처리구분코드 O 00: 일반 01: 전산반대매매 02: 지점처리주문 ORDR_QNT 주문수량 O ORDR_UNPR 주문단가 O EMR_ORDR_MDIA_DCD 비상주문매체구분코드 O 000: 정상 0I2: 홈페이지 ARS:ARS HA1: 오토고객 HH1:HTS( 고객 ) HHY:AirPost HHZ:Micess PP1:SKT PP6:KTF PP9:LGT TT1: 업무단말 TT2: 콜센터 WH1:WTS 00 RSV_ORDR_SN FIX_ODNO 예비주문일련번호 FIX 주문번호 WRAP_ORDR_KND_DCD WRAP 주문종류구분코드 O 00: 해당없음 01: 복수 02: 일괄 03: 집합 04: 멀티 RCMD_ORTN_PRDT_CD GRUP_ODNO BSK_ORDR_SN 추천운용상품코드 그룹주문번호 바스켓주문일련번호 ORDR_ANGT_ORDR_DCD 주문대리인주문구분코드 O 0: 일반 1: 대리인주문 ( 오프라인 ) 2: 대리인주문 ( 온라인 ) MTS_KEY HTS_ORDR_PSBL_MDIA_ YN NMPR_PROP_XCP_YN MTS 키 HTS 주문가능매체여부 호가적정성예외여부 페이지 94 / 103

95 BNDL_SELL_ORDR_YN 일괄매도주문여부 AGCP_OPPS_SELL_DCD 대행사반대매도구분코드 0: 일반 1: 대행사반대매도 기본값 '0' PGM_NMPR_DCD 프로그램호가구분코드 PRTR_PANC_DCD 프로그램매매공시구분코드 O 00: 일반 01: 차익거래 02: 비차익거래 03: 주식옵션차익거래 04:ETF 차익거래 ( 비차익제외 ) 05:ETF 설정거래 ( 비차익제외 ) 06:ETF 차익거래 ( 비차익 ) 07:ETF 설정거래 ( 비차익 ) 08:DR 차익거래 09:ELW 헤지거래 10:ETF 헤지거래 11: 선물헤지거래 12: 장외파생상품헤지거래 14:ETN 차익거래 ( 비차익 ) 15:ETN 차익거래 ( 비차익제외 ) 16:ETN 헤지거래 기본값 '00' HTRD_NEGO_NO 대량매매협상번호 O 11: 설정 12: 해소 13: 이월 20: 차익거래 21: 인덱스매매 22:PI(Portfolio Insurance) 23: 자산배분 24:Hedge 거래 25: 기타 기본값 '00' HTRD_SRV_NO 대량매매서버번호 HTRD_USR_NO 대량매매사용자번호 BOND_ORDR_OR_UN_DC 채권주문원단위구분코드 D SMLN_YN 시뮬레이션여부 O 기본값 'N' 출력항목 출력설명 ORDR_SN 주문일련번호 MSG_CD 메시지코드 MSG_CTNS 메시지내용 페이지 95 / 103

96 주식주문 I/O - 정정 - OTS1111U30.res 입력항목 입력설명 필수 코드값 비고 ORDR_DT 주문일자 O CTNO 종합계좌대체번호 O APNO 계좌상품번호 O MNGM_BDCD 관리부점코드 OR_ORDR_SN 원주문일련번호 O ACNT_PWD 계좌비밀번호 O PRDT_CD 상품코드 O NMPR_DCD 호가구분코드 O 00: 일반 ( 지정가 ) 03: 시장가 05: 조건부지정가 06: 최유리지정가 07: 최우선지정가 09: 자사주 10: 자사주스톡옵션 12: 자사주신탁 61: 장개시전시간외 72: 시간외대량 77: 시간외대량자사주신탁 79: 시간외대량자사주 81: 시간외종가 91: 시간외단일가 ORDR_CND_DCD 주문조건구분코드 O 00: 없음 01:IOC 02:FOK ORDR_QNT 주문수량 O ORDR_UNPR 주문단가 O EMR_ORDR_MDIA_DCD 비상주문매체구분코드 O 000: 정상 0I2: 홈페이지 ARS:ARS HA1: 오토고객 HH1:HTS( 고객 ) HHY:AirPost HHZ:Micess PP1:SKT PP6:KTF PP9:LGT 페이지 96 / 103

97 TT1: 업무단말 TT2: 콜센터 WH1:WTS GRUP_ODNO BSK_ORDR_SN MTS_KEY 그룹주문번호 바스켓주문일련번호 MTS 키 HTS_ORDR_PSBL_MDIA_YN HTS 주문가능매체여부 NMPR_PROP_XCP_YN 호가적정성예외여부 ORDR_ANGT_ORDR_DCD 주문대리인주문구분코드 O 0: 일반 1: 대리인주문 ( 오프라인 ) 2: 대리인주문 ( 온라인 ) BOND_ORDR_OR_UN_DCD PRT_ALL_DCD 출력항목 ORDR_SN MSG_CD MSG_CTNS 채권주문원단위구분코드일부전체구분코드출력설명주문일련번호메시지코드메시지내용 페이지 97 / 103

98 주식주문 I/O - 취소 - OTS1111U40.res 입력항목 입력설명 필수 코드값 비고 ORDR_DT 주문일자 O CTNO 종합계좌대체번호 O APNO 계좌상품번호 O MNGM_BDCD 관리부점코드 OR_ORDR_SN 원주문일련번호 O ACNT_PWD 계좌비밀번호 O PRDT_CD 상품코드 O ORDR_QNT 주문수량 O EMR_ORDR_MDIA_DCD 비상주문매체구분코드 O 000: 정상 0I2: 홈페이지 ARS:ARS HA1: 오토고객 HH1:HTS( 고객 ) HHY:AirPost HHZ:Micess PP1:SKT PP6:KTF PP9:LGT TT1: 업무단말 TT2: 콜센터 WH1:WTS GRUP_ODNO BSK_ORDR_SN MTS_KEY HTS_ORDR_PSBL_MDIA_YN NMPR_PROP_XCP_YN 그룹주문번호바스켓주문일련번호 MTS 키 HTS 주문가능매체여부호가적정성예외여부 ORDR_ANGT_ORDR_DCD 주문대리인주문구분코드 O 0: 일반 1: 대리인주문 ( 오프라인 ) 2: 대리인주문 ( 온라인 ) BOND_ORDR_OR_UN_DCD PRT_ALL_DCD 출력항목 ORDR_SN MSG_CD MSG_CTNS 채권주문원단위구분코드일부전체구분코드출력설명주문일련번호메시지코드메시지내용 페이지 98 / 103

99 10. Open API 예제파일설명 - 예제는 Visual Studio 2013 에서개발되었다. - 예제는인터페이스사용법및개념설명목적으로처리성능과사용상의편의등은고려하지않는다 Visual Studio 2013 C++(MFC) 예제파일 소스파일구성 파일명설명클래스명 hfcommagent.h hfcommagent.cpp HFClientSampleDlg.h HFClientSampleDlg.cpp StockSiseDlg.h StockSiseDlg.cpp IndexFutSiseDlg.h IndexFutSiseDlg.cpp IndexOptSiseDlg.h IndexOptSiseDlg.cpp ForeignFutSiseDlg.h ForeignFutSiseDlg.cpp CmeFutSiseDlg.h CmeFutSiseDlg.cpp EurexOptSiseDlg.h EurexOptSiseDlg.cpp FxMarginSiseDlg.h FxMarginSiseDlg.cpp FFutOptOrdDlg.h FFutOptOrdDlg.cpp IndexFutOptOrdDlg.h IndexFutOptOrdDlg.cpp CmeEurexFutOptOrdDlg.h CmeEurexFutOptOrdDlg.cpp FxMarginOrdDlg.h FxMarginOrdDlg.cpp OpenAPI Agent 컨트롤인터페이스 Wrapper 프로그램기본대화창 ( 상품별예제대화창실행 ) 주식시세예제지수선물시세예제지수옵션시세예제해외선물시세예제 CME선물시세예제 Eurex 시세예제 FX마진시세예제해외선물주문예제국내선물옵션주문예제야간선물옵션주문예제 FX마진주문예제 CHFCommAgent CHFClientSampleDlg CStockSiseDlg CIndexFutSiseDlg CIndexOptSiseDlg CForeignFutSiseDlg CCmeFutSiseDlg CEurexOptSiseDlg CFxMarginSiseDlg CFFutOptOrdDlg CIndexFutOptOrdDlg CCmeEurexFutOptOrdDlg CFxMarginOrdDlg 페이지 99 / 103

100 예제프로그램실행 (CHFClientSampleDlg) 페이지 100 / 103

101 10.2. Visual Studio 2013 C# 예제 소스파일구성 파일명 설명 클래스명 SiseForm.cs 지수선물시세예제 IndexFutSiseForm OrderForm.cs 지수선물옵션주문예제 OrderForm 예제프로그램실행 (IndexFutSiseForm) 예제프로그램실행 (OrderForm) 페이지 101 / 103