Kiwoom Securities MCP Server

view=summary(기본)는 계좌의 예수금(주문가능/출금가능 포함)과 총매입금액, 총평가금액, 총평가손익, 추정예탁자산, 당일/당월/누적 투자손익입니다 (키움 kt00001 + kt00018 + kt00004). view=settlement은 **다음 결제일에 결제될 체결의 건별 명세**입니다 (kt00008) — summary의 D+1/D+2 추정예수금이 왜 그 값인지를 종목·수량·수수료·제세금으로 쪼개 보여줍니다. 지난 결제 내역 전체는 get_transactions(kt00015), 보유 종목별 잔고는 get_account_holdings를 쓰세요.

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

오늘 하루 계좌에 무슨 일이 있었는지를 한 장으로 조회합니다 (키움 kt00017) — 매도·매수 금액, 수수료·세금, 입출금·입출고, D+2 추정예수금·평가금액, 신용/대출 잔액. 종목별 실현손익은 get_trading_journal, 현재 보유 종목은 get_account_holdings, 예수금·총평가 요약은 get_account_balance를 쓰세요 — 당일 현금 흐름을 보는 것은 이 tool뿐입니다. 모의투자에서는 제공되지 않습니다(RC9000).

일별 추정예탁자산(예수금·대용금 포함) 추이와 기간 수익률·평가손익·입출금 요약을 조회합니다 (키움 kt00002 + kt00016). "내 계좌가 지난 한 달간 어떻게 변했나" 같은 질문에 사용하세요 (기본 30일, 최대 90일). 모의투자에서는 지원되지 않는 조회입니다.

장 종료 후 시간외 단일가 매매(16:00~18:00 KST) 정보를 조회합니다 (키움 ka10087/ka10098). stock_code를 지정하면 해당 종목의 시간외 단일가 시세와 5단 호가를, 생략하면 시장 전체 등락률 순위를 보여줍니다. 대비·등락률은 전일이 아니라 당일 종가 기준입니다. 순위는 sort(up_rate 상승률 기본/up_amount 상승폭/down_rate 하락률/down_amount 하락폭/unchanged 보합), market(all 기본/kospi/kosdaq), min_volume(거래량 하한)으로 조절합니다. 정규장 호가는 get_orderbook을 쓰세요.

증권사 창구별 매매 동향을 조회합니다 (키움 ka10002/ka10102/ka10037/ka10038/ka10053). stock_code를 주면 **그 종목의 당일 거래원 상위 5개사**(매수/매도)이고, 외국계 창구에는 🌐를 붙입니다. 같은 종목을 `view=broker_rank`로 부르면 **전 거래원 50개사의 누적 순위**를 순매수/순매도로 갈라 보고, `view=dropout`이면 **당일 상위에서 빠진 창구와 그 시각**을 봅니다(누가 언제 발을 뺐는지). stock_code를 생략하면 **시장 전체에서 외국계 창구 순매매가 큰 종목 순위**입니다 (direction: net_buy 기본/net_sell/all, days: 1·5·10일 누적). 둘 다 **창구 기준**이라 투자자 주체별 순매수와는 다릅니다 — 외국인 순매수 자체는 get_investor_trend나 get_foreign_intraday를 쓰세요.

특정 종목의 신용융자(빚내서 산 물량) 또는 대주(빌려서 판 물량) 신규·상환·잔고 추이를 조회합니다 (키움 ka10013). 신용잔고가 쌓이면 하락 시 반대매매 압력이, 대주 잔고가 쌓이면 하락 베팅이 늘었다는 신호입니다. 기관·외국인의 대차거래 잔고는 get_stock_lending, 공매도 체결량 추이는 get_short_selling을 쓰세요 — 개인 신용거래를 보는 것은 이 tool뿐입니다.

종목의 일자별 거래를 한 번의 호출로 조회합니다 (키움 ka10086/ka10015). view=flow(기본)는 종가·등락률·거래량·거래대금과 함께 개인/기관/외국인 순매수, 프로그램, 신용비율을 한 행에 묶어 줍니다 — '이 종목을 최근 누가 사고팔았나'를 볼 때 첫 번째로 쓰는 tool입니다. view=session은 같은 일자별로 장전/장중/장후 거래 분포를 보여줍니다. 가격 캔들만 필요하면 get_stock_chart, 투자자 주체를 증권·투신·연기금까지 세분해 보려면 get_investor_trend, 외국인 보유비중 추이는 get_foreign_holding을 쓰세요.

