한국투자증권 오픈API(KIS Developers) 완벽 가이드 — 국내 유일 REST API로 자동매매 시작하기

안녕하세요. 수수입니다.

주식 자동매매를 하려면 증권사 API가 필요합니다. 그런데 국내 대부분의 증권사 API는 Windows 전용입니다. 키움증권의 Open API+는 OCX 모듈 기반이고, 대신증권의 CYBOS Plus는 COM 기반 — 맥북이나 리눅스 서버에서는 쓸 수 없습니다.

한국투자증권 KIS Developers는 국내에서 유일하게 순수 REST API를 제공하는 증권사 플랫폼입니다. 2022년 4월 출시 이후 꾸준히 기능이 확장되어, 지금은 국내주식·해외주식·채권·파생상품까지 API로 거래할 수 있고, 최근에는 AI(LLM) 연동용 MCP 프로토콜까지 지원합니다.

오늘은 KIS Developers의 가입부터 인증, 핵심 기능, Python 라이브러리, 그리고 다른 증권사 API와의 비교까지 깔끔하게 정리합니다.

목차

• 30초 핵심 요약
• KIS Developers란?
• API 키 발급 절차 (5단계)
• 인증 구조 (OAuth 2.0)
• REST API vs WebSocket — 언제 뭘 쓸까?
• 주요 API 엔드포인트
• 모의투자 vs 실전투자
• API 호출 제한 (Rate Limit)
• Python 개발 환경
• 실전 코드 예제: 현재가 조회
• 실전 코드 예제: 주식 매수 주문
• 국내 증권사 API 비교
• 주요 활용 사례
• 시작하기 전 체크리스트
• 2025~2026년 최신 업데이트
• 마치며

30초 핵심 요약

• 국내 유일 REST API: Windows 종속 없이 macOS·Linux·클라우드 서버에서 개발 가능
• 제공 범위: 국내주식, 해외주식(미국·일본·홍콩·중국·베트남), 채권, 선물옵션
• 인증 방식: App Key + App Secret → OAuth Access Token (24시간 유효)
• 실시간 데이터: WebSocket으로 실시간 체결가·호가·주문체결 통보 수신
• Python 생태계: 공식 샘플 + 커뮤니티 라이브러리(python-kis, pykis, mojito2)
• 최신 기능: 전략 빌더, 백테스터, MCP(AI 연동) 프로토콜 지원

KIS Developers란?

KIS Developers는 한국투자증권이 운영하는 오픈API 개발자 플랫폼입니다.

기존 증권사 API와 가장 큰 차이는 HTS 접속이나 별도 프로그램 설치 없이, HTTP 요청만으로 주식 매매가 가능하다는 점입니다.

API 키 발급 절차 (5단계)

Step 1: 한국투자증권 계좌 개설

실전투자를 하려면 한국투자증권 종합 계좌가 필요합니다. 모의투자만 할 경우 모의투자 전용 계좌를 별도로 신청합니다.

Step 2: KIS Developers 서비스 신청

한국투자증권 홈페이지 > 서비스신청 > Open API > KIS Developers > 서비스 신청하기

Step 3: 본인 인증

인증서 로그인 + 휴대폰 인증을 진행합니다.

Step 4: 계좌번호 선택

사용할 계좌번호를 선택하고 신청을 완료합니다.

Step 5: App Key · App Secret 확인

신청 완료 후 신청현황 테이블에서 App Key와 App Secret을 확인할 수 있습니다.

⚠️ 보안 주의: App Key와 App Secret은 계좌 접근 암호키입니다. 절대 타인에게 유출하지 마세요. GitHub에 하드코딩하는 실수도 금물! 유출 시 즉시 재발급하세요.

인증 구조 (OAuth 2.0)

KIS API의 인증은 3단계로 구성됩니다.

App Key + App Secret
       │
       ▼
POST /oauth2/tokenP  ──→  access_token 발급 (24시간 유효)
       │
       ▼
REST API 호출 시 ──→  Authorization: Bearer {access_token}
       │
POST /oauth2/Approval  ──→  approval_key 발급 (WebSocket 전용)
       │
       ▼
WebSocket 연결 시 ──→  approval_key로 인증

REST API vs WebSocket — 언제 뭘 쓸까?

REST API

일회성 요청에 사용합니다. 시세 조회, 주문 실행, 잔고 확인 등.

WebSocket

실시간 스트리밍에 사용합니다. 체결가, 호가, 주문 체결 통보 등.

팁: 단순 조회는 REST, 실시간 모니터링은 WebSocket으로 나눠 설계하면 가장 효율적입니다.

주요 API 엔드포인트

인증

국내주식

해외주식

Base URL:

• 실전: https://openapi.koreainvestment.com:9443
• 모의: https://openapivts.koreainvestment.com:29443

모의투자 vs 실전투자

처음 시작한다면 반드시 모의투자부터 테스트하세요.

코드에서 도메인과 svr 값만 바꾸면 모의 ↔ 실전 전환이 가능합니다.

API 호출 제한 (Rate Limit)

팁: 슬라이딩 윈도우 경계에서 요청이 몰리면 제한에 걸릴 수 있습니다. time.sleep(0.07) 등으로 요청 간격을 두는 것이 안전합니다.

Python 개발 환경

공식 샘플 코드

한국투자증권은 공식 GitHub에서 Python 샘플을 제공합니다.

10가지 프리셋 전략 포함: 골든크로스, 모멘텀, 52주 신고가, 평균회귀 등

커뮤니티 라이브러리

추천: 본격적인 자동매매 시스템을 만든다면 python-kis(Soju06)가 타입 안전성과 WebSocket 자동 복구 면에서 가장 안정적입니다.

