Kiwoom Securities MCP Server

NPM · KIWOOM-MCP-SERVER · SCANNED AUG 3

Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool

Available components

+2 this week 28 28 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security63

No malware found by supply-chain analysis.Pass
CVE data not yet available for this package.Unverified
No install/post-install scripts declared.Pass
Dependency-health data not yet available.Unverified

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 0 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability0

Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.Unverified

Stability & Change Management0

Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.Unverified

Tool Coverage0

Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet.Unverified

Capabilities0

Protocol version not yet verified: we do not have a sandbox capture of the MCP handshake this version of the package performs yet.Unverified

Unverified: 4 categories

Categories scored 0 because our sandbox run of this package has not given us the schema these checks need to read. That is a gap on our side rather than a finding about the package, and we only credit what we can confirm, so the score stands at 0 until the capture succeeds. We are working through the fleet, so this normally clears without any action from you. How we score packages →

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · kiwoom-mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add chunsam-kiwoom-mcp-server -- npx -y kiwoom-mcp-server

# add to Codex CLI

codex mcp add chunsam-kiwoom-mcp-server -- npx -y kiwoom-mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "chunsam-kiwoom-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kiwoom-mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add chunsam-kiwoom-mcp-server --command npx --arg -y --arg kiwoom-mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  chunsam-kiwoom-mcp-server:
    command: "npx"
    args: ["-y", "kiwoom-mcp-server"]

// mcp.json