기관과 외국인이 **같은 방향으로 동시에** 순매매한 종목 순위를 조회합니다 (키움 ka10062). 두 주체의 방향이 겹치는 종목과 **각각의 추정 평균단가**를 함께 주는 건 이 tool뿐입니다 — 현재가와 평단을 비교하면 누가 물려 있고 누가 이익 구간인지 볼 수 있습니다. direction: net_buy(동시 순매수, 기본)/net_sell(동시 순매도). 주체별로 따로 보려면 get_net_buy_rank(마감 후 12주체)나 get_investor_trend(종목별)를 쓰세요.

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

상장 ETF 전 종목(약 1,150개)을 한 번에 훑어 괴리율·등락률·거래량·추적오차로 정렬합니다 (키움 ka40004). 'NAV보다 비싸게 거래되는 ETF', '거래량 많은 ETF', '추적오차가 큰 ETF'처럼 **종목을 아직 고르지 않은 상태에서 찾을 때** 쓰세요. 종목을 이미 정했다면 get_etf_info(추적지수·과세유형·NAV)나 get_etf_returns(기간 수익률)가 낫고, ETF가 아닌 일반 주식 스크리닝은 get_valuation_rank·get_ranking을 쓰세요.

ETF의 성과를 세 각도로 조회합니다 (키움 ka40001/ka40003/ka40008). view=period(기본)는 기간별(1주/1개월/6개월/1년) 수익률을 **비교지수** 수익률과 나란히 보여줍니다 — 이 비교지수는 benchmark_index_code로 **직접 고르는 국내 지수**이고 **ETF의 추적지수와 자동으로 맞춰지지 않습니다**(지정하지 않으면 201 KOSPI200이 그대로 들어갑니다). 코드는 get_market_index의 '코드' 값(001 코스피 종합, 101 코스닥 종합 등)이라 **해외지수(나스닥100·S&P500 등)를 추종하는 ETF는 비교 지수를 맞출 수 없습니다** — 그때는 ETF 수익률만 읽고 지수 비교는 제공되지 않는다고 답하세요(추종 성과는 view=daily의 추적오차율). view=daily는 일별 NAV와 괴리율·추적오차 추이입니다 — 'ETF가 제값에 거래되고 있나', '지수를 잘 따라가고 있나'를 물을 때 씁니다(get_etf_info는 최신 1점만 보여줍니다). view=investor는 일자별 외국인·기관 순매수량입니다(period는 기간 합계라 해상도가 다릅니다). 종목코드를 모르면 search_stock으로 먼저 찾으세요.

종목의 체결강도(매수 체결량 ÷ 매도 체결량 × 100) 추이를 조회합니다 (키움 ka10046/ka10047). 100이 균형이며, 그보다 높으면 매수세가 우세합니다. view=daily(기본)는 최근 60거래일, view=intraday는 최근 60분(1분 간격) 흐름을 보여주고 5/20/60 이동평균이 함께 옵니다. '이 종목에 매수세가 붙고 있나'를 볼 때 씁니다. 정규장 호가는 get_orderbook, 투자자 주체별 수급은 get_investor_trend를 쓰세요.

예상체결가 기준 순위를 조회합니다 (키움 ka10029). 예상체결가는 '지금 체결된다면 이 값'이라 동시호가(개장 전 08:30~09:00, 마감 전 15:20~15:30)에 오늘의 시초가·종가 방향을 미리 볼 때 특히 유용합니다. 키움이 예상체결을 산출하지 않는 시간대에는 빈 결과가 돌아옵니다(오류가 아닙니다). 실제로 체결된 결과의 등락률·거래량 순위는 get_ranking, 신고가·상한가·급등 같은 특이 종목은 get_market_movers, 시간외 단일가는 get_after_hours를 쓰세요.

외국인 보유(한도) 동향을 조회합니다 (키움 ka10008/ka10036/ka10034/ka10035). stock_code를 주면 **그 종목의 일자별 추이** — 종가·거래량·외국인 순변동수량·보유주식수·보유비중·한도소진률. stock_code 없이 rank를 주면 **시장 전체 순위**입니다: limit_surge(한도소진율이 가장 많이 오른 종목)/period_net(기간 누적 순매매 상위)/streak(3일 **연속** 같은 방향으로 순매매한 종목 — 누적 크기가 아니라 방향의 지속성을 볼 때). 이 tool은 전부 외국인 **보유·한도** 계열이라, 투자자 매매 기준인 get_net_buy_rank·get_investor_trend·get_foreign_intraday와는 데이터 소스가 다릅니다(같은 종목에서 부호가 반대일 수 있음).

