-
Notifications
You must be signed in to change notification settings - Fork 1
Home
Yu Jin edited this page Jul 20, 2026
·
5 revisions
키움증권 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.14 (2026-07) |
config show/auth status가 실제 접속 도메인을 보고하고, auth logout이 폐기 응답을 확인한 뒤 성공을 알립니다. 통합 명령에 meta.partial_failures 추가 (breaking) |
| v2.13 (2026-07) |
스트리밍 실패 감지 — 인증·등록 실패가 조용한 exit 0 대신 exit 2·3으로 끝납니다. 실시간 호가(0D) 필드 정규화, market --exchange 기본값이 통합으로 (breaking) |
| v2.12 (2026-07) |
사람이 읽는 옵션 값 147개 — --sort rise-rate, --period six-months 등. raw 숫자코드는 계속 통과하지만 스펙 밖 값은 로컬에서 거부 (breaking) |
| v2.9–v2.11 (2026-07) | 스펙 대조 교정, 시장가 주문의 --price 가드, 가격 필드 타입·부호 정리 (breaking) |
| v2.3–v2.8 (2026-07) |
AI 에이전트 계약 — JSON envelope v1과 타입화된 에러, 정규화된 data·--fields·describe, 주문 안전장치(dry-run/validate/멱등키), 파일 권한·프로필 이름 조임 (breaking) |
| v2.1–v2.2 (2026-07) |
비밀번호 프롬프트 완전 제거 — 인증정보를 OS 키체인에 직접 저장. 키체인이 없는 환경용 KIWOOM_TOKEN 환경변수 |
| v2.0 (2026-07) |
미국주식 지원 — 티커 자동 라우팅(NVDA → 미국), 소수점 가격, stop/vwap/twap 주문, 환전, 국내+미국 통합 잔고. 라이선스 MIT → Source-Available 전환 |
전체 내역: 릴리스 노트
- 종목 조회 — stock 그룹 (시세, 차트, 투자자, 분석)
- 계좌 조회 — account 그룹 (잔고, 손익, 환전)
- 주문 — order 그룹 (매수/매도, 신용, 금현물, 조건검색)
- 시장 정보 — market 그룹 (순위 28개, 업종, 테마, ETF, ELW)
- 실시간 스트리밍 — WebSocket 19개 실시간 타입, TUI
- 미국주식 — 티커 자동 라우팅, 미국 주문유형, 환전, 통합 잔고
- AI 에이전트·자동화 — JSON 출력, exit code, 프롬프트 제로 설계
- 멀티 프로필 — 계좌별 프로필 관리
- 보안 — OS 키체인 모델, 주문 확인 게이트
- 236개 API 전체 커버 — 시세·차트·계좌·주문·순위·업종·테마·ETF·ELW·금현물·미국주식
-
프롬프트 제로 —
gh/aws/docker와 같은 OS 키체인 모델. 크론잡·CI·AI 에이전트가 그대로 실행 -
AI 에이전트 퍼스트 — 구조화된 JSON, 일관된 exit code, 명시적
--confirm주문 게이트 -
미국주식 자동 라우팅 —
005930은 국내,NVDA는 미국. 통합 잔고를 원화 총계로 - 사람에게도 친절 — Rich 테이블, 실시간 TUI, shell 자동완성
현재: v2.14.0 | Python 3.10–3.13 | Source-Available License (v2.0 이전은 MIT)