한국투자증권 API 신청 방법
알고리즘 투자의 첫걸음은 데이터를 빠르고 정확하게 처리할 수 있는 시스템을 구축하는 것입니다. API를 이용하면 이 시스템을 쉽게 구축할 수 있으며, 자동화된 투자 전략을 실현할 수 있습니다. 이번 글에서는 한국투자증권 API 신청 방법을 알아보겠습니다. 한국투자증권 계좌를 개설하셨다면, 누구나 API를 사용할 수 있는 APP Key와 APP Secret을 받을 수 있습니다.
글의 순서
한국투자증권 API
한국투자증권 KIS Developers
한국투자증권 API 신청 준비사항
한국투자증권 API 신청 방법
한국투자증권 API
한국투자증권 API는 2022년에 처음 출시된 API이며, REST API와 웹소켓(Websocket) 방식을 지원합니다. 아직 다른 증권사들은 여전히 HTS나 복잡한 프로그램들을 설치해야 하지만, 한국투자증권은 REST API, 웹소켓 방식이라서 프로그램 설치가 필요가 없습니다. 또한 한국투자증권 API는 윈도우 맥 리눅스 파이썬 버전이나 32비트, 64비트에 상관없이 REST API, 웹소켓을 이용해서 손쉽게 자동매매 시스템을 구현할 수 있습니다.
또 매력적인 것은 API를 이용해서 해외 주식 투자도 가능하다는 것입니다. 해외주식투자 해외 ETF도 API를 이용해서 투자할 수 있습니다. 통합증거금이라는 걸 이용할 경우, 그냥 원화만 넣어놓으면 별도의 환전 과정이 필요 없이 자동으로 환전해서 주식을 매매하는 기능도 있습니다.
한국투자증권 KIS Developers
한국투자증권은 KIS 디벨로퍼라는 개발자 사이트도 마련해두고 있습니다. KIS 디벨로퍼에 API에 대한 상세한 가이드라인과 샘플 코드가 있으므로, 주식투자 자동화 시스템을 쉽게 개발할 수 있습니다.
한국투자증권 API 신청 준비사항
한국투자증권의 API를 이용하려면 한국투자증권 계좌가 필요합니다. 비대면 계좌 개설 방법으로 계좌를 개설 할 수 있습니다. 자세한 사항은 한국투자증권의 계좌 개설 방법을 참고해주시기 바랍니다. 다만 계좌 개설을 위해 필요한 절차를 간단히 정리하고 넘어가겠습니다.
(1) 비대면 계좌 개설
국내주식, 해외주식 모두를 거래할 거기 때문에 한 번에 하나의 계좌에서 거래할 수 있는 옵션을 선택해서 뱅키스 온라인 계좌를 개설해 줍니다.
step1) 구글 플레이 스토어나 애플 앱스토어에서 한국투자증권 검색해서 앱 설치
step2) 앱 실행 → 계좌 개설하기 → 주식+중개형ISA+CMA 계좌 개설
step3) 휴대폰 본인확인 (이름, 주민등록번호, 통신사 선택, 약관동의, 휴대폰번호 입력, 인증)
step4) 스마트폰 계좌 개설 진행
step5~ ) 한국투자증권 계좌 개설 방법 참고.
(2) 통합증거금 신청
하나의 계좌에서 별도의 환전 없이 국내 주식 해외주식 주식을 모두 거래하려면 통합증거금 신청이 필요합니다.
한국투자증권 앱을 열어서 메뉴에 고객 서비스로 들어가서 거래 서비스 신청을 누르시고 여기서 통합 증거금 신청을 누르시면 특정 계좌에 대해서 통합 증거금을 신청하실 수 있습니다.
고객지원 → 거래서비스 신청 → 해외증권/통합증거금 신청
(3) 해외ETP 거래 신청
해외 ETF와 같은 상품을 거래하기 위해서는 먼저 해외 ETP 거래신청이라는 걸 해야 되는데요. 이걸 하는 방법은 마찬가지로 한국투자증권 앱을 열어서 고객 서비스의 거래성을 서비스 신청을 눌르시고 해외 ETP 거래신청으로 들어가셔서 특정 계좌에 대해서 해외 ETP IP 거래 신청을 하실 수 있습니다.
한국투자증권 API 신청 방법 : KIS Developer에서 API 신청
KIS 디벨로퍼 홈페이지로 접속하셔서 API 를 신청하실 수 있습니다. 한국투자증권 API는 REST API, Websocket 방식이라 프로그램 설치가 필요 없고 윈도우, 맥, 리눅스 등 어떤 개발환경에서도 작동됩니다. 통합증거금을 신청해놨다면, 환전 없이 해외주식투자도 가능합니다.
step1)
API를 신청하기 전에 먼저 이메일 정보가 등록되어 있어야 신청이 가능한데요. 앱을 열어서 고객 서비스의 주소 연락처 수정 메뉴로 들어가서 이메일 주소를 입력하고 연락처 변경을 누르시면 이메일 주소 등록이 완료됩니다.
그리고 나서 KIS 디벨로퍼 홈페이지로 접속한 후 API 를 신청하실 수 있습니다.
step2)
KIS 디벨로퍼 홈페이지로 들어와 줍니다. 오른쪽 위에 있는 API 신청 버튼을 클릭합니다. 그 후 로그인합니다. 스마트폰 인증을 통해 간편하게 로그인을 진행할 수 있습니다. 한국투자증권 스마트폰 앱에서 아래의 순서로 클릭합니다.
왼쪽 아래 ‘메뉴’ → 왼쪽 아래 ‘인증’ → ‘PC 인증’을 클릭하면 PC 웹브라우저에서 보여주고 있는 QR코드를 스캔할 수 있도록 카메라가 활성화됩니다. QR 코드를 스캔하거나, 인증번호를 입력하면 로그인 됩니다.
step3)
휴대폰 인증 후 ‘다음’ 버튼을 클릭하면, 약관 동의 화면이 뜹니다. 약관 동의 후 다음을 클릭합니다.
KIS Developers 서비스 신청하기 창이 뜨면, 그 창에 내 계좌 정보를 입력하고, API 그룹에서 모든 체크박스를 다 체크해 주신 다음에 다음 버튼을 클릭합니다. 스마트폰 인증하면 신청이 완료됩니다. 신청이 완료되는 즉시 앱 키와 앱 시크릿 값이 발급됩니다.
이 키들은 여러분의 계좌와 연동된 API를 조작할 수 있는 키이므로 외부에 유출되지 않도록 주의해야 합니다. 이 키 값들을 복사해서 별도의 메모장이나 파일에 비밀번호를 걸어 잘 보관해 둡니다. 실제 알고리즘 투자에 활용하려면, 시스템 환경변수로 설정하여 활용할 수 있습니다. 이 방법에 대해서는 아래의 ‘함께 참고하면 좋은 글’(1) 바이낸스 API 보안을 위한 리눅스 환경 변수 설정, (2) 바이낸스 API 보안을 위한 환경 변수 설정 : 윈도우 10에 잘 정리해 두었습니다.
마치며 …
알고리즘 투자 시스템을 구축하는 과정에서 신뢰할 수 있는 API를 선택하는 것은 매우 중요합니다. 한국투자증권의 API는 다양한 플랫폼에서 작동하며, REST API와 WebSocket 방식을 지원하여 투자자들에게 유연한 선택지를 제공합니다. 특히, 통합증거금과 해외 주식 투자 지원 등의 기능을 통해 더욱 효율적인 투자 환경을 제공받을 수 있습니다.
이번 포스팅에서는 한국투자증권 API 신청 과정을 자세하게 알아보았습니다. 차근차근 따라가다보면 어느새 APP Key, APP Secret을 복사할 수 있는 화면에 도달하실 겁니다.
함께 참고하면 좋은 글
▶ 바이낸스 API 보안을 위한 리눅스 환경 변수 설정
▶ 바이낸스 API 보안을 위한 환경 변수 설정 : 윈도우 10
▶ 한국투자증권 파이썬 패키지 pykis로 준비하는 알고리즘 투자
▶ RESTful API : 웹 애플리케이션 개발자를 위한 기초부터 실전까지
▶ 파이썬 데이터 분석을 위한 API 이해, REST API, WebSocket API
▶ 파이썬 바이낸스 API로 시계열 데이터를 가져오는 파이썬 프로그래밍
▶ 업비트 REST API를 이용한 비트코인 가격 추출 파이썬 프로그래밍
▶ 파이썬 pyplot 캔들스틱 차트, 스토캐스틱 RSI 차트