Health check for the Kiwoom MCP server. Takes no arguments and returns a fixed message. Use this to verify the server is connected.

종목명(부분 일치)이나 6자리 코드로 코스피/코스닥 상장 종목(ETF/ETN 포함)을 검색해 종목코드를 찾습니다 (키움 ka10099). 다른 tool에 넘길 종목코드를 모를 때 먼저 사용하세요. 첫 호출은 종목 마스터를 내려받아 몇 초 걸리고, 이후 12시간 동안 캐시됩니다.

6자리 종목코드로 국내 주식/ETF의 현재가, 등락률, 거래량, 기본 지표를 조회합니다 (키움 ka10001). 종목명만 알고 있다면 search_stock으로 먼저 코드를 찾으세요.

종목의 캔들 차트 데이터를 조회합니다 (키움 ka10080~ka10083, 수정주가 반영). period: day(일봉, 기본)/week(주봉)/month(월봉)/minute(분봉). 분봉은 minute_scope로 분 단위를 지정합니다. 종목코드를 모르면 search_stock으로 먼저 찾으세요.

종목의 10단계 매도/매수 호가와 잔량을 조회합니다 (키움 ka10004). 종목코드를 모르면 search_stock으로 먼저 찾으세요.

코스피/코스닥 종합지수와 업종별 지수를 조회합니다 (키움 ka20003). 첫 행이 시장 종합지수, 이후는 업종 지수입니다.

당일 시장 순위를 조회합니다 (키움 ka10027/ka10030/ka10032). type: rise(상승률)/fall(하락률)/volume(거래량)/value(거래대금). market: all(전체, 기본)/kospi/kosdaq.

종목의 개인/외국인/기관 순매수 동향을 조회합니다 (키움 ka10059+ka10061). 기간 합계와 최근 거래일별 내역을 함께 보여줍니다. unit: amount(금액, 백만원, 기본)/quantity(수량, 주). 종목코드를 모르면 search_stock으로 먼저 찾으세요.

ETF의 추적지수, 과세유형, 현재 시세를 조회합니다 (키움 ka40002+ka10001). 종목코드를 모르면 search_stock으로 먼저 찾으세요.

특정 종목의 일자별 공매도 추이를 조회합니다 — 종가, 등락률, 거래량, 공매도량, 공매도비중, 공매도평균가 (키움 ka10014). 기본 조회 기간은 최근 30일이며 from_date/to_date로 변경할 수 있습니다.

특정 종목의 일자별 외국인 보유 동향을 조회합니다 — 종가, 거래량, 외국인 순변동수량, 보유주식수, 보유비중, 한도소진률 (키움 ka10008). 최신순으로 기본 15일 표시하며 limit으로 최대 50일까지 조정할 수 있습니다.

영웅문(HTS)에 저장한 관심종목 그룹 목록(그룹코드+그룹명)을 조회합니다 (키움 ka01300, 읽기 전용). 특정 그룹의 종목은 get_watchlist로 조회하세요. 그룹 편집(추가/삭제)은 키움 REST API가 지원하지 않아 조회만 가능합니다.

관심종목 그룹에 담긴 종목 목록을 조회합니다 (키움 ka01301, 읽기 전용). 그룹코드(예: '000') 또는 그룹명(예: 'etf')을 넘기세요. 그룹을 모르면 get_watchlist_groups로 먼저 확인하세요. 종목명·전일종가·시장은 종목 마스터에서 보강해 함께 표시합니다.

키움 테마 그룹 목록을 조회합니다 — 테마명, 종목수, 등락률, 상승/하락 종목수, 기간수익률(10일), 주요종목 (키움 ka90001). 기본은 등락률 상위 테마를 보여주며, stock_code를 주면 해당 종목이 편입된 테마를 검색합니다. 특정 테마의 구성종목은 get_theme_stocks로 조회하세요.

특정 테마 그룹의 구성종목과 시세를 조회합니다 — 종목별 현재가, 전일대비, 등락률, 거래량, 기간수익률 (키움 ka90002). theme_code는 get_theme_groups가 돌려주는 '코드' 값입니다.

계좌의 예수금(주문가능/출금가능 포함)과 총매입금액, 총평가금액, 총평가손익, 추정예탁자산을 조회합니다 (키움 kt00001 + kt00018). 인자가 필요 없습니다.

계좌의 보유 종목 목록을 조회합니다 — 종목별 수량, 평균단가, 현재가, 평가금액, 평가손익, 수익률, 보유비중 (키움 kt00018). 인자가 필요 없습니다.

계좌의 거래내역(매수/매도 등)을 기간별로 조회합니다 (키움 kt00015). 기본 조회 기간은 최근 30일이며 from_date/to_date로 변경, stock_code로 특정 종목만 필터링할 수 있습니다. 일자는 결제일(D+2) 기준입니다.

계좌의 미체결(아직 체결되지 않은) 주문 목록을 조회합니다 — 주문번호, 종목, 매수/매도 구분, 주문상태, 주문수량, 미체결수량, 주문가격, 현재가 (키움 ka10075). stock_code로 특정 종목만 필터링할 수 있습니다. 조회 전용이며 주문 실행 기능은 제공하지 않습니다.

특정일의 당일매매일지를 조회합니다 — 종목별 매수/매도 평균가·수량, 손익금액, 수익률과 총손익·총수익률 (키움 ka10170). base_date를 생략하면 오늘 기준이며, 최근 2개월 이내 날짜만 조회할 수 있습니다.

ISA 계좌의 손익통산 순이익을 계산해 비과세 한도(일반형 200만원/서민형 400만원) 대비 사용량·잔여량을 보여줍니다. 실현손익(거래내역 재구성)과 배당을 확정분으로, 보유 종목 미실현 손익을 '전량 매도 가정' 시나리오로 함께 제공합니다. 집계 시작일은 ISA_OPENED_ON 환경변수(계좌 개설일) 또는 from_date 인자로 지정합니다. 배당 수령액이 거래내역에서 감지되지 않으면 dividends_received로 수동 입력하세요.