kiwoom-cli 1.1.3__tar.gz → 2.1.0__tar.gz

kiwoom_cli-2.1.0/LICENSE

@@ -0,0 +1,90 @@
+kiwoom-cli Source-Available License
+Version 1.0
+
+Copyright (c) 2026 gejyn14
+
+This license governs use of the accompanying software ("the Software"). By
+using, copying, modifying, or distributing the Software, You accept this
+license. If You do not accept it, do not use the Software.
+
+Prior released versions of the Software that were distributed under the MIT
+License remain available under the MIT License. This license applies to this
+version and later versions distributed under it.
+
+1. DEFINITIONS
+
+  "Licensor" means gejyn14, the copyright holder, reachable at
+  ge.jyn14@gmail.com.
+
+  "You" means the individual or entity exercising rights under this license.
+
+  "Individual" means a natural person acting on their own behalf and not on
+  behalf of, or for the benefit of, any organization.
+
+  "Organization" means any legal entity other than an Individual, including
+  companies, partnerships, nonprofits, government bodies, and any natural
+  person acting on behalf of or for the benefit of such an entity.
+
+  "Commercial License" means a separate written agreement purchased from the
+  Licensor granting an Organization rights beyond those in this license.
+
+  "For Profit" means any use in connection with, or in furtherance of, a
+  commercial or revenue-generating activity of an Organization.
+
+  "Modify" means to create a work based on the Software, and a "Modified
+  Version" is any such work.
+
+2. GRANT FOR INDIVIDUALS
+
+  If You are an Individual, You are granted a perpetual, worldwide,
+  royalty-free right to use, copy, modify, and distribute the Software for any
+  purpose, including for Your own profit (for example, trading Your own
+  account), subject only to the attribution requirement in Section 5. You have
+  no obligation to disclose source code.
+
+3. GRANT FOR ORGANIZATIONS — UNMODIFIED USE
+
+  If You are an Organization and You use the Software without modification For
+  Profit, You must obtain a Commercial License from the Licensor. Use for
+  internal evaluation, testing, or non-profit purposes is permitted without a
+  Commercial License, subject to the attribution requirement in Section 5.
+
+4. GRANT FOR ORGANIZATIONS — MODIFIED USE
+
+  If You are an Organization and You use a Modified Version For Profit, You must
+  do EITHER (a) or (b):
+
+    (a) Obtain a Commercial License from the Licensor, in which case You may
+        keep Your Modified Version's source code closed to the public; OR
+
+    (b) Publish the complete source code of Your entire work incorporating the
+        Software to the public under this same license.
+
+  In BOTH cases — whether or not You have purchased a Commercial License — You
+  must deliver the complete source code of Your Modified Version to the
+  Licensor at ge.jyn14@gmail.com promptly upon first use For Profit and upon
+  each subsequent material change.
+
+5. ATTRIBUTION
+
+  All copies or substantial portions of the Software, and all distributions of
+  Modified Versions, must retain this license, the above copyright notice, and
+  a notice identifying gejyn14 as the original author.
+
+6. TERMINATION
+
+  Any use in breach of this license automatically terminates Your rights under
+  it. Rights may be reinstated by the Licensor in writing.
+
+7. DISCLAIMER OF WARRANTY AND LIMITATION OF LIABILITY
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+  ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+8. COMMERCIAL LICENSES
+
+  For commercial licensing, contact ge.jyn14@gmail.com.

