1 키움 홈페이지 로그인 · REST API 메뉴

1. 키움증권 홈페이지에 방문 후 증권용 인증서로 로그인합니다.
2. 전체메뉴 → 고객서비스 → 다운로드 → Open API → 키움 REST API를 선택합니다.

키움 REST API 홈 열기

2 API 사용신청 · 약관 동의

API 사용신청 페이지로 이동합니다.

• 키움 REST API 신청 현황이 해지 상태이면, 아래 오픈 API 서비스 이용약관에 동의하고 필수 사항에 모두 체크한 뒤 신청하기로 등록합니다.
• 이미 사용 중이면 다음 단계(IP·계좌)로 진행합니다.

3 계좌 App Key 관리 · IP 주소 등록

신청이 완료되면 계좌 App Key 관리 페이지로 이동합니다.

계좌 App Key 관리

• IP 주소등록: 화면에 표시된 현재 나의 IP를 입력창에 복사한 뒤 추가를 누릅니다.
• 집에서 5G와 일반 와이파이를 모두 쓰면 IP가 달라질 수 있습니다. 와이파이를 바꿔 접속해 보고, 표시되는 IP가 다르면 둘 다 등록하세요. (최대 10개)

4 계좌 등록하기

IP 등록 후 하단 계좌 등록하기를 눌러 자동매매에 사용할 계좌를 등록합니다.

• 팝업에서 계좌번호를 선택하고 계좌 비밀번호를 입력한 뒤 확인 → 성공하면 다음으로 진행합니다.
• 이어서 SMS 인증 화면이 나오면 휴대폰 인증을 완료합니다.
• 계좌를 추가하시겠습니까? 확인으로 API용 계좌 등록을 마칩니다.

5 App Key · App Secret 다운로드·보관

• 계좌가 등록되면 App Key와 App Secret을 다운로드할 수 있습니다.
• 해당 파일은 한 번만 생성·다운로드되며, 이후 버튼이 비활성화됩니다. 파일을 안전하게 보관하거나 열어 키를 복사해 두세요.
• 실전투자 계좌는 보통 파일로 다운로드한 뒤 메모장 등으로 열어 키를 복사합니다.
• 키가 유출되면 즉시 해지 후 새로 신청하세요.

모의투자 계좌가 없을 때

계좌 등록하기를 누르면 모의계좌가 있으면 목록에 나오고, 없으면 모의투자 신청 페이지 바로가기로 이동합니다.

모의투자 홈에서 상시모의투자 → 참가신청/취소 메뉴를 선택합니다.

• 필명(닉네임) 입력
• 국내주식 금액은 여유 있게 1억 정도, 기간은 최대 3개월 권장
• 이용 동의 · 개인정보 필수 동의서(내용보기) 동의 후 참가신청

모의계좌로 REST API 등록

1. 참가신청 후 다시 키움 REST API 관리 → 모의투자 App Key 관리 모의투자 App Key 관리 바로가기
2. 계좌 등록하기 → 방금 신청한 모의투자계좌 선택 → 확인
3. 등록되면 실계좌와 같이 App Key / App Secret을 복사해 별도 보관합니다. 모의 계좌는 파일 다운로드가 되지 않는 경우가 많습니다. 화면에서 바로 복사하세요.
4. 만료일이 지나면 모의투자를 다시 신청한 뒤 REST API 키를 재등록합니다.

1 키움증권 계좌 로그인 화면

1. 알고 주식자동매매를 실행하고 이용자 인증(algotrade 로그인)을 완료합니다.
2. 키움증권 계좌 로그인 창이 열리면 계좌 추가를 누릅니다. (이미 등록된 계좌가 있으면 목록에서 선택한 뒤 로그인)
3. 자주 쓰는 계좌만 쓸 때는 자동 로그인 (5초 후 마지막 계좌로 로그인)을 켜 둘 수 있습니다.

2 계좌 추가 입력

아래 항목을 입력한 뒤 Save로 저장합니다.

• 별칭 — 목록에 표시할 이름 (예: 모의투자, 실전1)
• 증권사 — 키움증권 (기본값)
• 구분 — 모의투자 또는 실전 (App Key 발급 구분과 반드시 일치)
• 계좌번호 — 자동매매에 쓸 키움 계좌
• 계좌비밀번호 — 모의는 보통 0000
• App Key · Secret Key — 키움 REST API에서 발급·복사한 값

3 저장 후 로그인

1. 계좌 추가 창을 닫으면 계좌 로그인 목록에 새 계좌가 나타납니다.
2. 해당 계좌를 선택한 뒤 로그인을 누르면 REST 토큰이 발급되고 당일 매매·조회가 가능합니다.
3. 토큰·API 만료 안내가 뜨면 키움에서 키·IP·모의 기간을 확인한 뒤 다시 로그인하세요.