키움증권 API 신청 페이지는 처음 보면 어디를 눌러야 할지 헷갈리는 구조입니다. 공식 안내 페이지를 따라가 보면 신청 순서 자체는 생각보다 단순하게 짜여 있습니다. 사용 등록, 모듈 설치, 로그인 접속, 이렇게 세 단계로 나뉘어 있으니 순서대로 따라가면 됩니다. 다만 키움증권 API 서비스는 3개월 동안 접속하지 않으면 매월 첫 영업일에 자동 해지됩니다. 공식 가이드에는 발급 키를 따로 받는 단계가 나오지 않아서 처음에는 헷갈리기 쉽습니다. 신청 순서와 헷갈리기 쉬운 주의점을 아래 소제목별로 나눠 정리했습니다.
키움증권 API 핵심 요약
- 신청 경로: 홈페이지 다운로드 메뉴의 Open API 탭에서 사용 등록
- 설치 대상: 키움 Open API+ 모듈(공식 개발 환경은 Windows COM 버전)
- 로그인 방식: 키움 아이디 로그인창, 별도 발급 키 단계는 공식 가이드에 없음
- 자동 해지: 3개월 단위로 미접속 시 매월 첫 영업일에 자동 해지
- 모의투자: 상시모의투자 메뉴에서 별도 신청 후 로그인창에서 모의투자 접속 항목 체크
- 비용: 수수료율은 상품별로 다르므로 공식 표에서 확인
아래에서 신청 순서부터 맥·파이썬 사용 조건, 자동 해지 기준까지 순서대로 짚겠습니다.
키움증권 API 사용 등록 신청 순서
사용 등록은 홈페이지 다운로드 메뉴의 Open API 탭에서 신청합니다.
- 홈페이지 고객서비스 메뉴의 다운로드 화면으로 이동
- Open API 탭에서 키움 Open API+ 서비스 사용 등록 탭 선택
- 사용 등록 완료 후 키움 Open API+ 모듈을 다운로드해 설치
등록만으로 끝나지 않습니다. 모듈까지 설치해야 TR 조회와 로그인 창을 쓸 수 있습니다.
키움증권 API 설치 환경과 맥·파이썬 사용 여부
공식 개발 환경은 Windows COM 버전으로 안내되어 있어 설치 전에 OS부터 확인해야 합니다.
맥 사용 제한 여부
맥은 OCX 컨트롤 방식과 맞지 않아 공식 모듈이 그대로 실행되지 않는 것이 일반적입니다. 맥 환경에서 쓰려면 별도의 우회 방법을 찾아야 하는데, 이 글에서는 공식 자료가 지원하는 범위만 다룹니다.
파이썬 연동 시 비트 확인
파이썬에서는 보통 COM 연동 라이브러리로 OCX를 호출합니다. 오픈소스 중에는 프록시 프로그램을 따로 띄워 64비트 환경을 제공하는 방식도 있습니다.
주의: 공식 OCX는 32비트 환경에서 쓰는 경우가 많습니다. 64비트 파이썬을 설치했다면 연동 전에 비트 수부터 맞추세요.
키움증권 API 모의투자 접속과 자동 해지 기준
모의투자는 상시모의투자 메뉴에서 따로 신청해야 하고, 로그인 창에서 모의투자 접속 항목을 체크해야 합니다.
| 항목 | 조건 | 비고 |
|---|---|---|
| 모의투자 신청 | 상시모의투자 메뉴 | 별도 신청 |
| 자동 해지 | 3개월 단위 미접속 | 매월 첫 영업일 |
| 중복 로그인 | 모의투자 서버 제한 | 동시 접속 제한 |
자동 해지되면 서비스를 다시 등록한 뒤에 사용할 수 있습니다. 모의투자 서버는 과도한 데이터 조회를 막으려고 중복 로그인을 제한하고 있습니다.
키움증권 API 발급과 비용 확인 기준
발급 과정에 별도 키를 받는 절차는 확인되지 않았고, 비용은 상품별 수수료율 표에서 확인해야 합니다.
키움증권 키움 Open API+ 란 안내 페이지에는 사용 가능 상품과 적용 수수료율을 포함한 표가 있습니다. 사용 등록 상태와 자동 해지 조건도 같은 페이지 흐름에서 함께 확인할 수 있습니다.
key 발급 단계 확인
확인한 공식 가이드 기준으로는 키움 아이디로 로그인창에 접속하는 흐름만 나와 있습니다. 그래서 별도 key를 발급받아야 한다는 전제는 맞지 않습니다.
TIP: 수수료율은 상품과 조건에 따라 다르므로 금액을 단정하지 말고 표 항목 기준으로 확인하세요.
키움증권 API 실시간 조회와 문서 확인 방법
데이터 요청과 수신은 TR 서비스명을 검색한 뒤 OCX로 API 함수를 호출하는 방식입니다. 실시간 항목의 세부 등록 방법은 공식 명세서에서 따로 확인해야 합니다. 요청 횟수에는 시간당 제한이 있다고 알려져 있으니 구체 수치도 공식 자료로 확인하세요.
문서는 키움증권 OpenAPI+ 개발가이드에서 KOA Studio 사용법과 OpenAPI 명세를 확인할 수 있습니다.
자주 묻는 질문
Q: key 발급은 따로 받아야 하나요?
A: 확인한 공식 가이드에는 별도 발급 단계가 없고 키움 아이디로 로그인하는 방식입니다. 다만 3개월 넘게 접속하지 않으면 자동 해지되니 주기적으로 접속해 두세요.
Q: 맥에서 키움 Open API+를 쓸 수 있나요?
A: 공식 개발 환경은 Windows COM 버전이라 맥에서는 보통 그대로 동작하지 않습니다. 사용 전에는 공식 가이드의 개발환경 항목부터 확인하세요.
Q: 파이썬으로 키움 API를 연동할 수 있나요?
A: OCX를 COM 방식으로 호출해 파이썬 연동은 통상 가능합니다. 32비트 파이썬을 쓰는 경우가 많으니 비트 수부터 맞추세요.
Q: 수수료는 얼마인가요?
A: 수수료율은 상품과 조건에 따라 달라서 금액을 단정하기 어렵습니다. 키움 Open API+ 소개 페이지의 적용 수수료율 표에서 해당 상품 기준으로 확인하세요.
Q: 해외주식도 Open API로 거래할 수 있나요?
A: 이번에 확인한 공식 가이드에는 해외주식 지원 범위가 명확히 나오지 않습니다. 상품별 지원 여부는 공식 명세서나 고객센터에서 따로 확인해야 합니다.
마치며
정리하면 키움증권 API 신청은 사용 등록, 모듈 설치, 로그인 접속 세 단계로 끝납니다. 가장 많이 놓치는 부분은 3개월 미접속 시 자동 해지되는 조건입니다. 2026년 기준으로 공식 가이드에도 같은 내용이 나와 있으니 사용 주기를 정해두세요. 맥을 쓰는 분이라면 OCX 방식이라는 점을 확인하고, 파이썬을 쓴다면 비트 수부터 맞추세요. 수수료와 해외주식 지원 범위는 상품별 표에서 직접 확인하는 것이 안전합니다. 다만 일반 정보이니 실제 투자 판단이나 신청 조건은 키움증권 고객센터에서 한 번 더 확인하시길 권해드립니다. 신청 후 3개월 뒤 접속 기록이 남아 있는지부터 확인해 보세요.