-
Notifications
You must be signed in to change notification settings - Fork 1
Command Guide
Yu Jin edited this page Jul 15, 2026
·
2 revisions
kiwoom-cli는 키움 REST API 236개(REST 217 + WebSocket 실시간 19)를 설정/인증/유틸리티 명령어와 함께 제공합니다. 이 페이지에서는 전체 명령어 구조와 공통 옵션을 설명합니다.
v2.0+: 미국주식은 별도 그룹이 아니라 기존 명령에 통합되어 있습니다. 알파벳 티커(
NVDA)를 입력하면 자동으로 미국 시장으로 라우팅됩니다. 미국주식 참고.
kiwoom [--format table|json|csv] [--profile NAME] [--no-color] [--version] [--help]
│
├── config 설정 관리
│ ├── setup [--profile NAME] 초기 설정 (appkey, secretkey, 도메인, 계좌)
│ ├── show 현재 설정 확인
│ ├── set <key> <value> 설정 변경 (domain/account)
│ ├── use <profile> 기본 프로필 변경
│ └── profiles 등록된 프로필 목록
│
├── auth 인증 관리
│ ├── login 접근토큰 발급
│ ├── logout 접근토큰 폐기
│ └── status 토큰 상태 확인
│
├── stock 종목 조회
│ ├── info <code> 기본정보 (PER, PBR, 시가총액 등)
│ ├── price <code> 현재가 한 줄
│ ├── detail <code> 종목정보 상세
│ ├── orderbook <code> 10단계 호가창
│ ├── daily <code> 일/주/월별 시세
│ ├── timeprice <code> 시분 시세
│ ├── daily-price <code> 일별주가
│ ├── after-hours <code> 시간외단일가
│ ├── quote-info <code> 시세표성정보
│ ├── exec <code> 체결정보
│ ├── trader <code> 거래원
│ ├── today-exec <code> 당일/전일 체결
│ ├── today-volume <code> 당일/전일 체결량
│ ├── tick-strength <code> 체결강도 시간별
│ ├── daily-strength <code> 체결강도 일별
│ ├── foreign <code> 외국인 매매동향
│ ├── institution <code> 기관 매매동향
│ ├── short <code> 공매도 추이
│ ├── sync 종목 리스트 캐시 다운로드
│ ├── search <keyword> 종목 검색 (캐시 기반)
│ ├── watchlist <codes> 관심종목 (|구분)
│ ├── brokers 회원사 리스트
│ ├── compare <codes...> 종목 비교
│ ├── chart 차트 데이터
│ │ ├── tick <code> 틱 차트
│ │ ├── minute <code> 분봉
│ │ ├── day <code> 일봉
│ │ ├── week <code> 주봉
│ │ ├── month <code> 월봉
│ │ ├── year <code> 년봉
│ │ └── investor <code> 투자자별 차트
│ ├── investor 투자자/기관 분석
│ │ ├── daily-trade 일별 투자자별 매매
│ │ ├── by-stock <code> 종목별 투자자 매매
│ │ ├── daily-by-stock <code> 일별 종목별 투자자 매매
│ │ ├── program-top 프로그램매매 상위
│ │ ├── program-daily 프로그램매매 일별
│ │ ├── program-by-stock 종목별 프로그램매매
│ │ ├── foreign-total 외국인 종합
│ │ ├── foreign-daily 외국인 일별
│ │ ├── foreign-by-stock 외국인 종목별
│ │ └── institution-total 기관 종합
│ ├── analysis 거래 분석
│ │ ├── daily-detail <code> 일별거래상세
│ │ ├── volume-renewal 거래량갱신
│ │ ├── price-cluster 매물대집중
│ │ ├── per-rank 고저PER 순위
│ │ ├── open-change 시가대비등락률
│ │ ├── trader-analysis <code> 거래원매물대분석
│ │ ├── instant-volume 거래원순간거래량
│ │ ├── vi-trigger VI 발동종목
│ │ ├── broker-ranking 증권사종목매매동향
│ │ └── foreign-exhaust 외국인한도소진률
│ ├── lending 대차거래
│ │ ├── trend 대차거래 추이
│ │ ├── top 대차거래 상위
│ │ ├── by-stock <code> 종목별 대차거래
│ │ └── detail 대차거래 내역
│ └── credit 신용매매
│ ├── trend <code> 신용매매동향
│ ├── available 신용융자 가능종목
│ └── inquiry 신용융자 가능문의
│
├── account 계좌 조회
│ ├── list 계좌번호 목록
│ ├── balance 계좌 평가현황 (잔고+보유종목+손익)
│ ├── deposit 예수금 상세
│ ├── asset 추정자산
│ ├── today 당일현황
│ ├── margin-detail 증거금 세부내역
│ ├── returns 수익률
│ │ ├── summary 계좌 수익률
│ │ ├── daily-balance 일별 잔고수익률
│ │ ├── daily-detail 일별 수익률 상세
│ │ └── daily-asset 일별 예탁자산
│ ├── pnl 실현손익
│ │ ├── today <code> 당일 실현손익
│ │ ├── by-date 일자별 실현손익
│ │ ├── by-period 기간별 실현손익
│ │ └── daily 일자별 실현손익
│ ├── orders 주문/체결 조회
│ │ ├── pending 미체결 주문
│ │ ├── executed 체결 내역
│ │ ├── detail 주문체결 상세
│ │ ├── status 주문체결 현황
│ │ └── split-detail <no> 분할주문 상세
│ ├── holdings 잔고/평가
│ │ ├── eval 계좌평가 잔고
│ │ ├── settled 체결잔고
│ │ └── next-settle 익일결제예정
│ ├── orderable 주문가능 금액/수량
│ │ ├── amount <code> 주문 인출가능 금액
│ │ ├── margin-qty <code> 증거금율별 수량 (미국 티커 지원)
│ │ └── credit-qty <code> 신용보증금율별 수량
│ ├── exchange 환전 (v2.0+)
│ │ ├── rate 환율 조회
│ │ ├── estimate <amount> 환전 예상 금액
│ │ └── apply <amount> 환전 신청 (--confirm)
│ └── history 거래내역
│ ├── transactions 위탁 종합거래내역
│ └── journal 당일 매매일지
│
├── order 주문 (--confirm 필수)
│ ├── buy <code> <qty> 주식 매수
│ ├── sell <code> <qty> 주식 매도
│ ├── modify <ord_no> <code> <qty> <price> 주식 정정
│ ├── cancel <ord_no> <code> 주식 취소
│ ├── credit 신용주문
│ │ ├── buy <code> <qty> 신용 매수
│ │ ├── sell <code> <qty> 신용 매도
│ │ ├── modify ... 신용 정정
│ │ └── cancel ... 신용 취소
│ ├── gold 금현물
│ │ ├── buy <code> <qty> 금현물 매수
│ │ ├── sell <code> <qty> 금현물 매도
│ │ ├── modify ... 금현물 정정
│ │ ├── cancel ... 금현물 취소
│ │ ├── balance 금현물 잔고
│ │ ├── deposit 금현물 예수금
│ │ ├── executions-all 주문체결 전체
│ │ ├── executions 주문체결
│ │ ├── history 거래내역
│ │ └── pending 미체결
│ └── condition 조건검색
│ ├── list 조건검색 목록
│ ├── search <seq> 조건검색 요청
│ ├── realtime <seq> 실시간 등록
│ └── stop <seq> 실시간 해제
│
├── market 시장 정보
│ ├── rank 순위 (28개)
│ │ ├── volume 거래량 상위
│ │ ├── prev-volume 전일 거래량 상위
│ │ ├── amount 거래대금 상위
│ │ ├── change 등락률 상위
│ │ ├── expected-change 예상체결 등락률
│ │ ├── surge 가격 급등락
│ │ ├── hot 실시간 조회 상위
│ │ ├── limit 상하한가
│ │ ├── new-highlow 신고저가
│ │ ├── near-highlow 고저가 근접
│ │ ├── volume-surge 거래량 급증
│ │ ├── orderbook-top 호가잔량 상위
│ │ ├── orderbook-surge 호가잔량 급증
│ │ ├── balance-rate-surge 잔량율 급증
│ │ ├── credit-ratio 신용비율 상위
│ │ ├── foreign-period 외인 기간별 매매
│ │ ├── foreign-consecutive 외인 연속 매매
│ │ ├── foreign-exhaust 외인 한도소진률
│ │ ├── foreign-broker 외인 거래원별
│ │ ├── foreign-inst 외국인/기관 매매
│ │ ├── investor-top 투자자 상위
│ │ ├── broker-by-stock 거래원별 종목매매
│ │ ├── broker-top 거래원 상위
│ │ ├── major-trader 대량거래원
│ │ ├── net-buyer 순매수/순매도
│ │ ├── top-exit 상위이탈
│ │ ├── same-net-trade 동일순매매
│ │ └── afterhours-change 시간외등락률
│ ├── sector 업종
│ │ ├── current <code> 업종 현재가
│ │ ├── index 전업종 지수
│ │ ├── stocks <code> 업종 구성종목
│ │ ├── daily <code> 업종 일별
│ │ ├── codes 업종 코드 목록
│ │ └── chart <period> <code> 업종 차트
│ ├── theme 테마
│ │ ├── groups 테마 그룹
│ │ └── stocks <code> 테마 구성종목
│ ├── etf ETF
│ │ ├── all ETF 전체 시세
│ │ ├── info <code> ETF 종목정보
│ │ └── daily <code> ETF 일별
│ ├── elw ELW
│ │ ├── detail <code> ELW 상세정보
│ │ └── search ELW 조건검색
│ ├── gold 금현물
│ │ ├── price 금현물 시세
│ │ └── orderbook 금현물 호가
│ └── program 프로그램매매
│ ├── time-trend 시간대별 추이
│ ├── stock-daily <code> 종목별 일별
│ └── stock-current <code> 종목별 현재
│
├── stream 실시간 스트리밍 (WebSocket)
│ ├── quote <codes...> 주식체결 (0B)
│ ├── price <codes...> 주식기세 (0A)
│ ├── orderbook <codes...> 호가잔량 (0D)
│ ├── best-bid <codes...> 우선호가 (0C)
│ ├── after-hours <codes...> 시간외호가 (0E)
│ ├── expected <codes...> 예상체결 (0H)
│ ├── stock-info <codes...> 종목정보 (0g)
│ ├── trader <codes...> 당일거래원 (0F)
│ ├── program <codes...> 프로그램매매 (0w)
│ ├── order 주문체결 (00)
│ ├── balance 잔고 (04)
│ ├── sector-index <codes...> 업종지수 (0J)
│ ├── sector-change <codes...> 업종등락 (0U)
│ ├── etf-nav <codes...> ETF NAV (0G)
│ ├── elw-theory <codes...> ELW 이론가 (0m)
│ ├── elw-indicator <codes...> ELW 지표 (0u)
│ ├── gold <codes...> 국제금환산 (0I)
│ ├── market-time 장시작시간 (0s)
│ ├── vi <codes...> VI 발동/해제 (1h)
│ ├── multi <codes...> 체결+호가 동시 (0B+0D)
│ ├── custom <types> <codes...> 커스텀 타입
│ └── types 타입 코드 목록
│
├── watch <codes...> 실시간 TUI 대시보드
├── dashboard 계좌요약 + 거래량상위
│
└── api <api_id> [body] [--raw] Raw API 호출
모든 명령어 앞에 사용할 수 있는 옵션입니다.
| 옵션 | 축약 | 설명 | 기본값 |
|---|---|---|---|
--format |
-f |
출력 형식 (table, json, csv) |
table |
--profile |
-p |
사용할 프로필 이름 | 기본 프로필 |
--no-color |
색상 없이 출력 | false |
|
--version |
버전 정보 | ||
--help |
도움말 |
kiwoom -f json stock info 005930 # JSON 출력
kiwoom -p isa account balance # ISA 프로필 사용
kiwoom --no-color stock daily 005930 # 색상 없이| 옵션 | 용도 | 형식 |
|---|---|---|
--from / --to
|
기간 범위 조회 | YYYYMMDD |
--date |
단일 날짜 조회 | YYYYMMDD |
--base-date |
차트 기준일 | YYYYMMDD |
kiwoom stock short 005930 --from 20260101 --to 20260330
kiwoom stock chart day 005930 --base-date 20260301
kiwoom account returns daily-detail --from 20260101 --to 20260331| 옵션 값 | 설명 | API 내부값 |
|---|---|---|
all |
전체 | 000 |
kospi |
코스피 | 001 |
kosdaq |
코스닥 | 101 |
kiwoom market rank volume --market kospi
kiwoom stock search 삼성 --market kosdaq| 옵션 값 | 설명 |
|---|---|
KRX |
한국거래소 (기본) |
NXT |
넥스트레이드 |
all |
전체 |
SOR |
스마트 오더 라우팅 (주문 시) |
kiwoom account balance --exchange NXT
kiwoom order buy 005930 10 --exchange SOR --type market --confirm- 주식: 6자리 문자열 (예:
005930= 삼성전자) - 금현물:
M04020000(1kg),M04020100(미니 100g) - 업종코드: 3자리 (예:
001= 코스피)
kiwoom config setup # 초기 설정
kiwoom config setup --profile isa # 프로필별 설정
kiwoom config show # 현재 설정 확인
kiwoom config set domain prod # 도메인 변경
kiwoom config set account 1234567 # 계좌번호 설정
kiwoom config use isa # 기본 프로필 변경
kiwoom config profiles # 프로필 목록kiwoom auth login # 토큰 발급 (프롬프트 없음)
kiwoom auth logout # 토큰 폐기
kiwoom auth status # 토큰 상태 확인
kiwoom -p isa auth login # 특정 프로필로 토큰 발급API ID를 직접 지정하여 호출할 수 있습니다:
# 테이블 출력
kiwoom api ka10001 '{"stk_cd":"005930"}'
# JSON 원본 출력
kiwoom api ka10001 '{"stk_cd":"005930"}' --raw
# 연속조회가 가능한 경우 next-key 정보 표시
kiwoom api ka10005 '{"stk_cd":"005930","qry_tp":"1"}'모든 키움 API는 POST 방식이며, URL이 아닌 api-id 헤더로 구분됩니다. API ID 목록은 키움증권 Open API 문서를 참조하세요.
모든 명령어에 --help를 붙이면 상세 옵션을 확인할 수 있습니다:
kiwoom --help # 최상위 도움말
kiwoom stock --help # stock 그룹 도움말
kiwoom stock chart --help # chart 하위그룹 도움말
kiwoom stock chart day --help # 특정 명령어 도움말
kiwoom order buy --help # 주문 옵션 확인