정규장 중 **어떤 주체가 지금 사고 있는 종목**을 전 종목에서 뽑습니다 (키움 ka10063/ka10065). '오늘 외국인이 뭘 담고 있나', '장중 연기금 순매수 상위'처럼 **실시간 수급**을 볼 때 쓰세요. investor로 외국인(기본)·기관계·보험·투신·연기금등·기타법인을 고릅니다 — 개인·금융투자는 거래소가 장중에 공개하지 않아 조회할 수 없습니다. 값은 1,000주 단위 잠정치라 **마감 후 확정치와 다릅니다**(부호가 반대일 수도 있음) — 마감된 거래일 기준은 get_net_buy_rank, 종목을 이미 정했다면 get_investor_trend를 쓰세요.

KRX 금시장(금현물) 시세를 조회합니다 (키움 ka50010/ka50012). instrument: 1kg(금 99.99_1Kg, 기본)/100g(미니금 99.99_100g) — 상장 종목은 이 둘뿐입니다. mode: daily(일별추이 + 기관·개인 순매수, 기본)/ticks(당일 틱 체결 + 체결강도·최우선호가). 금 실물 가격(g당 원)을 볼 때 쓰며, 금 ETF·ETN은 종목이므로 get_stock_price를 쓰세요. 종목코드는 입력하지 않습니다 — 금현물에는 종목 마스터가 없어 search_stock으로 찾을 수 없습니다.

특정 종목을 기관·외국인이 **대략 얼마에 담았는지**(추정평균단가)와 일별·기간누적 순매수를 조회합니다 (키움 ka10045). 현재가와 추정단가를 비교하면 두 주체의 평가손익 구간을 가늠할 수 있습니다. 투자자 주체를 더 잘게(개인·금융투자·보험·투신·연기금 등) 보려면 get_investor_trend를, 외국인 보유주식수·한도소진률 추이는 get_foreign_holding을 쓰세요 — 단가를 주는 것은 이 tool뿐입니다.

외국인과 기관이 많이 사고판 종목을 조회합니다 (키움 ka90009/ka10131). view: daily(일자별 순매수·순매도 상위, 기본) / streak(N일 연속 순매수 상위). "오늘 외국인이 뭘 샀나", "외국인이 며칠째 사는 종목" 질문에 사용하세요. daily는 market all/kospi/kosdaq, streak는 kospi/kosdaq만 지원합니다. 여기서 말하는 순매수·연속은 **매매 기준**입니다 — 외국인 보유주식수·한도소진률 기준의 연속 순매매는 get_foreign_holding(rank=streak)이고 데이터 소스가 달라 같은 종목에서 부호가 반대일 수 있습니다. 연기금·투신처럼 12주체를 고르려면 get_net_buy_rank를 쓰세요.

종목의 개인/외국인/기관 순매수 동향을 조회합니다 (키움 ka10059+ka10061). 기간 합계와 최근 거래일별 내역을 함께 보여줍니다. unit: amount(금액, 백만원, 기본)/quantity(수량, 주). 같은 일자에 종가·거래량·프로그램·신용비율까지 한 행으로 묶어 보려면 get_daily_trading(view=flow), 기관·외국인이 담은 추정평균단가는 get_institution_trend, 주체를 정해 종목을 찾을 때는 get_net_buy_rank를 쓰세요. 종목코드를 모르면 search_stock으로 먼저 찾으세요.

코스피/코스닥 종합지수와 업종별 지수를 조회합니다 (키움 ka20003). 첫 행이 시장 종합지수, 이후는 업종 지수입니다. 각 행의 '코드'는 get_sector_price / get_sector_stocks의 sector_code로 사용할 수 있습니다.

시장 특이 종목을 조회합니다 (키움 ka10016/ka10017/ka10019/ka10023/ka10024). signal: new_high(신고가)/new_low(신저가)/upper_limit(상한가)/lower_limit(하한가)/surge(급등)/plunge(급락)/volume_surge(거래량급증)/volume_renew(거래량갱신). market: all(전체, 기본)/kospi/kosdaq. 신고/신저는 days(5/10/20/60/250일, 기본 5일) 기준, 급등/급락과 거래량급증은 전일 대비입니다 (거래량급증은 급증량 순, 5천주 이상). volume_renew는 **직전 cycle거래일(5/10/20/60/120, 기본 20) 중 최대 거래량을 오늘 갱신한** 종목으로, 전일 하루만 보는 volume_surge보다 긴 호흡의 거래량 돌파를 찾을 때 씁니다.

