키움증권 REST API 파이썬 자동매매 가이드

한눈에 보기

파이썬 자동매매 연동 순서

1. 키움증권 계좌를 준비합니다.
2. 키움 REST API 사이트 우측 상단의 [API 사용신청]을 진행합니다.
3. 앱키와 앱시크릿을 발급받습니다.
4. 허용 IP에 내 PC의 IP와 자동매매할 서버의 IP를 등록합니다.
5. 설정 파일(yaml)의 계좌 항목에 앱키·앱시크릿을 넣습니다. 모의투자는 VIRTUAL 항목에 모의 계좌용 키를 넣습니다.
6. 조회부터 테스트한 뒤(잔고 → 보유종목 → 현재가), 주문은 마지막에 가장 작은 수량으로 확인합니다.

게만아 공통모듈로 쓰면

키움증권 공통모듈도 한국투자·LS·DB증권과 같은 함수 규격입니다. 한국투자증권용으로 작성된 주식 봇을 키움증권용으로 바꿀 때는 KIS_Common ↔ KIW_Common, KIS_API_Helper_KR ↔ KIW_API_Helper_KR로 바꿔 쓰거나, 증권사 설정 값을 바꾸는 방식을 씁니다.

Broker = "KIW"        # 증권사 선택(KIS / DBI / LS / KIW / TOSS / KB / NH / MR)
Market = "KR"          # KR=국내주식 / US=미국주식
accountMode = "REAL"    # yaml 설정의 계좌명(REAL·REAL2·VIRTUAL 등)

한국투자·LS·DB·토스와 같은 규격: 잔고 GetBalance · 보유종목 GetMyStockList · 현재가 GetCurrentPrice · 시장가·지정가 주문 등

멀티 증권사 구조와 비교 보기 →

실전에서 주의할 점

• IP가 바뀌면 매매가 멈출 수 있습니다. 서버를 옮기거나 공인 IP가 바뀌면 허용 IP를 다시 등록하세요. 그래서 24시간 운용에는 고정 IP 서버가 권장됩니다.
• 계좌를 여러 개 쓸 때 토큰 파일 경로가 겹치면 안 됩니다. REAL과 REAL2의 토큰 저장 경로는 서로 달라야 합니다.
• 국내(KR)와 미국(US) Helper를 구분해 쓰세요. 봇의 Market 값으로 선택하며, 시장별 거래 시간과 주문 유형은 공식 문서에서 확인하세요.
• 게만아 포스팅 시점에는 키움이 REST API 이용 매매에 수수료 혜택을 안내했습니다. 현재 조건은 키움증권 공지를 확인하세요.
• API Key·Secret·접근 토큰은 비밀번호와 같습니다. 노출됐다면 폐기 후 재발급하세요.

함께 보기

토스증권 Open API · 한국투자증권 Open API · 무료 Starter로 먼저 체험하기 · 게만아 패키지 · API가 처음이라면 용어 풀이