한국투자증권 Open API를 처음 신청해보려는 분들이 가장 헷갈려하는 부분이 바로 ‘KIS Developers 회원가입’과 ‘증권 계좌 인증’이 각각 별도로 필요하다는 점이에요. 두 단계를 순서대로 짚어가면서 Open API 신청 전체 흐름을 정리해볼게요.
KIS Developers 포털 회원가입부터 시작해요
Open API를 이용하려면 먼저 KIS Developers 웹사이트(apiportal.koreainvestment.com)에 접속해서 회원가입을 해야 해요. 이 회원가입은 한국투자증권 계좌 로그인 아이디와는 별개의 개발자 포털 전용 계정이에요. 회원가입 시 이메일 인증이나 기본 정보 입력 절차를 거치게 돼요.
포털 회원가입이 완료되면 로그인 후 API 신청 메뉴로 들어가 ‘오픈API 이용 신청’을 클릭하고, 약관 동의와 필요한 정보를 입력하는 순서로 진행돼요. 이 단계에서 서비스 이용 약관과 개인정보 처리방침에 동의해야 다음 단계로 넘어갈 수 있어요.
증권 계좌 연동과 인증
포털 가입과 별개로, 실제 API 호출을 위해서는 본인의 한국투자증권 계좌를 연동하고 인증하는 절차가 필요해요. 홈페이지의 [서비스신청 > Open API > KIS Developers > KIS Developers 서비스 신청하기] 메뉴를 통해 접속하거나, KIS Developers 포털 우측 상단의 API신청 버튼을 눌러 계좌 인증 화면으로 이동할 수 있어요.
계좌 인증 단계에서는 먼저 휴대폰 인증을 진행하고, 본인이 개설한 계좌를 선택한 뒤 계좌 비밀번호를 입력해서 인증을 완료해요. 인증이 정상적으로 처리되면 신청 버튼이 활성화되면서 API 이용 신청이 접수돼요.
승인 대기와 앱키 발급
신청이 접수된 이후에는 승인 절차를 거쳐 앱키(App Key)와 비밀키(App Secret)가 발급돼요. 승인 소요 시간은 보통 짧게는 즉시, 길게는 1~2일 정도 걸릴 수 있다고 알려져 있어요. 승인이 완료되면 KIS Developers ID로 로그인해서 발급된 앱키와 비밀키를 확인할 수 있어요.
- App Key / App Secret 발급: 승인 후 포털 마이페이지에서 확인할 수 있어요.
- 임시 비밀번호 알림톡: 서비스 신청 과정에서 카카오 알림톡으로 임시 비밀번호를 받는 경우도 있어요.
- 액세스 토큰 발급: 발급받은 앱키와 비밀키로 API를 호출해 액세스 토큰을 받아야 실제 요청이 가능해요.
모의투자와 실전투자 신청을 구분해서 진행하기
Open API는 모의투자용과 실전투자용을 각각 별도로 신청해야 해요. 모의투자 API를 신청하려면 먼저 홈페이지나 MTS에서 모의투자 서비스를 신청해서 모의계좌번호를 발급받아야 하고, 이 번호로 API 신청을 진행해야 해요. 실전투자 API는 실제 보유한 위탁계좌 정보로 신청하면 돼요.
두 환경은 앱키와 비밀키가 서로 다르게 발급되기 때문에, 개발 코드에서 환경변수나 설정파일로 명확히 구분해서 관리하는 게 실수를 방지하는 데 도움이 돼요. 특히 자동매매 로직을 처음 테스트할 때는 반드시 모의투자 키를 사용해서 검증한 뒤 실전으로 전환하는 순서를 지키는 게 안전해요.
신청 후 첫 API 호출까지 준비하기
앱키와 비밀키를 발급받았다면 공식 GitHub 저장소(open-trading-api)에서 제공하는 예제 코드를 참고해 첫 API 호출을 테스트해볼 수 있어요. 액세스 토큰 발급 요청을 먼저 보내고, 정상적으로 토큰이 발급되면 이 토큰을 이용해 시세 조회나 잔고 조회 같은 기본 기능부터 테스트해보는 게 좋아요.
액세스 토큰은 보통 24시간 동안 유효하기 때문에, 장기간 운영되는 자동매매 프로그램을 만들 계획이라면 토큰 만료 전에 자동으로 갱신하는 로직도 함께 구현해둬야 해요.
정리하면 한국투자증권 Open API 신청은 KIS Developers 회원가입, 계좌 연동 및 인증, 승인 대기, 앱키 발급까지 네 단계로 이뤄져요. 모의투자와 실전투자를 구분해서 신청하고, 발급받은 키는 안전하게 관리하면서 개발을 진행하는 게 중요해요.