1Q Pro. 1Q OpenAPI. 하나금융투자. 다운로드. 설치.

명칭 : 1Q Pro.

- 하나금융투자에서 제공하는 시스템매매 코딩용 OpneAPI. 

- 명칭 1Q Pro , 1Q OpenAPI 혼용 표현. 혼선 주의. 같은 것을 지칭하는 것임.

1Q Pro 특징. 

• API 형식 : COM  확장자 dll.  ( Visual C++ 2013 으로 제작되었고, 32bit 로 빌드됨.). 
• COM 형식인 것들은 PC 레지스트리에 등록해야 정상 사용가능함.
• 실시간 시세 및 거래가능 종목 : 지수선물옵션, 해외선물, FX마진, CME & EUREX연계 KOSPI200 선물/옵션 야간, 주식
• 증권사 제공 1Q Pro 정보 : https://www.hanaw.com/main/customer/customer/CS_050600_T1.cmd
• API 설명문 : [v 1.3]하나금융투자 Open API 고객 가이드.pdf
• - 설명문은 웹에서 제공되지 않고, 1Q Pro 설치하였을때 C://1Q OpenAPI/Document 폴더 속에 워드로 된 설명문 있음. 워드파일 pdf 변환하여 첨부함. 
• API 의 자동 업데이트 기능 없어서, 수동으로 신규버전 배포되는지 모니터링 해야함. 
  

1Q Pro 다운로드. 

다운로드 주소 : 1Q Pro 정보 페이지 게시판에서 배포되고 있다. 신규버전 배포되는 경우에도 게시판에서 배포된다. 

API 버전 : version 1.3 , 현재(2018년 6월 22일 ) 최신버전임.

1Q Pro 설치. 

상기 다운로드 한 설치파일 실행하여 설치 진행. 

- 설치라 함은  C://1Q OpenAPI/ 에 압축 푸는것이 전부임. 

1Q OpenAPI 폴더구조.

설치하고 나면 C://1Q OpenAPI 하위에 아래그림과 같은 파일과 폴더들이 생성된다. 

[1Q OpenAPI]┐ (root 폴더)                 │                 ├[1QApiAgent] (API 에이전트 모듈 폴더)                 │                 ├[Document]   (API 개발 가이드문서 폴더)                 │                 └[Example]┐  (API 예제 프로그램 폴더)                            │                            ├[C#] ┐                            │     │                            │     ├[bin] (C# 예제 프로그램 exe파일)                            │     │                            │     └[src] (C# 예제 프로젝트소스)                            │                            ├[MFC]┐                            │     │                            │     ├[bin] (MFC 예제 프로그램 exe파일)                            │     │                            │     └[src] (MFC 예제 프로젝트소스)                            │                            └[Excel]┐                                     │                                     └[src] (Excel 예제 파일)     (예제 프로그램과 예제 프로젝트소스 :  MS Visual Studio 2013 에서 구현된것 )

PC 레지스트리에 regHFCommAgent.dll  등록하기. 

설명 : 설치된 1Q OpenAPI/1QApiAgent/ 에 있는 HFCommAgent.dll 을 PC 레지스트리에 등록해야 개발하는 코드에서 정상 실행가능한 상태가 된다. 

방법. 

경로 1Q OpenAPI/1QApiAgent/ 에서 커맨드 창 실행하여 regsvr32 HFCommAgent.dll  구문 실행시킨다. (아래 동영상에 과정 보임)

상기 설치 완료이후 Visual C++ 에서 코딩 첫 처리 사항 : http://igotit.tistory.com/1711

신규버전 API 배포 모니터링 수단. 

- 하나금융투자측에서 제공하는 설명문. 메일등록해두면 신규 업뎃 있는 경우 메일로 알려준단다. 

[Mailing Service] -xian@hanafn.com으로 이메일주소 보내주시면, 최신 API 업데이트 소식과 다운로드링크를 메일로 보내드립니다. [Notice] -V1.3 API Agent부터는 Tr전송 제한이 적용됩니다.  1. 주문을 제외한 모든 Tr 1초에 5건 이상 전송 불가합니다.  2. 모든 Tr 50회 이상 오류가 발생하면 51회부터는 Tr전송 불가합니다.     프로그램 재실행 이후에 전송이 가능합니다. -1Q Pro(API)는 자동 업데이트를 제공하지 않습니다. -API업데이트는 필수와 선택이 있으며 선택 업데이트는 필요하신 분들만 받아 설치하시면 됩니다. -공인인증, 암호화모듈 등 반드시 업데이트가 필요한 상황이 발생하면 업데이트 이후 API 로그인이 가능하도록 저희쪽에서 로그인 통제를 하게됩니다.

1Q Pro 정상 사용하기 위한 필수 사용계약. 

1Q Pro 소개페이지 에 보면 "1Q Pro 서비스 변경에 관한 특별약정"을 신청합니다." 라는 내용이 있다. 이는 온라인상에서는 처리안되고 하나금융투자 영업점에 방문해서 오프라인으로 신청해야한다. 

1Q Pro 사용계약되어있지 않으면  OpenAPI 이용 로그인 단계에서 아래와 같은 API 서비스 등록정보가 없다는 문구 뜨면서 로그인 실패한다. 

하나금융투자 전국영업점 찾기 : http://openhanafn.tritops.co.kr/content_dt.jsp

본 글 포함된 상위 정리글  1. 시스템 트레이딩 http://igotit.tistory.com/840 2. 증권사 API 전체리스트 : http://igotit.tistory.com/493

///1710.