{
  "mcpServers": {
    "chunsam-kiwoom-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kiwoom-mcp-server"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 −39
- Stability: 0.23 → unverified ▼ security
- Known CVEs: partial → unverified ▼ security
- Dependency health: partial → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Package version: 0.27.0 → 0.34.0 functional
- Package version: 0.27.0 → 0.32.0 functional
- Package version: 0.27.0 → 0.31.0 functional
- Package version: 0.26.0 → 0.30.0 functional
2 Aug 26 +22
- Provenance: fail → unverified ▼ security
- Install scripts: pass → unverified ▼ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- License: pass → unverified ▼ functional
- Maintenance: pass → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- Licence: MIT functional
1 Aug 26 −9
- Known CVEs: partial → unverified ▼ security
- Dependency health: partial → unverified ▼ functional
31 Jul 26 +48
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −20
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
- Package version: 0.25.0 → 0.26.0 functional
27 Jul 26 26

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

MCP tools — 44 exposed · ~7,813 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

get_account_balance 계좌 잔고 조회 ~85

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_account_holdings 보유 종목 조회 ~63

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_account_today 계좌 당일 현황 조회 ~148

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_account_trend 계좌 자산·수익률 추이 조회 ~129

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

Input Output Examples

Name	Type	Req	Description
days	integer	—	조회 기간(일) — 오늘부터 거슬러 계산 (2~90, 기본 30)

No output schema declared.

No examples provided.

get_after_hours 시간외 단일가 조회 ~302

장 종료 후 시간외 단일가 매매(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을 쓰세요.

Input Output Examples

Name	Type	Req	Description
market	string	—	시장 구분 — 순위 조회에서만 사용 (기본값: all)
min_volume	string	—	시간외 거래량 하한(주) — 순위 조회에서만 사용 (기본값: all)
sort	string	—	정렬 기준 — 순위 조회에서만 사용 (기본값: up_rate)
stock_code	string	—	6자리 종목코드 (생략 시 시장 전체 시간외 단일가 등락률 순위)
top	integer	—	표시할 종목 수 — 순위 조회에서만 사용 (기본값 20, 최대 50)

No output schema declared.

No examples provided.

get_broker_activity 거래원 동향 조회 ~93

특정 종목의 당일 거래원(증권사)별 매수/매도 상위 5개사를 조회합니다 (키움 ka10002). 어느 증권사 창구에서 많이 사고팔았는지 보여줍니다. 종목코드를 모르면 search_stock으로 먼저 찾으세요.

Input Output Examples

Name	Type	Req	Description
stock_code	string	yes	조회할 6자리 종목코드

No output schema declared.

No examples provided.

get_credit_trend 신용융자·대주 잔고 추이 조회 ~248

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

Input Output Examples

Name	Type	Req	Description
base_date	string	—	조회 기준일 yyyyMMdd (기본: 오늘). 이 날짜부터 과거로 거슬러 조회합니다
count	integer	—	표시할 행 수 (기본 15, 최대 60; 최신순)
credit_type	string	—	loan=신용융자(기본, 빚내서 매수) / short=대주(빌려서 매도)
stock_code	string	yes	조회할 6자리 종목코드

No output schema declared.

No examples provided.

get_daily_trading 일별 거래·수급 상세 조회 ~320

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

Input Output Examples

Name	Type	Req	Description
base_date	string	—	조회 기준일 — 이 날짜부터 과거로 조회 (기본값: 오늘)
count	integer	—	표시할 거래일 수 (기본값 20, 최대 60)
stock_code	string	yes	6자리 종목코드
unit	string	—	view=flow의 순매수 단위 (기본값: quantity=주). 외국인 열은 항상 주
view	string	—	flow 가격+투자자 수급(기본) / session 장전·장중·장후 거래 분포

No output schema declared.

No examples provided.

get_etf_info ETF 정보 조회 ~85

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

Input Output Examples

Name	Type	Req	Description
stock_code	string	yes	6자리 ETF 종목코드 (예: 069500)

No output schema declared.

No examples provided.

get_etf_returns ETF 기간 수익률 조회 ~175

ETF의 기간별(1주/1개월/6개월/1년) 수익률을 대상지수 수익률과 나란히 조회합니다 (키움 ka40001). 대상지수는 benchmark_index_code로 지정하며 기본값은 201(KOSPI200)입니다 — 코드는 get_market_index의 '코드' 값을 사용하세요 (001 코스피 종합, 101 코스닥 종합 등). 종목코드를 모르면 search_stock으로 먼저 찾으세요.

Input Output Examples

Name	Type	Req	Description
benchmark_index_code	string	—	비교할 지수 코드 3자리 (기본값 201 KOSPI200 — get_market_index의 '코드' 값)
stock_code	string	yes	6자리 ETF 종목코드 (예: 069500)

No output schema declared.

No examples provided.

get_execution_strength 체결강도 추이 조회 ~230

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

Input Output Examples

Name	Type	Req	Description
count	integer	—	표시할 행 수 (기본값 30, 최대 60)
stock_code	string	yes	6자리 종목코드
view	string	—	daily 일별 최근 60거래일(기본) / intraday 시간별 최근 60분

No output schema declared.

No examples provided.

get_expected_execution 예상체결 순위 조회 (동시호가) ~238

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

Input Output Examples

Name	Type	Req	Description
market	string	—	시장 구분 (기본값: all)
sort	string	—	정렬 기준 — rise 예상 상승률(기본) / fall 예상 하락률 / volume 예상 체결량
top	integer	—	표시할 종목 수 (기본값 15, 최대 50)

No output schema declared.

No examples provided.

get_foreign_holding 외국인 보유 추이 조회 ~128

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

Input Output Examples

Name	Type	Req	Description
limit	integer	—	표시할 일수 (기본 15, 최대 50; 최신순)
stock_code	string	yes	조회할 6자리 종목코드

No output schema declared.

No examples provided.

get_institution_trend 기관·외국인 추정평균단가 조회 ~249

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

Input Output Examples

Name	Type	Req	Description
count	integer	—	표시할 행 수 (기본 15, 최대 60; 최신순)
from_date	string	—	조회 시작일 yyyyMMdd (기본: 30일 전). 누적 순매수의 기산점이 됩니다
stock_code	string	yes	조회할 6자리 종목코드
to_date	string	—	조회 종료일 yyyyMMdd (기본: 오늘)

No output schema declared.

No examples provided.

get_investor_rank 외국인·기관 순매매 상위 / 연속매매 현황 ~254

외국인과 기관이 많이 사고판 종목을 조회합니다 (키움 ka90009/ka10131). view: daily(일자별 순매수·순매도 상위, 기본) / streak(N일 연속 순매수 상위). "오늘 외국인이 뭘 샀나", "외국인이 며칠째 사는 종목" 질문에 사용하세요. daily는 market all/kospi/kosdaq, streak는 kospi/kosdaq만 지원합니다.

Input Output Examples

Name	Type	Req	Description
date	string	—	view=daily의 조회 일자 (기본값: 최근 거래일)
days	string	—	view=streak의 집계 기간(일) (기본값 5)
limit	integer	—	표시할 종목 수 (기본값 10, 최대 30)
market	string	—	시장 구분 (기본값: daily=all, streak=kospi)
unit	string	—	금액/수량 기준 (기본값: amount)
view	string	—	daily=일자별 상위 (기본), streak=연속 순매수

No output schema declared.

No examples provided.

get_investor_trend 투자자별 매매동향 조회 ~171

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

Input Output Examples

Name	Type	Req	Description
from_date	string	—	합계 기간 시작일 (기본값: 30일 전)
stock_code	string	yes	6자리 종목코드 (예: 005930)
to_date	string	—	합계 기간 종료일 (기본값: 오늘)
unit	string	—	단위 (기본값: amount=백만원)

No output schema declared.

No examples provided.

get_market_index 시장 지수 조회 ~93

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

Input Output Examples

Name	Type	Req	Description
market	string	—	시장 구분 (기본값: kospi)

No output schema declared.

No examples provided.

get_market_movers 시장 특이 종목 조회 ~241

시장 특이 종목을 조회합니다 (키움 ka10016/ka10017/ka10019/ka10023). signal: new_high(신고가)/new_low(신저가)/upper_limit(상한가)/lower_limit(하한가)/surge(급등)/plunge(급락)/volume_surge(거래량급증). market: all(전체, 기본)/kospi/kosdaq. 신고/신저는 days(5/10/20/60/250일, 기본 5일) 기준, 급등/급락과 거래량급증은 전일 대비입니다 (거래량급증은 급증량 순, 5천주 이상).

Input Output Examples

Name	Type	Req	Description
days	string	—	신고/신저 기준 기간(일) — new_high/new_low에서만 사용 (기본값 5)
market	string	—	시장 구분 (기본값: all)
signal	string	yes	특이 신호 종류
top	integer	—	표시할 종목 수 (기본값 20, 최대 50)

No output schema declared.

No examples provided.

get_order_executions 체결 내역 조회 ~214

계좌의 체결(실제로 체결된 주문) 내역을 조회합니다 — 주문번호, 종목, 매수/매도 구분, 주문상태, 주문/체결 수량, 주문/체결 가격, 당일 수수료·세금, 주문시각 (키움 ka10076). stock_code·side·order_no로 좁힐 수 있습니다. 아직 체결되지 않은 주문은 get_pending_orders, 당일 종목별 집계는 get_trading_journal, 기간 거래내역은 get_transactions를 쓰세요. 조회 전용이며 주문 실행 기능은 제공하지 않습니다.

Input Output Examples

Name	Type	Req	Description
order_no	string	—	특정 주문번호만 조회할 때의 주문번호
side	string	—	매매 구분 — all(기본, 전체) \| sell(매도) \| buy(매수)
stock_code	string	—	특정 종목만 조회할 때의 6자리 종목코드

No output schema declared.

No examples provided.

get_orderbook 호가 조회 ~72

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

Input Output Examples

Name	Type	Req	Description
stock_code	string	yes	6자리 종목코드 (예: 005930)

No output schema declared.

No examples provided.

get_orderbook_rank 호가잔량 순위 조회 (시장 전체) ~385

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

Input Output Examples

Name	Type	Req	Description
market	string	—	시장 구분 (기본값: kospi). 전체 조회는 없습니다
min_volume	string	—	view=surge/ratio_surge의 최소 거래량 필터 (기본값: 10000주)
minutes	integer	—	view=surge/ratio_surge의 비교 구간(분) (기본값 30, 최대 120)
side	string	—	view=surge/ratio_surge에서 볼 방향 (기본값: buy=매수잔량)
sort	string	—	view=balance의 정렬 기준 (기본값: net_buy=순매수잔량순)
top	integer	—	표시할 종목 수 (기본값 15, 최대 50)
view	string	—	balance 잔량 상위(기본) / surge 잔량 수량 급증 / ratio_surge 잔량 비율 급증

No output schema declared.

No examples provided.

get_pending_orders 미체결 주문 조회 ~118

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

Input Output Examples

Name	Type	Req	Description
stock_code	string	—	특정 종목만 조회할 때의 6자리 종목코드

No output schema declared.

No examples provided.

get_program_trading 프로그램 매매 조회 ~306

프로그램 매매 상위 종목과 추이를 조회합니다 (키움 ka90003/ka90010/ka90005/ka90013). view: top(당일 순매수/순매도 상위 종목, 기본) / market_daily(시장 전체 일자별 추이) / market_intraday(당일 시간대별 누적 추이) / stock_daily(특정 종목의 일자별 추이 — stock_code 필수). direction/unit은 view=top에만 적용됩니다. market: kospi(기본)/kosdaq — 전체(all) 옵션이 없습니다. 추이 금액 단위는 백만원입니다.

Input Output Examples

Name	Type	Req	Description
base_date	string	—	추이 조회 기준일 — 이 날짜부터 과거로 조회 (기본값: 오늘/최근일)
direction	string	—	view=top의 순매수/순매도 (기본값: net_buy)
market	string	—	시장 구분 (기본값: kospi)
stock_code	string	—	view=stock_daily 전용 — 조회할 6자리 종목코드
top	integer	—	표시할 종목/행 수 (기본값 20, 최대 50)
unit	string	—	view=top의 금액/수량 기준 (기본값: amount)
view	string	—	조회 종류 (기본값: top)

No output schema declared.

No examples provided.

get_ranking 시장 순위 조회 ~120

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

Input Output Examples

Name	Type	Req	Description
market	string	—	시장 구분 (기본값: all)
top	integer	—	표시할 종목 수 (기본값 20, 최대 50)
type	string	yes	순위 종류

No output schema declared.

No examples provided.

get_sector_chart 업종 지수 차트 조회 (일/주/월/년/분/틱봉) ~278

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

Input Output Examples

Name	Type	Req	Description
count	integer	—	캔들 개수 (기본값 30, 최대 200)
minute_scope	string	—	period=minute일 때 분 단위 (기본값: 5)
period	string	—	봉 주기 (기본값: day)
sector_code	string	yes	업종 코드 3자리(예: 001 코스피 종합, 101 코스닥 종합) 또는 업종명(예: 증권, 반도체). 이름이 여러 시장에 있으면 후보 코드를 알려 주는 에러가 돌아옵니다
tick_scope	string	—	period=tick일 때 캔들당 틱 수 (기본값: 30)

No output schema declared.

No examples provided.

get_sector_flow 업종별 투자자 순매수 조회 ~256

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

Input Output Examples

Name	Type	Req	Description
base_date	string	—	조회 기준일 (기본값: 최근 거래일)
market	string	—	시장 구분 (기본값: kospi)
sort	string	—	정렬 기준 (기본값: foreign=외국인 순매수 상위)
top	integer	—	표시할 업종 수 (기본값 15, 최대 40)
unit	string	—	순매수 단위 (기본값: amount=백만원, quantity=천주)

No output schema declared.

No examples provided.

get_sector_price 업종 현재가 조회 ~193

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

Input Output Examples

Name	Type	Req	Description
sector_code	string	yes	업종 코드 3자리(예: 001 코스피 종합, 101 코스닥 종합) 또는 업종명(예: 증권, 반도체). 이름이 여러 시장에 있으면 후보 코드를 알려 주는 에러가 돌아옵니다

No output schema declared.

No examples provided.

get_sector_stocks 업종별 종목 시세 조회 ~159

특정 업종에 속한 종목들의 시세를 조회합니다 (키움 ka20002). 종목코드순 정렬이며 첫 페이지(최대 100종목)만 가져옵니다. sector_code는 get_market_index의 업종 코드이거나 업종명입니다.

Input Output Examples

Name	Type	Req	Description
limit	integer	—	표시할 종목 수 (기본값 30, 최대 100)
sector_code	string	yes	업종 코드 3자리(예: 001 코스피 종합, 101 코스닥 종합) 또는 업종명(예: 증권, 반도체). 이름이 여러 시장에 있으면 후보 코드를 알려 주는 에러가 돌아옵니다

No output schema declared.

No examples provided.

get_short_selling 공매도 추이 조회 ~132

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

Input Output Examples

Name	Type	Req	Description
from_date	string	—	조회 시작일 (기본값: 30일 전)
stock_code	string	yes	조회할 6자리 종목코드
to_date	string	—	조회 종료일 (기본값: 오늘)

No output schema declared.

No examples provided.

get_stock_chart 주식 차트 조회 (일/주/월/년/분/틱봉) ~226

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

Input Output Examples

Name	Type	Req	Description
count	integer	—	캔들 개수 (기본값 30, 최대 200)
minute_scope	string	—	period=minute일 때 분 단위 (기본값: 5)
period	string	—	봉 주기 (기본값: day)
stock_code	string	yes	6자리 종목코드 (예: 005930)
tick_scope	string	—	period=tick일 때 캔들당 틱 수 (기본값: 30)

No output schema declared.

No examples provided.

get_stock_lending 대차거래 추이 조회 ~177

일자별 대차거래(주식 대여) 추이를 조회합니다 — 체결·상환·증감 주수와 대차잔고, 잔고금액 (키움 ka10068/ka20068). stock_code를 지정하면 해당 종목, 생략하면 시장 전체 집계입니다. 기본 조회 기간은 최근 30일이며 from_date/to_date로 변경할 수 있습니다. 공매도 흐름과 함께 보려면 get_short_selling을 참고하세요.

Input Output Examples

Name	Type	Req	Description
from_date	string	—	조회 시작일 (기본값: 30일 전)
stock_code	string	—	6자리 종목코드 (생략 시 시장 전체 대차 추이)
to_date	string	—	조회 종료일 (기본값: 오늘)

No output schema declared.

No examples provided.

get_stock_price 종목 현재가 조회 ~124

6자리 종목코드로 국내 주식/ETF의 현재가, 등락률, 거래량, 기본 지표를 조회합니다 (키움 ka10001). 업종·상장일과 거래정지/관리종목/투자경고 같은 투자유의 상태도 함께 표시됩니다. 종목명만 알고 있다면 search_stock으로 먼저 코드를 찾으세요.

Input Output Examples

Name	Type	Req	Description
stock_code	string	yes	6자리 종목코드 (예: 삼성전자 005930, KODEX 200 069500)

No output schema declared.

No examples provided.

get_stock_quotes 여러 종목 일괄 시세 조회 ~145

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

Input Output Examples

Name	Type	Req	Description
stock_codes	array	yes	조회할 6자리 종목코드 목록 (1~30개, 예: ["005930", "000660"])

No output schema declared.

No examples provided.

get_supply_concentration 매물대집중 종목 조회 (시장 전체) ~300

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

Input Output Examples

Name	Type	Req	Description
current_price_only	boolean	—	true면 현재가가 매물대 구간 안에 들어온 종목만 (기본값: false)
market	string	—	시장 구분 (기본값: all=전체)
min_ratio	integer	—	매물비율 하한(%) (기본값 50, 최소 20). 높일수록 한 가격대에 더 심하게 뭉친 종목만 남습니다
period_days	integer	—	매물대를 집계할 기간(일) (기본값 50)
top	integer	—	표시할 건수 (기본값 20, 최대 50; 매물비율 높은 순)
zone_count	integer	—	기간을 몇 개의 가격 구간으로 나눌지 (기본값 10)

No output schema declared.

No examples provided.

get_theme_groups 테마 그룹 조회 ~170

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

Input Output Examples

Name	Type	Req	Description
limit	integer	—	표시할 테마 개수 (기본 30, 최대 100; 등락률 상위순). 종목 검색 시에는 무시됩니다.
stock_code	string	—	특정 종목이 편입된 테마만 검색할 6자리 종목코드

No output schema declared.

No examples provided.

get_theme_stocks 테마 구성종목 조회 ~94

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

Input Output Examples

Name	Type	Req	Description
theme_code	string	yes	테마 그룹 코드 (get_theme_groups의 '코드' 열 값)

No output schema declared.

No examples provided.

get_trading_journal 당일매매일지 조회 ~108

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

Input Output Examples

Name	Type	Req	Description
base_date	string	—	조회 기준일 (기본값: 오늘, 최근 2개월 이내)

No output schema declared.

No examples provided.

get_transactions 계좌 거래내역 조회 ~136

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

Input Output Examples

Name	Type	Req	Description
from_date	string	—	조회 시작일 (기본값: 30일 전)
stock_code	string	—	특정 종목만 조회할 때의 6자리 종목코드
to_date	string	—	조회 종료일 (기본값: 오늘)

No output schema declared.

No examples provided.

get_valuation_rank PER·PBR·ROE 순위 조회 (시장 전체) ~219

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

Input Output Examples

Name	Type	Req	Description
metric	string	—	정렬 기준 (기본값: low_per). low_per 저PER / high_per 고PER / low_pbr 저PBR / high_pbr 고PBR / low_roe 저ROE(적자 상위) / high_roe 고ROE
top	integer	—	표시할 종목 수 (기본값 20, 최대 100)

No output schema declared.

No examples provided.

get_vi_stocks VI 발동 종목 조회 ~226

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

Input Output Examples

Name	Type	Req	Description
direction	string	—	발동 방향 (기본값: all)
market	string	—	시장 구분 (기본값: all)
stock_code	string	—	특정 종목의 발동 내역만 조회 (생략 시 전체)
top	integer	—	표시할 건수 (기본값 20, 최대 50)
vi_type	string	—	VI 유형 (기본값: all)

No output schema declared.

No examples provided.

get_watchlist 관심종목 그룹 상세 ~130

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

Input Output Examples

Name	Type	Req	Description
group	string	yes	관심종목 그룹코드 또는 그룹명 (get_watchlist_groups로 확인)

No output schema declared.

No examples provided.

get_watchlist_groups 관심종목 그룹 목록 ~83

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

ping Ping ~35

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

search_stock 종목 검색 (이름→코드) ~155

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

Input Output Examples

Name	Type	Req	Description
query	string	yes	종목명 일부(예: '삼성전자', 'KODEX 미국') 또는 6자리 종목코드

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug