Order Commands

주문 (order)

kiwoom order 그룹은 주식 매수/매도, 정정, 취소, 신용주문, 금현물 주문, 조건검색을 처리합니다.

주문 안전 메커니즘

모든 주문 명령어는 실수로 인한 주문 실행을 방지하기 위해 확인 절차를 거칩니다.

기본 동작 (--confirm 없이)

--confirm 플래그 없이 주문 명령어를 실행하면 대화형 확인 프롬프트가 표시됩니다:

$ kiwoom order buy 005930 10 --type market
주문을 실행하시겠습니까? [y/N]:

y를 입력하면 주문이 실행되고, n이나 Enter를 누르면 주문이 취소됩니다.

--confirm 플래그

스크립트나 자동화에서 프롬프트 없이 주문을 실행하려면 --confirm 플래그를 사용합니다:

kiwoom order buy 005930 10 --type market --confirm

주문 미리보기

주문 실행 전에 Rich Panel로 주문 내용을 표시합니다:

┌─────── 주문 확인 ────────┐
│ 매수 주문                 │
│                           │
│   종목코드: 005930        │
│   수량: 10                │
│   가격: 시장가            │
│   유형: market            │
│   거래소: KRX             │
└───────────────────────────┘

주식 주문

buy -- 매수

# 시장가 매수
kiwoom order buy 005930 10 --type market --confirm

# 지정가 매수
kiwoom order buy 005930 10 --price 70000 --type limit --confirm

# NXT 거래소에서 매수
kiwoom order buy 005930 10 --type market --exchange NXT --confirm

# IOC 조건부 매수
kiwoom order buy 005930 10 --price 70000 --type ioc --confirm

# 스톱지정가 매수
kiwoom order buy 005930 10 --price 70000 --type stop --cond-price 69000 --confirm

API: kt10000

인자/옵션	설명	필수
CODE	종목코드 (6자리)	O
QTY	수량	O
--price	주문가격 (시장가 주문시 생략)	X
--type	주문유형 (아래 표 참조)	X (기본: market)
--exchange	거래소 (KRX/NXT/SOR)	X (기본: KRX)
--cond-price	조건부가격 (스톱지정가 등)	X
--confirm	확인 프롬프트 스킵	X

sell -- 매도

kiwoom order sell 005930 10 --type market --confirm
kiwoom order sell 005930 10 --price 72000 --type limit --confirm

API: kt10001 | 옵션은 buy와 동일

modify -- 정정

원주문번호, 종목코드, 수량, 가격이 필요합니다.

kiwoom order modify 0000139 005930 1 70000 --confirm
kiwoom order modify 0000139 005930 1 70000 --exchange NXT --confirm

API: kt10002

인자	설명
ORIG_ORDER_NO	원래 주문번호
CODE	종목코드
QTY	정정 수량
PRICE	정정 가격

cancel -- 취소

kiwoom order cancel 0000140 005930 --confirm              # 전량 취소
kiwoom order cancel 0000140 005930 --qty 5 --confirm       # 부분 취소

API: kt10003 | 옵션: --qty (0=전량취소)

18개 주문유형

유형	CLI 값	API 코드	설명
보통 (지정가)	limit	0	지정한 가격에 매매
시장가	market	3	시장가로 즉시 매매
조건부지정가	conditional	5	장마감 시 시장가 전환
장마감후시간외	after-hours	81	장 마감 후 시간외 거래
장시작전시간외	pre-market	61	장 시작 전 시간외 거래
시간외단일가	single	62	시간외 단일가 매매
최유리지정가	best	6	최우선 호가에 매매
최우선지정가	first	7	최우선 호가로 지정
보통(IOC)	ioc	10	즉시 체결 후 잔량 취소
시장가(IOC)	market-ioc	13	시장가 IOC
최유리(IOC)	best-ioc	16	최유리 IOC
보통(FOK)	fok	20	전량 체결 또는 전량 취소
시장가(FOK)	market-fok	23	시장가 FOK
최유리(FOK)	best-fok	26	최유리 FOK
스톱지정가	stop	28	조건가 도달 시 지정가 주문
중간가	mid	29	매수/매도 최우선 중간가
중간가(IOC)	mid-ioc	30	중간가 IOC
중간가(FOK)	mid-fok	31	중간가 FOK