시장 전 종목을 훑어 **투자자 주체별 순매수 상위**를 뽑습니다 (키움 ka10066). '연기금이 어제 뭘 담았나', '투신 순매도 상위', '사모펀드가 산 코스닥 종목'처럼 **주체를 정하고 종목을 찾을 때** 쓰세요. 개인·외국인·기관계 외에 금융투자·보험·투신·은행· 연기금등·사모펀드·기타금융·국가·기타법인까지 12주체를 고를 수 있습니다. 종목을 이미 정했다면 get_investor_trend(종목 1개의 주체별 시계열)가 낫고, 외국인·기관만 빠르게 보려면 get_investor_rank(상위 25종목)가 가볍습니다. market(kospi 또는 kosdaq)은 필수이고 전체 시장을 한 번에 보는 옵션은 없습니다. 수치는 직전 완료 거래일 기준이며, 장중 실시간은 get_foreign_intraday(외국인 한정)를 쓰세요.

계좌의 **최근** 체결(실제로 체결된 주문) 내역을 조회합니다 — **지난 일자의 체결은 나오지 않습니다**. 주문번호, 종목, 매수/매도 구분, 주문상태, 주문/체결 수량, 주문/체결 가격, 당일 수수료·세금, 주문시각 (키움 ka10076). stock_code·side·order_no로 좁힐 수 있습니다. 기간 파라미터가 없어 **조회 범위는 키움이 정합니다** (모의 실측 2026-08-19: 6일 전 체결이 0행). 과거 일자의 체결 기록은 get_transactions에 남지만 **그쪽 일자는 결제일(D+2) 기준이라 최근 2거래일 체결분은 아직 없습니다** — 그래서 **'어제 체결가'처럼 지난 일자를 물으면 이 tool을 부르지 마세요**. 결제가 끝난 뒤 get_transactions에서 보이므로 그전에는 조회되지 않는다고 답하면 됩니다. 아직 체결되지 않은 주문은 get_pending_orders, 당일 종목별 집계는 get_trading_journal입니다. 조회 전용이며 주문 실행 기능은 제공하지 않습니다.

종목의 10단계 매도/매수 호가와 잔량을 KRX+넥스트레이드(NXT) 통합 기준으로 조회합니다 (키움 ka10007). 지금 어느 가격에 대기 물량이 얼마나 쌓였는지, 매수·매도 어느 쪽이 두꺼운지 볼 때 씁니다. 호가는 체결이 아니라 대기 주문이므로, 실제 체결 쪽 힘은 get_execution_strength(체결강도)를 보세요 — 계좌의 체결 내역은 get_order_executions이고, 여러 종목의 현재가를 한 번에 볼 때가 get_stock_quotes입니다. 종목코드를 모르면 search_stock으로 먼저 찾으세요.

시장 전체에서 호가 잔량이 두껍거나 급증한 종목을 조회합니다 (키움 ka10020/ka10021/ka10022). view=balance(기본)는 총매수/매도 잔량과 순매수 잔량 상위, view=surge는 최근 N분간 잔량 수량이 급증한 종목, view=ratio_surge는 매수/매도 잔량 비율이 급격히 기운 종목입니다. 정규장(09:00~15:30) 중에만 산출되며 그 밖의 시간에는 비어 있거나 잔량이 0으로 옵니다. 특정 종목 하나의 10단 호가는 get_orderbook, 체결 쪽 힘은 get_execution_strength를 쓰세요.

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

프로그램 매매 상위 종목과 추이를 조회합니다 (키움 ka90003/ka90004/ka90010/ka90005/ka90013/ka90008/ka90006). view: top(당일 순매수/순매도 상위 종목, 기본) / date_rank(지정한 날짜의 순매수/순매도 상위 종목 — top과 달리 과거 날짜를 볼 수 있고 매수·매도 금액과 '거래비중'(그 종목 거래에서 프로그램이 차지한 비율)까지 나옵니다. 당일 순위는 top이 서버 집계라 더 정확합니다) / market_daily(시장 전체 일자별 추이) / market_intraday(당일 시간대별 누적 추이) / stock_daily(특정 종목의 일자별 추이 — stock_code 필수) / stock_intraday(특정 종목의 시간대별 누적 추이 — stock_code 필수, 초 단위이며 순매수 '수량'까지 나옵니다. 최근 거래일만 제공되어 base_date가 적용되지 않습니다) / arbitrage_balance(차익거래 잔고 추이 — 매매가 아니라 미청산 보유 물량이라 다른 view로는 알 수 없습니다). 한 종목의 프로그램 수급이 장중 언제 뒤집혔는지를 보려면 stock_intraday, 날짜별 흐름은 stock_daily입니다. direction은 top·date_rank에, unit은 view=top에만, market은 top·date_rank·market_daily·market_intraday에만 적용됩니다 (종목 단위 view와 arbitrage_balance에는 적용되지 않습니다). market: kospi(기본)/kosdaq — 전체(all) 옵션이 없습니다. 추이 금액 단위는 백만원입니다.

