[Spring Boot] Spring Boot 한국투자증권 Open API (KIS Developers) 활용하기 - 0. 초기 세팅

스프링 프로젝트 - 0. 초기 세팅​

한국투자증권 Open API(Kis Developer)를 사용하여 거래량 순위를 가져오는 프로젝트를 만들었습니다. 물론 실제 거래뿐만 아니라 다양한 정보도 얻을 수 있습니다. 필자는 거래량 순위만 가져오는 것을 생각하고 있으나, Kis Developers API 샘플 예제 코드와 홈페이지를 참고하여 사용하시면 될 것 같습니다. 본격적으로 글을 작성해 보겠습니다.

---

한국투자증권 개발자센터 KIS Developers

KIS Developers는 한국투자증권의 트레이딩 서비스를 오픈 API로 제공하여 개발자들이 다양한 금융서비스를 만들 수 있도록 지원하는 개발자 센터입니다.

 

한국투자증권 개발자센터 홈페이지

KIS Developers

한국투자증권 API 신청

Kis Developers를 사용하기 위해서 API신청을 해보도록 하겠습니다. 그전에, 한국투자증권 계좌가 필요합니다. 한국투자증권 Open API는 모의 계좌도 지원하지만 특정 API의 경우에는 실제 계좌만 지원합니다. 이번에 사용할 거래량 순위 API의 경우 실제 계좌만 지원합니다.

한국투자증권 개발자센터 홈페이지

API 신청을 클릭하게 되면 한국투자증권 홈페이지에서 Open API를 신청할 수 있습니다. 신청 과정은 설명이 잘 되어 있어, 생략하도록 하겠습니다. 중간에 모바일 OTP 발급을 하라는 내용이 나옵니다. 한국투자 MTS 앱에서 발급 신청하시면 됩니다. 

• 한국투자증권 eFriend Smart 앱 - 인증센터 - 모바일 OTP - 모바일 OTP 발급 선택 (X)
• 한국투자 MTS 앱 - 인증 - OTP/모바일 OTP - 모바일 OTP 발급 선택 (O)

반응형

KIS Developers 서비스 신청정보

홈페이지 신청현황 우측에 APP KEY와 APP SecretKey는 API 호출 시 필수 값이므로 따로 저장하기를 권장드립니다.

서비스 신청 정보

Spring  Boot 초기 세팅 

Spring initializr 홈페이지에 들어가서 새로운 Spring 프로젝트를 만들 수 있습니다. 초기 세팅은 아래와 같으며, Dependencies를 참고해 주시고 생성해 주시면 됩니다.

• IntelliJ IDEA 2022.1.2
• Spring Boot version '3.2.3'
• JAVA 17
• Gradle - Groovy

spring initializr 화면

application.properties

server.port의 경우에는 원하는 포트 번호를 설정을 하셔서 사용하시면 됩니다. 필자는 8090으로 포트를 별도로 설정했습니다. 기본적인 포트인 8080을 사용하셔도 상관없습니다.

# server port
server.port=8090

# log level
logging.level.root=debug

# api key
appkey= APP-KEY
appsecret= APP-SecretKey
# token
access_token= Access-Token

 

 

로컬 기동 후 화면

로컬(localhost:8090)을 이상 없이 작동시켰다면, 본격적으로 개발을 할 준비가 된 상태입니다. Error 페이지의 경우 index.html 파일이 없으니 다음과 같은 화면이 뜨는 것입니다. 일단은 신경 쓰시지 마시고, 순차적으로 올라오는 글을 따라 참고해 주시면 감사하겠습니다.

(너무 신경이 쓰이시면 댓글을 남겨주세요.)

로컬 실행 화면

아래에 소스를 확인할 수 있는 Github 주소를 남깁니다. 주로 'dev' branch에서 확인해 주시면 됩니다. 

참고사이트

Github - kisvolumerank

GitHub - SeoYounSeok/kisvolumerank: 한국투자증권 Open API 거래량 순위를 활용한 분석 💹