KIS Trader
한국투자증권 KIS Open API “비공식” 파이썬 클라이언트
소개
한국투자증권(KIS) Open API를 파이썬에서 쉽게 쓰기 위한 클라이언트입니다. 시세 조회부터 주문·계좌·순위까지 자산군별로 정리된 메서드 하나로 부릅니다.
설치
pip install kis-trader # 파이썬 3.11+예시
from kis_trader import KISClient
kis = KISClient(app_key="…", app_secret="…", account="12345678-01") # 세션 열기
kis.domestic.stock("005930").quote() # 삼성전자 현재가
kis.overseas.stock("AAPL").quote() # AAPL (거래소 자동)
kis.domestic.ranking.by_change(direction="gainers") # 오늘 상승률 순위이 문서는
투자자가 실제로 하는 일 위주로 코드와 함께 설명합니다. 왼쪽 차례는 파트로 묶여 있습니다.
| 파트 | 장 |
|---|---|
| 시작하기 | 빠른 시작 · 앱키 발급 · 자격증명과 프로필 |
| 국내 주식 | 시세 보기 · 재무·실적 · 종목 수급 · 계좌·잔고·손익 · 주문 |
| 시장·검색 | 순위·조건검색 · 시장·지수 · 기업행위·일정 |
| 해외·연금 | 해외주식 · 퇴직연금 |
| 다른 상품 | ETF·ETN · ELW · 선물·옵션 · 채권 |
| 명령줄·에이전트 | Command Line · Claude Code Skill · Codex Skill · MCP 서버 |
| 참고 | 실시간(WebSocket) · 한계·미구현 |
알아둘 것
- 대상: 국내 KIS 사용자. 메서드 이름은 영어, 각 메서드 설명(파라미터·필드)은 한국어 docstring에 있습니다 — 궁금하면
help(kis.domestic.stock)처럼 바로 확인. - 결과는 읽기전용 객체입니다.
.current_price(현재가)처럼 영어 이름의 필드로 꺼내 쓰고, 원본 응답 전체는._raw에 있습니다. - 주문은 안전 우선입니다. 오확정 금지·재시도 금지 등 안전장치는 주문 참고.