Home

kiwoom-cli Wiki

키움증권 REST API 전체를 터미널에서. 시세 조회부터 주문, 실시간 스트리밍, 미국주식까지 — 236개 API (REST 217 + WebSocket 19)를 명령어 하나로.

pip install kiwoom-cli
kiwoom config setup      # appkey/secretkey → OS 키체인 (비밀번호 없음)
kiwoom auth login        # 토큰 발급
kiwoom stock info 005930 # 바로 사용

🆕 최근 업데이트

버전	내용
v2.1 (2026-07)	비밀번호 프롬프트 완전 제거 — 인증정보를 OS 키체인에 직접 저장. 모든 명령이 프롬프트 없이 동작 (AI 에이전트·자동화 친화)
v2.0 (2026-07)	미국주식 지원 — 티커 자동 라우팅(NVDA → 미국), 소수점 가격, stop/vwap/twap 주문, 환전, 국내+미국 통합 잔고. 라이선스 MIT → Source-Available 전환

전체 내역: 릴리스 노트

📚 문서

시작하기

• 시작하기 — 설치, 초기 설정, 첫 명령어
• 명령어 가이드 — 전체 명령어 트리 및 공통 옵션
• 출력 형식 — 테이블 / JSON / CSV, exit code

명령어 레퍼런스

• 종목 조회 — stock 그룹 (시세, 차트, 투자자, 분석)
• 계좌 조회 — account 그룹 (잔고, 손익, 환전)
• 주문 — order 그룹 (매수/매도, 신용, 금현물, 조건검색)
• 시장 정보 — market 그룹 (순위 28개, 업종, 테마, ETF, ELW)
• 실시간 스트리밍 — WebSocket 19개 실시간 타입, TUI

가이드

• 미국주식 — 티커 자동 라우팅, 미국 주문유형, 환전, 통합 잔고
• AI 에이전트·자동화 — JSON 출력, exit code, 프롬프트 제로 설계
• 멀티 프로필 — 계좌별 프로필 관리
• 보안 — OS 키체인 모델, 주문 확인 게이트

프로젝트

• 릴리스 노트 — 버전별 변경 내역
• 개발 가이드 — 기여, 아키텍처, 테스트

왜 kiwoom-cli인가

• 236개 API 전체 커버 — 시세·차트·계좌·주문·순위·업종·테마·ETF·ELW·금현물·미국주식
• 프롬프트 제로 — gh/aws/docker와 같은 OS 키체인 모델. 크론잡·CI·AI 에이전트가 그대로 실행
• AI 에이전트 퍼스트 — 구조화된 JSON, 일관된 exit code, 명시적 --confirm 주문 게이트
• 미국주식 자동 라우팅 — 005930은 국내, NVDA는 미국. 통합 잔고를 원화 총계로
• 사람에게도 친절 — Rich 테이블, 실시간 TUI, shell 자동완성

버전

현재: v2.1.0 | Python 3.10–3.13 | Source-Available License (v2.0 이전은 MIT)