키움 REST API 이용안내
01. 계좌 개설하기
키움 REST API 사용을 위해서는 키움증권 계좌개설이 필요합니다.
02. 서비스 신청하기
그림 1. 키움 REST API 홈페이지
포털사이트 우측 상단 'API 사용신청' 버튼을 누르면 로그인 화면이 뜹니다.
그림 2. 키움 REST API 로그인
로그인을 완료하시면 OPEN API 서비스 신청하기 화면으로 이동합니다.
03. 약관 및 유의사항 확인
그림 3. API 사용신청
고객 이용약관, 필수 개인(신용)정보 수집/이용/제공 동의서 및 하단 안내사항 정독 후 '신청하기' 버튼을 눌러주세요.
그림 4. API 신청 카카오톡 알림 메시지 수신
신청이 완료되면 카카오톡 알림톡으로 메시지가 발송됩니다.
04. 계좌 APP KEY 관리 이동
그림 5. 계좌 APP KEY 관리 탭
키움증권은 실제 투자와 모의투자 App Key를 별도로 관리합니다. 실제 투자의 경우 '계좌 App Key 관리' / 모의 투자의 경우 '모의투자 App Key 관리' 탭을 통해 확인해주시기 바랍니다.
App Key 발급을 위해 IP 등록이 필요합니다. 키움증권은 사용자 인증정보 탈취 방지를 위해 IP를 수집하며, 허용된 IP에서만 API 인증이 가능합니다.
이용하시려는 IP 주소를 입력하여 등록해주시기 바랍니다. (고객님의 현재 IP는 '현재 나의 IP'로 확인하실 수 있습니다.)
그림 6. IP 추가화면
IP 등록 현황에서 등록된 IP를 확인할 수 있습니다. IP 등록은 10개까지 가능하며, 사용하지 않는 IP는 삭제하여 관리해주시기 바랍니다.
05. 계좌 등록하기
그림 7. 계좌 등록하기 팝업 1
IP 등록 후 하단의 '계좌 등록하기 버튼'을 누르면 '계좌 등록하기' 팝업이 뜹니다.
그림 8. 계좌 등록하기 팝업 2
비밀번호 입력 후 '확인' 버튼을 눌러주세요.
그림 9. 계좌 등록하기 팝업 3
비밀번호 인증이 완료되면 '성공' 버튼을 통해 확인할 수 있습니다. 계좌 선택을 통해 실전투자, 모의투자 각각 10개까지 추가 계좌 등록이 가능합니다.
그림 10. SMS 인증
SMS 인증을 통해 계좌 등록을 진행해주세요. 인증번호를 발송하시고, 핸드폰으로 수신한 인증번호를 입력해주세요.
그림 11. 계좌 등록하기 팝업 4
계좌 추가 확인 팝업 화면의 '확인' 버튼을 눌러주세요.
그림 12. 계좌 등록 카카오톡 알림메세지 수신
계좌 등록이 완료되면 카카오톡 알림톡으로 메시지가 발송됩니다.
06. App Key, App Secret
그림 13. 신청현황 표
우측의 App Key, App Secret 옆 다운로드 하기를 통해 App Key와 App Secret를 다운로드 받으세요. 다운로드는 1회만 가능하며 이후 비활성화 됩니다. 다운로드 폴더에 계좌번호_appkey.txt, 계좌번호_appsecret.txt 파일에서 값을 확인해주세요.
07. 접근 토큰 발급
그림 14. API 가이드 > 접근토큰발급
API 가이드 내 OAuth인증 카테고리에서 접근토큰발급 TR을 확인해주세요. API 인증은 OAuth 2.0 방식을 따르며 클라이언트 자격 증명(Client Credentials Grant) 방식을 사용하여 App Key와 App Secret을 통해 인증을 수행하며 이를 통해 접근 토큰을 발급할 수 있습니다. 접근토큰의 유효기간은 24시간이며, 매 24시간마다 재발급이 필요합니다. 개발 시 참고하시기 바랍니다.