-
Notifications
You must be signed in to change notification settings - Fork 1
US Stocks
Yu Jin edited this page Jul 15, 2026
·
1 revision
v2.0부터 키움 REST API의 미국주식 29개 엔드포인트를 기존 명령 체계에 그대로 통합했습니다. 별도의 us 그룹을 외울 필요 없이, 티커만 입력하면 시장이 자동 판별됩니다.
| 입력 | 판별 | 예시 |
|---|---|---|
| 6자리 숫자 | 국내 |
005930, 000660
|
| 알파벳 티커 | 미국 |
NVDA, AAPL, BRK.B
|
kiwoom stock price 005930 # → 국내 API
kiwoom stock price NVDA # → 미국 API (거래소 자동 판별)거래소(NASDAQ/NYSE/AMEX)는 자동 판별되며(usa10098 조회 + ~/.kiwoom/cache/us_exchanges.json 캐시), 복수 상장 종목만 --exchange nasdaq|nyse|amex로 직접 지정하면 됩니다.
kiwoom stock price NVDA # 현재가
kiwoom stock info NVDA # 기본정보
kiwoom stock orderbook NVDA # 호가
kiwoom stock chart day NVDA --base-date 20260701 # 일봉 (tick~year 6종)
kiwoom stock chart day NVDA --base-date 20260701 --krw # 원화 환산
kiwoom stock search apple --market us # 종목 검색국내 주문과 동일한 명령을 사용합니다. 소수점 가격을 지원합니다 (페니스톡 0.0012까지).
kiwoom order buy NVDA 10 --price 213.04 # 지정가 매수 (미리보기 + 확인)
kiwoom order sell NVDA 5 --type market --confirm # 시장가 매도
kiwoom order sell NVDA 5 --type stop-limit --price 200.5 --stop 199.99 --confirm
kiwoom order modify <주문번호> NVDA 0 210.00 --confirm # 정정 (가격만, 전량)
kiwoom order cancel <주문번호> NVDA --confirm # 취소 (전량만)| 유형 | 방향 | 설명 |
|---|---|---|
limit / market
|
매수·매도 | 지정가 / 시장가 |
vwap / twap
|
매수·매도 | 물량가중/시간가중 평균가 |
vwap-limit / twap-limit
|
매수·매도 | VWAP/TWAP + 지정가 한도 |
loc |
매수·매도 | Limit-on-Close |
moc |
매도 전용 | Market-on-Close |
stop / stop-limit
|
매도 전용 | 스톱 / 스톱 지정가 (--stop 가격 필수) |
- 정정은 가격만 변경 가능하며 전량 단위입니다 (수량 부분 정정 불가).
- 취소는 전량 취소만 지원됩니다.
- CLI가 제약을 벗어나는 입력에 명확한 안내 메시지를 출력합니다.
account balance / deposit / pnl / orders / history는 기본적으로 국내+미국 통합으로 표시됩니다:
kiwoom account balance # 국내+미국 한 테이블 (종목별 USD/원화 병기, 원화 총계)
kiwoom account balance --market us # 미국만
kiwoom account balance --market kr # 국내만 (v1.x 동작)- 종목별 USD/원화 병기, 통화별 소계, 원화 총평가액 표시
- 한쪽 API가 실패하면 경고 후 나머지를 표시 (전체 실패 시에만 에러)
-
-f json은 단일{"kr": ..., "us": ...}문서를 출력
kiwoom account exchange rate # 환율 조회
kiwoom account exchange estimate 1000000 # 환전 예상 금액
kiwoom account exchange apply 1000000 --confirm # 원화 → 달러 환전 신청apply는 주문과 동일하게 확인 게이트를 거칩니다.
kiwoom account orderable margin-qty NVDA --price 213.04