Release Notes

릴리스 노트

v2.1.0 (2026-07-15) — 비밀번호 프롬프트 제거

모든 명령이 프롬프트 없이 동작합니다. 앱 자체 비밀번호/Fernet 암호화 계층을 제거하고 appkey/secretkey를 OS 키체인에 직접 저장합니다.

Changed

• 인증정보 저장 방식 변경 (breaking): config setup, auth login, auth logout에서 더 이상 비밀번호를 묻지 않습니다. OS 키체인이 암호화 경계 — gh/aws/docker와 동일 모델. (보안 참고)
• 기존 사용자는 업그레이드 후 kiwoom config setup을 한 번 다시 실행해야 합니다 (이전 암호화 형식 자동 감지 + 안내 메시지, 토큰은 유지).
• 키링 접근 오류(헤드리스/CI 환경)는 안전하게 처리되어 --help 등이 절대 크래시하지 않습니다.

Removed

• secure_store.py (Fernet 암호화 저장소) 및 cryptography 의존성 제거.

v2.0.0 (2026-07-15) — 미국주식 지원

키움 REST API의 미국주식 29개 엔드포인트를 기존 명령 체계에 그대로 통합한 메이저 릴리스입니다. 자세한 사용법: 미국주식

⚠️ 라이선스 변경 (MIT → Source-Available) — v2.0.0부터 kiwoom-cli Source-Available License v1.0을 적용합니다. 개인은 영리 목적(자기 계좌 매매 등)을 포함해 자유롭게 사용/수정/배포 가능(출처 표기만). 조직의 영리 사용은 상용 라이선스가 필요합니다. v2.0 이전 릴리스는 계속 MIT로 제공됩니다. LICENSE · COMMERCIAL.md

새 기능

• 자동 시장 라우팅 — 6자리 숫자(005930)는 국내, 알파벳 티커(NVDA, BRK.B)는 미국으로 자동 판별
• 미국주식 주문 — order buy/sell/modify/cancel이 미국 티커를 그대로 지원. 소수점 가격, vwap/twap/loc/moc/stop/stop-limit 주문유형
• 거래소 자동 판별 — NASDAQ/NYSE/AMEX 자동 감지 + 캐시. 복수 상장 종목만 --exchange 지정
• 통합 계좌 뷰 — account balance/deposit/pnl/orders/history가 국내+미국을 한 테이블로 (원화 총계, --market kr|us 필터)
• 미국 시세/차트 — stock info/price/orderbook/search와 차트 6종 (--krw 원화 환산)
• 환전 — account exchange rate|estimate|apply
• AI/자동화 — 통합 명령의 JSON이 단일 {"kr","us"} 문서 출력

내부

• API 레지스트리 188 → 217개 (REST), 테스트 155 → 245개

v1.1.x — 기능 확장

• stock compare — 복수 종목 지표 비교
• stock sync / stock search — 전 시장 종목 리스트 캐시 + 검색
• watch — Rich Live 실시간 TUI 대시보드
• dashboard — 계좌 요약 + 거래량 상위 한 화면
• 멀티 프로필 (--profile, config use, KIWOOM_PROFILE)
• Windows 토큰 저장 오류 수정

v1.0 — 최초 릴리스

• 키움증권 REST API 188개 + WebSocket 실시간 19종
• stock/account/order/market/stream 명령 그룹
• Rich 테이블 / JSON / CSV 출력, exit code 계약
• OS 키체인 기반 인증정보 저장

---

전체 커밋 수준 변경 내역은 GitHub Releases와 CHANGELOG.md를 참고하세요.