당일 시장 순위를 조회합니다 (키움 ka10027/ka10030/ka10032/ka10028/ka10033). type: rise(상승률)/fall(하락률)/volume(거래량)/value(거래대금)/open_rise(시가대비 상승률)/open_fall(시가대비 하락률)/credit_ratio(신용비율). market: all(전체, 기본)/kospi/kosdaq. rise·fall은 전일 종가 기준이고 open_rise·open_fall은 **오늘 시가 기준**이라, 갭으로 뜬 뒤 밀렸는지 장중에 밀어올렸는지를 가릅니다(체결강도 컬럼 포함). 시가대비 두 종류는 시장 전 종목을 훑어야 해서 market이 kospi 또는 kosdaq여야 하고, min_volume(거래량 하한, 기본 1만주)으로 모수를 좁힙니다. credit_ratio는 신용융자 잔고비율이 높은 종목으로, 반대매매 압력이 쌓인 곳을 찾을 때 씁니다 — 특정 종목의 신용잔고 시계열은 get_credit_trend를 쓰세요.

업종(섹터) 지수의 캔들 차트를 조회합니다 (키움 ka20004~ka20008/ka20019). period: day(일봉, 기본)/week(주봉)/month(월봉)/year(년봉)/minute(분봉)/tick(틱봉). sector_code는 get_market_index의 업종 코드이거나 업종명입니다 (001 코스피 종합, 002 코스피 대형주, 101 코스닥 종합, 201 KOSPI200 등).

시장 전체 업종의 투자자 주체별 순매수를 한 번에 조회합니다 (키움 ka10051). '오늘 돈이 어느 섹터로 갔나'를 볼 때 쓰는 tool로, 업종마다 개인/외국인/기관계와 증권·투신·연기금·사모 순매수를 지수 등락률과 함께 보여줍니다. 종목 단위 수급은 get_investor_trend, 종목별 순매수 상위는 get_investor_rank, 특정 업종의 지수 상세와 구성 종목은 get_sector_price / get_sector_stocks를 쓰세요.

업종(섹터) 지수의 현재가 상세를 조회합니다 (키움 ka20001) — 지수·시/고/저가·거래량·상승/하락 종목수·52주 고저·시간대별 추이. sector_code는 get_market_index가 보여주는 업종 코드이며(001 코스피 종합, 002 코스피 대형주, 101 코스닥 종합, 201 KOSPI200 등) '증권'처럼 업종명을 그대로 넣어도 됩니다.

특정 **업종**(KRX 표준 분류)에 속한 종목들의 시세를 조회합니다 (키움 ka20002). 종목코드순 정렬이며 첫 페이지(최대 100종목)만 가져옵니다. sector_code는 get_market_index의 업종 코드이거나 업종명이며 **테마명은 받지 않습니다** — 사용자가 '테마'라고 물었으면 get_theme_groups로 코드를 찾아 get_theme_stocks를 쓰세요('반도체'처럼 이름이 겹칩니다).

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

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

대차거래(주식 대여) 정보를 조회합니다 (키움 ka10068/ka20068/ka90012). view=trend(기본)은 일자별 추이 — 체결·상환·증감 주수와 대차잔고, 잔고금액을 시계열로 보여줍니다. stock_code를 지정하면 해당 종목, 생략하면 시장 전체 집계이고 기본 기간은 최근 30일입니다. view=balance_rank는 특정 하루의 **대차잔고가 가장 많은 종목 순위**입니다 — '어느 종목에 대차 물량이 쌓여 있나'를 물을 때 쓰고, 한 종목의 시간 흐름은 trend를 쓰세요. balance_rank는 시장 전체 횡단면이라 stock_code·from_date를 받지 않으며(주면 무시하고 각주로 알립니다), 기준일은 to_date로 지정하되 **생략하는 쪽이 안전합니다** — 당일 집계는 장 마감 후 저녁 늦게(20시 무렵) 열려서, 오늘을 직접 지정하면 그전까지 빈 결과이고 생략하면 최신 집계일로 자동으로 물러섭니다. 공매도 흐름과 함께 보려면 get_short_selling을 참고하세요.