사용 예:

kiwoom order buy 005930 10 --type limit --price 70000 --confirm
kiwoom order buy 005930 10 --type market --confirm
kiwoom order buy 005930 10 --type ioc --price 70000 --confirm
kiwoom order buy 005930 10 --type fok --price 70000 --confirm
kiwoom order buy 005930 10 --type stop --price 70000 --cond-price 69000 --confirm

신용주문 (order credit)

신용거래로 주식을 매매합니다.

credit buy -- 신용 매수

kiwoom order credit buy 005930 10 --type market --confirm
kiwoom order credit buy 005930 10 --price 70000 --type limit --confirm

API: kt10006

credit sell -- 신용 매도

kiwoom order credit sell 005930 10 --type market --confirm

API: kt10007

credit modify -- 신용 정정

kiwoom order credit modify 0000139 005930 1 70000 --confirm

API: kt10008

credit cancel -- 신용 취소

kiwoom order credit cancel 0000140 005930 --confirm
kiwoom order credit cancel 0000140 005930 --qty 5 --confirm

API: kt10009

금현물 주문 (order gold)

금현물 매매와 계좌 조회를 처리합니다.

gold buy -- 금현물 매수

kiwoom order gold buy 730060 10 --type limit --price 90000 --confirm
kiwoom order gold buy M04020000 1 --type market --confirm

API: kt50000

gold sell -- 금현물 매도

kiwoom order gold sell 730060 10 --type market --confirm

API: kt50001

gold modify -- 금현물 정정

kiwoom order gold modify 0000139 730060 1 90000 --confirm

API: kt50002

gold cancel -- 금현물 취소

kiwoom order gold cancel 0000140 730060 --confirm

API: kt50003

금현물 계좌 조회

금현물 계좌 관련 조회 명령어는 --confirm 없이 실행 가능합니다:

kiwoom order gold balance         # 금현물 잔고 (kt50020)
kiwoom order gold deposit         # 금현물 예수금 (kt50021)
kiwoom order gold executions-all  # 주문체결 전체 (kt50030)
kiwoom order gold executions      # 주문체결 (kt50031)
kiwoom order gold history         # 거래내역 (kt50032)
kiwoom order gold pending         # 미체결 (kt50075)

조건검색 (order condition)

키움증권의 조건검색 기능을 사용합니다.

condition list -- 조건검색 목록

등록된 조건검색 목록을 조회합니다.

kiwoom order condition list

API: ka10171

condition search -- 조건검색 요청

kiwoom order condition search 001 --confirm

API: ka10172 | 옵션: --exchange (K=KRX), --cont-yn, --next-key

condition realtime -- 실시간 등록

kiwoom order condition realtime 001 --confirm

API: ka10173

condition stop -- 실시간 해제

kiwoom order condition stop 001 --confirm

API: ka10174

미국주식 주문 — v2.0+

알파벳 티커를 입력하면 자동으로 미국 시장으로 라우팅됩니다. 소수점 가격을 지원합니다.

kiwoom order buy NVDA 10 --price 213.04                  # 지정가 매수
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              # 취소 (전량만)

• 미국 전용 주문유형: vwap twap vwap-limit twap-limit loc (매수·매도), moc stop stop-limit (매도 전용, --stop 가격 필수)
• 거래소는 자동 판별되며 복수 상장 종목만 --exchange nasdaq|nyse|amex 지정
• 정정은 가격만(전량), 취소는 전량만 — 키움 API 제약

자세한 가이드: 미국주식

관련 페이지

• 미국주식 -- 미국주식 주문/시세/환전
• 계좌 조회 -- 잔고/체결 조회
• 보안 -- 주문 보안 메커니즘
• 시장 정보 -- 순위/업종 정보