{kiwoom_cli-1.1.3 → kiwoom_cli-2.1.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: kiwoom-cli
-Version: 1.1.3
+Version: 2.1.0
 Summary: User-friendly CLI for the Kiwoom Securities REST API (키움증권)
-License: MIT
+License: LicenseRef-kiwoom-cli-Source-Available-1.0
 Project-URL: Homepage, https://github.com/gejyn14/kiwoom-cli
 Project-URL: Repository, https://github.com/gejyn14/kiwoom-cli
 Project-URL: Issues, https://github.com/gejyn14/kiwoom-cli/issues
@@ -10,7 +10,7 @@ Keywords: kiwoom,stock,trading,cli,korea,finance
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Financial and Insurance Industry
-Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -26,7 +26,6 @@ Requires-Dist: tomli>=2.0; python_version < "3.11"
 Requires-Dist: tomli-w>=1.0
 Requires-Dist: keyring>=25.0
 Requires-Dist: websockets>=12.0
-Requires-Dist: cryptography>=42.0
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-httpx>=0.30; extra == "dev"
@@ -55,13 +54,13 @@ pip install kiwoom-cli
 ## 시작하기
 
 ```bash
-# 1. 초기 설정 (appkey, secretkey 입력 + 암호화 비밀번호 설정)
+# 1. 초기 설정 (appkey, secretkey 입력)
 kiwoom config setup
 
-# 2. 토큰 발급 (비밀번호 확인 후 발급)
+# 2. 토큰 발급
 kiwoom auth login
 
-# 3. 사용 (토큰 발급 후에는 비밀번호 불필요)
+# 3. 사용 (프롬프트 없음)
 kiwoom stock info 005930
 ```
 
@@ -87,7 +86,7 @@ export KIWOOM_DOMAIN="prod"       # prod 또는 mock
 export KIWOOM_ACCOUNT="1234567"   # 선택
 ```
 
-appkey/secretkey는 보안을 위해 환경변수를 지원하지 않습니다. 반드시 `kiwoom config setup`으로 암호화 저장하세요.
+appkey/secretkey는 보안을 위해 환경변수를 지원하지 않습니다. 반드시 `kiwoom config setup`으로 OS 키체인에 저장하세요.
 
 ### 멀티 프로필
 
@@ -261,6 +260,29 @@ kiwoom account orderable amount 005930 --side buy --price 70000
 
 ---
 
+## 미국주식 (US Stocks)
+
+티커를 입력하면 자동으로 미국 시장으로 라우팅됩니다 (6자리 숫자 = 국내, 알파벳 = 미국).
+
+```bash
+kiwoom order buy NVDA 10 --price 213.04           # 매수 (거래소 자동 판별)
+kiwoom order sell NVDA 5 --type stop-limit --price 200.5 --stop 199.99 --confirm
+kiwoom stock price NVDA                            # 현재가
+kiwoom stock chart day NVDA --base-date 20260701   # 일봉
+kiwoom stock search apple --market us              # 종목 검색
+kiwoom account balance                             # 국내+미국 통합 잔고 (원화 총계)
+kiwoom account balance --market us                 # 미국만
+kiwoom account exchange rate                       # 환율
+kiwoom account exchange apply 1000000 --confirm    # 원화 → 달러 환전
+```
+
+- 거래소(`--exchange nasdaq|nyse|amex`)는 자동 판별되며, 복수 상장 종목만 직접 지정이 필요합니다.
+- 미국 주문 유형: limit/market/vwap/twap/vwap-limit/twap-limit/loc (매수·매도), moc/stop/stop-limit (매도 전용).
+- 정정은 가격만 가능(전량), 취소는 전량 취소만 지원됩니다 (키움 API 제약).
+- 계좌 조회 명령(`balance/deposit/pnl/orders/history`)은 기본 통합 표시이며 `--market kr|us`로 필터링합니다.
+
+---
+
 ## order - 주문
 
 모든 주문에 `--confirm` 필수.
@@ -279,8 +301,8 @@ kiwoom order credit sell 005930 10 --type market --confirm
 
 # 금현물
 kiwoom order gold buy M04020000 1 --type market --confirm
-kiwoom order gold balance --confirm    # 잔고
-kiwoom order gold pending --confirm   # 미체결
+kiwoom order gold balance             # 잔고
+kiwoom order gold pending             # 미체결
 
 # 조건검색
 kiwoom order condition list
@@ -449,7 +471,7 @@ eval (env _KIWOOM_COMPLETE=fish_source kiwoom)
 | 항목             | 값                                       |
 | ---------------- | ---------------------------------------- |
 | 설정 파일        | `~/.kiwoom/config.toml` (도메인, 계좌만) |
-| appkey/secretkey | OS 키체인 (암호화 저장)                  |
+| appkey/secretkey | OS 키체인                                |
 | 토큰             | OS 키체인                                |
 | 캐시 디렉터리    | `~/.kiwoom/cache/`                       |
 | 운영 도메인      | `https://api.kiwoom.com`                 |
@@ -464,19 +486,24 @@ eval (env _KIWOOM_COMPLETE=fish_source kiwoom)
 
 ## 보안
 
-인증정보(appkey, secretkey)는 **OS 키체인에 암호화되어 저장**됩니다. 파일로 존재하지 않으며, 비밀번호 없이는 복호화할 수 없습니다.
+모든 인증정보(appkey, secretkey, 토큰)는 **OS 키체인**(macOS Keychain / Windows Credential Manager / Linux Secret Service)에 저장됩니다. 파일로 존재하지 않으며, 키체인이 디스크 저장 시 암호화를 담당합니다. `gh`, `aws`, `docker` CLI와 동일한 모델입니다.
 
-| 항목               | 저장 방식          |            비밀번호 필요            |
-| ------------------ | ------------------ | :---------------------------------: |
-| appkey / secretkey | 암호화 + OS 키체인 | O (`config setup`, `auth login` 시) |
-| 토큰               | OS 키체인 (평문)   |           X (만료되는 값)           |
-| config.toml        | 도메인, 계좌번호만 |                  X                  |
+| 항목               | 저장 방식          | 프롬프트 |
+| ------------------ | ------------------ | :------: |
+| appkey / secretkey | OS 키체인          |    X     |
+| 토큰               | OS 키체인          |    X     |
+| config.toml        | 도메인, 계좌번호만 |    X     |
 
-- `config setup` 시 설정한 비밀번호로 appkey/secretkey를 암호화
-- `auth login/logout` 시 비밀번호 확인 후 키체인 접근
-- 토큰 발급 후 일반 명령어는 비밀번호 없이 사용
-- `keyring.get_password()`로 직접 접근해도 암호화된 값만 반환
+- 모든 명령어는 비밀번호/생체인증 프롬프트 없이 동작 (AI 에이전트·자동화 친화적)
+- 앱 자체 암호화 계층은 의도적으로 두지 않음 — 추가 계층은 명령마다 잠금 해제 프롬프트를 요구하게 되어 CLI 사용성을 해침
+- v2.0 이하에서 업그레이드한 경우: 암호화 저장소 형식이 제거되어 `kiwoom config setup`을 한 번 다시 실행해야 합니다
 
 ## License
 
-MIT
+kiwoom-cli **Source-Available License, Version 1.0** — see [LICENSE](LICENSE).
+
+- **Individuals** (natural persons, on their own behalf): free to use, modify, and distribute for any purpose, including profit (e.g. trading your own account). Attribution only; no source-disclosure obligation.
+- **Organizations, unmodified use for profit**: require a commercial license.
+- **Organizations, modified use for profit**: either buy a commercial license (source may stay closed) or publish your entire codebase under this same license — and in both cases deliver the full modified source to the Licensor.
+
+Versions released before v2.0 remain available under the MIT License. For commercial licensing, contact ge.jyn14@gmail.com — see [COMMERCIAL.md](COMMERCIAL.md).

{kiwoom_cli-1.1.3 → kiwoom_cli-2.1.0}/README.md

@@ -17,13 +17,13 @@ pip install kiwoom-cli
 ## 시작하기
 
 ```bash
-# 1. 초기 설정 (appkey, secretkey 입력 + 암호화 비밀번호 설정)
+# 1. 초기 설정 (appkey, secretkey 입력)
 kiwoom config setup
 
-# 2. 토큰 발급 (비밀번호 확인 후 발급)
+# 2. 토큰 발급
 kiwoom auth login
 
-# 3. 사용 (토큰 발급 후에는 비밀번호 불필요)
+# 3. 사용 (프롬프트 없음)
 kiwoom stock info 005930
 ```
 
@@ -49,7 +49,7 @@ export KIWOOM_DOMAIN="prod"       # prod 또는 mock
 export KIWOOM_ACCOUNT="1234567"   # 선택
 ```
 
-appkey/secretkey는 보안을 위해 환경변수를 지원하지 않습니다. 반드시 `kiwoom config setup`으로 암호화 저장하세요.
+appkey/secretkey는 보안을 위해 환경변수를 지원하지 않습니다. 반드시 `kiwoom config setup`으로 OS 키체인에 저장하세요.
 
 ### 멀티 프로필
 
@@ -223,6 +223,29 @@ kiwoom account orderable amount 005930 --side buy --price 70000
 
 ---
 
+## 미국주식 (US Stocks)
+
+티커를 입력하면 자동으로 미국 시장으로 라우팅됩니다 (6자리 숫자 = 국내, 알파벳 = 미국).
+
+```bash
+kiwoom order buy NVDA 10 --price 213.04           # 매수 (거래소 자동 판별)
+kiwoom order sell NVDA 5 --type stop-limit --price 200.5 --stop 199.99 --confirm
+kiwoom stock price NVDA                            # 현재가
+kiwoom stock chart day NVDA --base-date 20260701   # 일봉
+kiwoom stock search apple --market us              # 종목 검색
+kiwoom account balance                             # 국내+미국 통합 잔고 (원화 총계)
+kiwoom account balance --market us                 # 미국만
+kiwoom account exchange rate                       # 환율
+kiwoom account exchange apply 1000000 --confirm    # 원화 → 달러 환전
+```
+
+- 거래소(`--exchange nasdaq|nyse|amex`)는 자동 판별되며, 복수 상장 종목만 직접 지정이 필요합니다.
+- 미국 주문 유형: limit/market/vwap/twap/vwap-limit/twap-limit/loc (매수·매도), moc/stop/stop-limit (매도 전용).
+- 정정은 가격만 가능(전량), 취소는 전량 취소만 지원됩니다 (키움 API 제약).
+- 계좌 조회 명령(`balance/deposit/pnl/orders/history`)은 기본 통합 표시이며 `--market kr|us`로 필터링합니다.
+
+---
+
 ## order - 주문
 
 모든 주문에 `--confirm` 필수.
@@ -241,8 +264,8 @@ kiwoom order credit sell 005930 10 --type market --confirm
 
 # 금현물
 kiwoom order gold buy M04020000 1 --type market --confirm
-kiwoom order gold balance --confirm    # 잔고
-kiwoom order gold pending --confirm   # 미체결
+kiwoom order gold balance             # 잔고
+kiwoom order gold pending             # 미체결
 
 # 조건검색
 kiwoom order condition list
@@ -411,7 +434,7 @@ eval (env _KIWOOM_COMPLETE=fish_source kiwoom)
 | 항목             | 값                                       |
 | ---------------- | ---------------------------------------- |
 | 설정 파일        | `~/.kiwoom/config.toml` (도메인, 계좌만) |
-| appkey/secretkey | OS 키체인 (암호화 저장)                  |
+| appkey/secretkey | OS 키체인                                |
 | 토큰             | OS 키체인                                |
 | 캐시 디렉터리    | `~/.kiwoom/cache/`                       |
 | 운영 도메인      | `https://api.kiwoom.com`                 |
@@ -426,19 +449,24 @@ eval (env _KIWOOM_COMPLETE=fish_source kiwoom)
 
 ## 보안
 
-인증정보(appkey, secretkey)는 **OS 키체인에 암호화되어 저장**됩니다. 파일로 존재하지 않으며, 비밀번호 없이는 복호화할 수 없습니다.
+모든 인증정보(appkey, secretkey, 토큰)는 **OS 키체인**(macOS Keychain / Windows Credential Manager / Linux Secret Service)에 저장됩니다. 파일로 존재하지 않으며, 키체인이 디스크 저장 시 암호화를 담당합니다. `gh`, `aws`, `docker` CLI와 동일한 모델입니다.
 
-| 항목               | 저장 방식          |            비밀번호 필요            |
-| ------------------ | ------------------ | :---------------------------------: |
-| appkey / secretkey | 암호화 + OS 키체인 | O (`config setup`, `auth login` 시) |
-| 토큰               | OS 키체인 (평문)   |           X (만료되는 값)           |
-| config.toml        | 도메인, 계좌번호만 |                  X                  |
+| 항목               | 저장 방식          | 프롬프트 |
+| ------------------ | ------------------ | :------: |
+| appkey / secretkey | OS 키체인          |    X     |
+| 토큰               | OS 키체인          |    X     |
+| config.toml        | 도메인, 계좌번호만 |    X     |
 
-- `config setup` 시 설정한 비밀번호로 appkey/secretkey를 암호화
-- `auth login/logout` 시 비밀번호 확인 후 키체인 접근
-- 토큰 발급 후 일반 명령어는 비밀번호 없이 사용
-- `keyring.get_password()`로 직접 접근해도 암호화된 값만 반환
+- 모든 명령어는 비밀번호/생체인증 프롬프트 없이 동작 (AI 에이전트·자동화 친화적)
+- 앱 자체 암호화 계층은 의도적으로 두지 않음 — 추가 계층은 명령마다 잠금 해제 프롬프트를 요구하게 되어 CLI 사용성을 해침
+- v2.0 이하에서 업그레이드한 경우: 암호화 저장소 형식이 제거되어 `kiwoom config setup`을 한 번 다시 실행해야 합니다
 
 ## License
 
-MIT
+kiwoom-cli **Source-Available License, Version 1.0** — see [LICENSE](LICENSE).
+
+- **Individuals** (natural persons, on their own behalf): free to use, modify, and distribute for any purpose, including profit (e.g. trading your own account). Attribution only; no source-disclosure obligation.
+- **Organizations, unmodified use for profit**: require a commercial license.
+- **Organizations, modified use for profit**: either buy a commercial license (source may stay closed) or publish your entire codebase under this same license — and in both cases deliver the full modified source to the Licensor.
+
+Versions released before v2.0 remain available under the MIT License. For commercial licensing, contact ge.jyn14@gmail.com — see [COMMERCIAL.md](COMMERCIAL.md).

{kiwoom_cli-1.1.3 → kiwoom_cli-2.1.0}/kiwoom_cli/__init__.py

@@ -1,3 +1,3 @@
 """Kiwoom Securities REST API CLI."""
 
-__version__ = "1.1.3"
+__version__ = "2.1.0"

{kiwoom_cli-1.1.3 → kiwoom_cli-2.1.0}/kiwoom_cli/api_spec.py

@@ -212,6 +212,41 @@ API_REGISTRY: dict[str, tuple[str, str]] = {
     "ka10172": ("/api/dostk/websocket", "조건검색 요청 일반"),
     "ka10173": ("/api/dostk/websocket", "조건검색 요청 실시간"),
     "ka10174": ("/api/dostk/websocket", "조건검색 실시간 해제"),
+    # === 미국주식 주문 (US Orders) ===
+    "ust20000": ("/api/us/ordr", "미국주식 매수 주문"),
+    "ust20001": ("/api/us/ordr", "미국주식 매도 주문"),
+    "ust20002": ("/api/us/ordr", "미국주식 정정 주문"),
+    "ust20003": ("/api/us/ordr", "미국주식 취소 주문"),
+    "ust31490": ("/api/us/ordr", "미국주식 주문가능수량"),
+    # === 미국주식 계좌 (US Account) ===
+    "ust21070": ("/api/us/acnt", "미국주식 원장잔고확인"),
+    "ust21160": ("/api/us/acnt", "미국주식 예수금 상세"),
+    "ust21110": ("/api/us/acnt", "해외주식 예수금"),
+    "ust21530": ("/api/us/acnt", "미국주식 실현손익"),
+    "ust21170": ("/api/us/acnt", "미국주식 당일 종목별 실현손익"),
+    "ust21050": ("/api/us/acnt", "미국주식 원장 미체결"),
+    "ust21150": ("/api/us/acnt", "미국주식 일별 주문체결내역"),
+    "ust21510": ("/api/us/acnt", "미국주식 당일 주문체결 확인"),
+    "ust21180": ("/api/us/acnt", "미국주식 기간별 주문내역"),
+    "ust21100": ("/api/us/acnt", "미국주식 거래내역"),
+    # === 미국주식 종목정보 (US Stock Info) ===
+    "usa10098": ("/api/us/stkinfo", "미국주식 거래소구분 조회"),
+    "usa10099": ("/api/us/stkinfo", "미국주식 종목리스트"),
+    "usa10100": ("/api/us/stkinfo", "미국주식 종목 조회"),
+    # === 미국주식 시세 (US Quotes) ===
+    "usa20100": ("/api/us/mrkcond", "미국주식 현재가 종목정보"),
+    "usa20101": ("/api/us/mrkcond", "미국주식 현재가 10호가"),
+    # === 미국주식 차트 (US Charts) ===
+    "usa06010": ("/api/us/chart", "미국주식 틱 차트"),
+    "usa06011": ("/api/us/chart", "미국주식 분 차트"),
+    "usa06012": ("/api/us/chart", "미국주식 일 차트"),
+    "usa06013": ("/api/us/chart", "미국주식 주 차트"),
+    "usa06014": ("/api/us/chart", "미국주식 월 차트"),
+    "usa06015": ("/api/us/chart", "미국주식 년 차트"),
+    # === 환전 (FX) ===
+    "ust31300": ("/api/us/exchange", "환전 예상 금액 조회"),
+    "ust31301": ("/api/us/exchange", "환율 조회"),
+    "ust31302": ("/api/us/exchange", "환전 신청"),
 }