키움 openAPI

통신동작

키움 openAPI는 모두 비동식으로 동작합니다. 통신흐름 아래와 같습니다.

1. 서버로 요청함수를 호출한다.
2. 서버에서 요청함수에 대응하는 이벤트 함수를 발생시킨다.
3. 이벤트 함수 안에서 데이터 획득 함수로 데이터를 얻는다.

데이터를 얻기 위해서는 반드시 이벤트 함수 안에서 얻어야 합니다. 아래와 같은 경우에는 데이터를 얻을 수 없게 됩니다.

• 이벤트 함수가 발생하기 전에 서버로 요청함수를 호출하는 경우
• 이벤트 함수가 발생하고 이벤트 함수를 벗어나는 경우

 

화면번호

openAPI함수를 이용하다보면 화면번호라는 설명이 나옵니다. 화면번호는 서버에 요청함수를 호출할 때 요청을 구분하기 위한 키값입니다. openAPI에는 서로 다른 요청함수를 호출시에도 같은 이벤트함수가 발생될 수 있기 때문에 화면번호로 어떤 요청함수가 이벤트를 발생시켰는지 구분할 수 있게 됩니다. 화면번호는 0000(혹은 0)을 제외한 임의의 숫자를 문자열로 사용할 수 있습니다. 하지만 갯수가 200개로 제한되어 있기 때문에 조심해야 합니다. 200개가 넘을 경우 원하지 않는 결과가 나타날 수 있습니다.

 

이벤트 함수

시세조회나 조건검색요청등 서버에 데이터를 요청해서 키움OpenAPI가 데이터를 수신하게 되면 사용자 프로그램에 특정이벤트함수를 자동으로 발생시킵니다. 이렇게 발생되는 이벤트 함수는 OnReceiveTRData(), OnEventConnect(), OnReceiveRealData()처럼 함수이름 앞에 "On"이 붙어있어서 일반적인 함수와 구별됩니다. 로그인, 시세조회, 주문 등 각 요청별로 요청함수, 이벤트함수와 데이터획득함수가 분류되어 있으니 용도에 맞는 함수를 사용해야 합니다. 각 함수는 KOAStudio를 이용하여 알 수 있습니다.