modbender KIS 주식 트레이딩
한국투자증권 Open API를 통한 국내 주식 매매 스킬.
Korean stock trading skill using KIS (Korea Investment & Securities) Open API. Supports balance inquiry, real-time quotes, buy/sell orders, trade history, and market overview for stocks listed on KRX (KOSPI/KOSDAQ).
설정
config 파일(~/.kis-trading/config.ini)에 아래 값을 설정:
[KIS]
APP_KEY = your_app_key
APP_SECRET = your_app_secret
ACCOUNT_NO = 12345678-01
BASE_URL = https://openapi.koreainvestment.com:9443
# 모의투자: https://openapivts.koreainvestment.com:29443
설정 확인:
python3 scripts/setup.py --config ~/.kis-trading/config.ini --check
잔고 조회
"잔고 보여줘", "계좌 잔고", "예수금", "매수 가능 금액"
python3 scripts/balance.py --config ~/.kis-trading/config.ini
보유 종목
"보유 종목", "내 주식", "수익률"
python3 scripts/holdings.py --config ~/.kis-trading/config.ini
종목 시세
"삼성전자 현재가", "005930 시세", "카카오 주가"
python3 scripts/quote.py --config ~/.kis-trading/config.ini --code 005930
python3 scripts/quote.py --config ~/.kis-trading/config.ini --name 삼성전자
매수/매도 주문
"삼성전자 10주 매수", "카카오 5주 매도"
⚠️ 주문은 반드시 사용자에게 확인을 받은 후 실행할 것!
# 시장가 매수
python3 scripts/order.py --config ~/.kis-trading/config.ini --side buy --code 005930 --qty 10 --market
# 지정가 매수
python3 scripts/order.py --config ~/.kis-trading/config.ini --side buy --code 005930 --qty 10 --price 70000
# 매도
python3 scripts/order.py --config ~/.kis-trading/config.ini --side sell --code 005930 --qty 10 --market
주문 전 반드시:
- 종목명, 수량, 가격을 사용자에게 보여주고 확인 요청
--dry-run으로 주문 내용 미리 확인 가능- 확인 후 실제 주문 실행
매매 내역
"매매 내역", "오늘 체결 내역", "주문 내역"
python3 scripts/history.py --config ~/.kis-trading/config.ini
python3 scripts/history.py --config ~/.kis-trading/config.ini --start 20240101 --end 20240131
시장 개황
"시장 개황", "거래량 상위", "코스피 지수"
python3 scripts/market.py --config ~/.kis-trading/config.ini --action index
python3 scripts/market.py --config ~/.kis-trading/config.ini --action volume-rank
주의사항
- 실전 투자 시 반드시 BASE_URL을 실전 URL로 설정
- 모의투자와 실전투자의 TR ID가 다를 수 있음
- API 호출은 초당 20건 제한 (자동 제어됨)
- 주문은 절대 사용자 확인 없이 실행하지 말 것