6자리 종목코드로 국내 주식/ETF의 현재가, 등락률, 거래량과 기본 지표(PER·EPS·PBR·시가총액)를 조회합니다 (키움 ka10001). 배당수익률·배당금은 키움 REST API에 조회 TR이 없어 제공하지 않습니다. 업종·상장일과 거래정지/관리종목/투자경고 같은 투자유의 상태도 함께 표시됩니다. 종목명만 알고 있다면 search_stock으로 먼저 코드를 찾으세요.

여러 종목의 현재가·등락률·거래량·거래대금·시가총액을 한 번의 호출로 조회합니다 (키움 ka10095). 보유 종목이나 관심 종목처럼 2개 이상 종목의 시세가 필요할 때 get_stock_price를 반복 호출하는 대신 사용하세요 (최대 30종목). 거래정지/관리종목/투자경고 같은 투자유의 상태도 비고에 표시됩니다.

최근 N일 거래가 특정 가격대(매물대)에 몰린 종목을 조회합니다 (키움 ka10025). 매물대는 반등 시 저항·하락 시 지지로 읽히므로, 현재가 위아래 어디에 물량이 뭉쳐 있는지 확인할 때 씁니다. 특정 종목 하나의 호가 잔량은 get_orderbook, 거래량 급증 종목은 get_market_movers를 쓰세요 — 가격대별 거래 분포를 보는 것은 이 tool뿐입니다.

키움 테마 그룹 목록을 조회합니다 — 테마명, 종목수, 등락률, 상승/하락 종목수, 기간수익률(10일), 주요종목 (키움 ka90001). 기본은 등락률 상위 테마를 보여주며, stock_code를 주면 해당 종목이 편입된 테마를 검색합니다. **테마명으로 찾는 파라미터는 없어** 이름을 알고 있어도 목록에서 골라야 하고(기본 30개는 등락률 상위라 원하는 테마가 없으면 limit을 100까지 올리세요). '반도체'처럼 **테마명과 업종명이 겹치는 이름**이 있는데, 사용자가 '테마'라고 물었으면 여기가 맞고 get_sector_stocks는 KRX 표준 **업종** 분류입니다 — 사용자가 쓴 말을 따르세요. 특정 테마의 구성종목은 get_theme_stocks로 조회하세요.

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

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

계좌의 거래내역(매수/매도 등)을 기간별로 조회합니다 (키움 kt00015). 기본 조회 기간은 최근 30일이며 from_date/to_date로 변경, stock_code로 특정 종목만 필터링할 수 있습니다. **일자는 결제일(D+2) 기준이라 최근 2거래일 체결분은 아직 잡히지 않습니다** — 당일 체결가·체결시각은 get_order_executions(과거 일자는 조회되지 않습니다), 당일 종목별 손익은 get_trading_journal을 쓰세요. 그래서 '어제 체결가'처럼 **결제 전 구간은 어느 tool로도 조회되지 않고**, 결제가 끝나면 여기에 잡힙니다.

시장 전체를 PER·PBR·ROE 중 **한 가지 기준**으로 줄 세운 상위 100종목을 조회합니다 (키움 ka10026). 지표를 조합해 거르지는 못하므로 '저PER 저PBR'은 metric을 바꿔 두 번 부릅니다. 저PER·저PBR은 가치주 스크리닝, 고ROE는 자본효율이 높은 기업 찾기, 고PBR·저ROE는 과열·부실 점검에 씁니다. 거래량·등락률 기준 순위는 get_ranking, 특정 종목 하나의 PER·PBR은 get_stock_price를 쓰세요 — 밸류에이션으로 시장을 훑는 것은 이 tool뿐입니다.

당일 변동성완화장치(VI)가 발동된 종목을 조회합니다 — 발동가격·괴리율·시가대비등락률·발동/해제 시각·발동횟수 (키움 ka10054). market: all(기본)/kospi/kosdaq, direction: all(기본)/up(상승)/down(하락), vi_type: all(기본)/static(정적)/dynamic(동적). stock_code를 지정하면 해당 종목의 당일 발동 내역만 조회하며, 이때 market은 무시됩니다(종목의 시장과 어긋나면 결과가 비므로 전체 기준으로 봅니다).

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

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

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시간 동안 캐시됩니다.