실전 코드 예제: 현재가 조회

import requests

# 설정
BASE_URL = "https://openapi.koreainvestment.com:9443"
APP_KEY = "your_app_key"
APP_SECRET = "your_app_secret"
ACCESS_TOKEN = "your_access_token"

# 삼성전자(005930) 현재가 조회
headers = {
    "content-type": "application/json; charset=utf-8",
    "authorization": f"Bearer {ACCESS_TOKEN}",
    "appkey": APP_KEY,
    "appsecret": APP_SECRET,
    "tr_id": "FHKST01010100",  # 국내주식 현재가 조회
}

params = {
    "FID_COND_MRKT_DIV_CODE": "J",   # 주식
    "FID_INPUT_ISCD": "005930",       # 삼성전자
}

res = requests.get(
    f"{BASE_URL}/uapi/domestic-stock/v1/quotations/inquire-price",
    headers=headers,
    params=params,
)

data = res.json()
price = data["output"]["stck_prpr"]  # 현재가
print(f"삼성전자 현재가: {price}원")

실전 코드 예제: 주식 매수 주문

# 삼성전자 10주 시장가 매수
headers = {
    "content-type": "application/json; charset=utf-8",
    "authorization": f"Bearer {ACCESS_TOKEN}",
    "appkey": APP_KEY,
    "appsecret": APP_SECRET,
    "tr_id": "TTTC0802U",  # 국내주식 매수 주문
    "hashkey": "your_hashkey",
}

body = {
    "CANO": "12345678",          # 계좌번호 앞 8자리
    "ACNT_PRDT_CD": "01",        # 계좌상품코드
    "PDNO": "005930",            # 종목코드 (삼성전자)
    "ORD_DVSN": "01",            # 주문구분 (01: 시장가)
    "ORD_QTY": "10",             # 주문수량
    "ORD_UNPR": "0",             # 주문단가 (시장가는 0)
}

res = requests.post(
    f"{BASE_URL}/uapi/domestic-stock/v1/trading/order-cash",
    headers=headers,
    json=body,
)

result = res.json()
print(f"주문 결과: {result['msg1']}")

국내 증권사 API 비교

한국투자증권 API를 선택해야 하는 이유

1. OS 자유: macOS에서 개발하고 Linux 서버에 배포 가능
2. 클라우드 친화: AWS·GCP·Azure 서버에서 바로 실행
3. REST 표준: HTTP 요청만 할 줄 알면 어떤 언어든 사용 가능
4. 해외주식 지원: 미국(NYSE·NASDAQ·AMEX), 일본, 홍콩, 중국, 베트남 등 9개 거래소
5. AI 연동: MCP 프로토콜로 Claude·ChatGPT와 연동 가능

주요 활용 사례

1. 자동매매 시스템

가장 대표적인 활용입니다. 매매 조건을 프로그래밍하여 자동으로 주문을 실행합니다.

• 골든크로스 전략: 5일선이 20일선을 돌파하면 매수
• 모멘텀 전략: 최근 N일 수익률 상위 종목 교체 매수
• 무한매수법 자동화: 라오어의 무한매수법을 API로 자동 실행

2. 실시간 모니터링 대시보드

WebSocket으로 실시간 체결가·호가를 수신하여 나만의 HTS를 만들 수 있습니다.

3. 포트폴리오 관리

잔고 조회 API로 보유종목·평가금액·손익률을 실시간으로 모니터링하고, 텔레그램이나 슬랙으로 알림을 보낼 수 있습니다.

4. 백테스팅 + 실전 배포

공식 strategy_builder로 전략을 설계하고, backtester(QuantConnect Lean)로 과거 데이터 검증 후, 검증된 전략을 실전 API에 연결하는 파이프라인을 구축할 수 있습니다.

5. AI 보조 매매

MCP 프로토콜을 통해 Claude나 ChatGPT에게 “삼성전자 현재가 알려줘”, “TQQQ 10주 매수해줘” 같은 자연어 명령으로 매매를 요청할 수 있습니다.

시작하기 전 체크리스트

• 한국투자증권 계좌 개설 완료
• KIS Developers 서비스 신청 완료
• App Key · App Secret 발급 확인
• Python 3.11+ 환경 준비
• 모의투자 계좌로 충분히 테스트 후 실전 전환
• App Key · App Secret 환경변수 또는 별도 설정파일로 관리 (하드코딩 금지)
• API 호출 간격 설정 (0.07초 이상 권장)

2025~2026년 최신 업데이트

마치며

한국투자증권 KIS Developers는 국내에서 유일하게 OS 제약 없이 사용할 수 있는 증권사 API입니다. REST API 표준을 따르기 때문에 Python뿐 아니라 JavaScript, Go, Rust 등 어떤 언어로든 개발할 수 있고, 클라우드 서버에 배포하기도 쉽습니다.

특히 최근 추가된 전략 빌더·백테스터·MCP 프로토콜은 “코드를 짜서 자동매매를 하고 싶은데, 어디서부터 시작해야 할지 모르겠다”는 분들에게 좋은 출발점이 됩니다.

다만 API를 사용한 자동매매는 버그 한 줄이 실제 손실로 이어질 수 있습니다. 반드시 모의투자에서 충분히 테스트하고, 주문 로직에는 안전장치(최대 주문 금액 제한, 비정상 체결 알림 등)를 넣어두세요.

투자에 대한 최종 판단과 책임은 투자자 본인에게 있습니다. 이 글은 정보 제공 목적이며 특정 투자를 권유하지 않습니다.