kiwoom-cli 1.1.2__tar.gz → 2.0.0__tar.gz

kiwoom_cli-2.0.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.2 → kiwoom_cli-2.0.0}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: kiwoom-cli
-Version: 1.1.2
+Version: 2.0.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
@@ -261,6 +261,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 +302,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
@@ -479,4 +502,10 @@ eval (env _KIWOOM_COMPLETE=fish_source kiwoom)
 
 ## 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.2 → kiwoom_cli-2.0.0}/README.md

@@ -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
@@ -441,4 +464,10 @@ eval (env _KIWOOM_COMPLETE=fish_source kiwoom)
 
 ## 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.2 → kiwoom_cli-2.0.0}/kiwoom_cli/__init__.py

@@ -1,3 +1,3 @@
 """Kiwoom Securities REST API CLI."""
 
-__version__ = "1.1.2"
+__version__ = "2.0.0"

{kiwoom_cli-1.1.2 → kiwoom_cli-2.0.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", "환전 신청"),
 }