키움 REST API · 설치 가이드

키움 REST API
인증키(App Key) 발급 가이드

프로그램이 키움증권과 연결되려면 App Key(앱키)와 App Secret(앱시크릿)이 필요합니다. 이 두 개를 키움 홈페이지에서 발급받아 프로그램에 넣어주면 실행됩니다. 아래 순서대로 천천히 따라오세요.

💡 영웅문(HTS) 로그인이 아닙니다. REST API 방식은 아이디/비밀번호로 연결하는 게 아니라, 아래에서 발급받는 App Key · App Secret으로 연결됩니다. 처음 보시는 화면이라 낯설 수 있어요 — 막히면 맨 아래 채팅 안내를 보세요.
STEP 1

키움 REST API 포털 접속 · 로그인

  1. 주소창에 openapi.kiwoom.com 입력해 접속 (‘apiportal’ 아님 — openapi 입니다)
  2. 오른쪽 위 로그인 → 키움증권 계정(공동인증서/간편인증/아이디)으로 로그인
키움 REST API 로그인 화면
STEP 2

‘API 신청/해지’ 탭에서 API 사용 등록

먼저 REST API 서비스 자체를 켜야 합니다.

  1. 상단 API 사용신청 → API 신청/해지 탭
  2. 맨 아래 오픈 API 서비스 이용약관 확인 후 동의 체크 → 신청
  3. ‘키움 REST API 신청 현황’ 표에 상태: 등록 으로 뜨면 완료
API 신청/해지 상태 등록 화면
STEP 3

‘계좌 App Key 관리’ 탭 → 내 PC IP 등록

상단 계좌 App Key 관리 탭으로 이동합니다. (‘모의투자’ 아님)

  1. IP 등록 및 현황에서 ‘현재 나의 IP’ 주소 확인 (예: 115.138.■■■.■■■)
  2. 그 주소를 IP 주소등록 입력란에 넣고 추가 → 아래 표에 올라오면 완료 (최대 10개)
💡 ‘잘못된 IP 형식입니다’가 뜨면 앞뒤 공백·특수문자를 확인하세요. IP는 숫자.숫자.숫자.숫자 형식입니다.
🔒 스크린샷엔 실제 IP를 가리세요 (115.138.■■■.■■■). IP는 접속 위치 정보입니다.
IP 등록 화면
STEP 4

자동매매에 쓸 계좌 등록

App Key는 계좌별로 발급되므로, 먼저 사용할 계좌를 등록해야 합니다. 이 단계를 건너뛰면 ‘인증된 계좌가 없습니다’ 가 떠요.

  1. 같은 화면 맨 아래 ‘계좌 등록하기’ 버튼 클릭
  2. 자동매매에 쓸 실전투자 계좌 선택·등록
  3. 표에 계좌주·계좌번호·구분(실전투자)·만료일이 뜨면 완료
계좌 등록 화면
STEP 5

App Key · App Secret 다운로드 (⚠️ 1회만 가능)

등록된 계좌 행 오른쪽 다운로드하기에서 발급받습니다.

  1. App Key 다운로드 → App Secret 다운로드 (각각 버튼)
  2. 받은 값을 안전한 곳에 꼭 저장하세요
⚠️ App Key·App Secret은 1회만 다운로드 가능하고 이후 비활성화됩니다. 잃어버리면 ‘갱신’으로 재발급해야 해요. 받자마자 파일·메모장에 보관하세요.
App Key 다운로드 화면
STEP 6

발급받은 키를 프로그램에 입력

여기까지 하면 발급은 끝입니다. 이제 AppKey · SecretKey · 계좌번호를 사용하는 프로그램에 입력하면 연결됩니다. 대부분의 프로그램은 아래처럼 ‘API 설정’ 창에 붙여넣는 방식입니다.

  1. 프로그램 실행 → ‘API 설정 (키·계좌)’ 메뉴/버튼 열기
  2. 창에 AppKey · SecretKey · 계좌번호(STEP 4에서 등록한 계좌) 붙여넣기
  3. ‘저장 후 연결’ → 자동으로 저장·연결됩니다 (.env 파일을 직접 만들 필요 없음)
프로그램 API 설정 창
💡 실전투자면 ‘모의투자 서버 사용’은 체크 해제 하세요. SecretKey는 안 보이게(●●●) 입력되며 ‘SecretKey 표시’로 확인할 수 있어요.
📄 만약 이런 ‘API 설정’ 창이 없고 .env 파일을 직접 만들라고 안내된 프로그램이면, 동봉된 사용설명서의 .env 방법을 따르세요.
STEP 7

연결 확인 후 시작

  1. ‘저장 후 연결’ 후, 프로그램에 ‘● API: 연결됨’ 표시가 뜨면 성공
  2. 종목·투자금·전략 설정을 확인하고 프로그램에서 운영(자동매매)을 시작합니다

막히는 부분은 채팅으로 물어보세요

어느 단계에서 막히시는지 채팅으로 말씀해주시거나, 지금 화면을 📎로 캡처해서 보내주시면
담당자가 화면을 보고 다음 단계를 바로 알려드립니다.

채팅으로 물어보기