io.github.oon4am-eng/hold · v1.0.1 · finance-and-payments
HOLD! Korea Stock Ownership & Insider Trades is healthy: it completed an MCP handshake in 768 ms and exposes 8 tools.
Who owns Korean listed stocks, from DART filings: 5% holders, insiders, stake changes, average cost.
Endpoint: https://whohold.com/mcp (streamable-http)
Repository · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 8 |
| Latency | 768 ms |
| Last checked (UTC) | 2026-11-09T04:10:21.801Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-11-09T04:10:21.801Z | Healthy | 768 |
search_symbol | 종목명 일부나 종목코드로 지금 상장된 한국 종목을 찾는다. 다른 도구의 ticker 인자로 쓸 값을 얻는다. |
search_holder | 보유자(기관·운용사·개인) 이름으로 보유자를 찾는다. 한글로 쳐도 영문 보고자가 나온다(블랙록 → BlackRockFundAdvisors). 같은 이름의 다른 사람·회사는 행이 나뉜다: kind는 person(개인)/corp(법인)/inst(기관), role은 개인의 최근 임원·주요주주 보고 기준 회사와 직함(예: 삼성전자 회장), key_hint는 회사의 사업자등록번호 앞자리. top은 지분율이 가장 높은 종목, corps는 보고한 종목 수. 결과의 entity_id를 get_portfolio·get_recent_changes·g |
get_holders | 종목의 주요 보유자와 지분율(특별관계자 합산). source=major는 5% 대량보유 보고, insider는 임원·주요주주(10% 이상 주주 포함) 보고이며 1% 이상만. 보유자별 최신 공시 기준. 최근 2년 안에 보고가 없는 보유자는 빠지고 외국인·소액주주 합계도 없다. 모든 행에 as_of(공시일)와 source_url(공시 원문). |
get_holder_history | 한 종목의 지분 변동 공시 전체 이력(최신순, 대량보유와 임원·주요주주 보고 모두). ticker가 필수이고 기간 제한이 없어 '이 회사 지분이 언제 어떻게 바뀌었나'에 쓴다. 여러 종목에 걸쳐 최근 며칠 새 공시를 훑으려면 get_recent_changes를 쓴다. holder로 보고자명 일부를 주면 그 보고자만. change_type은 new/listing/increase/decrease/exit/unchanged. listing은 상장으로 처음 공시한 것이라 매수가 아니다. non_trade가 true면 회생 출자전환, 감자, |
get_portfolio | 보유자(기본 국민연금)가 보유한 종목 목록과 지분율, 지분율 높은 순. 5% 대량보유 보고 또는 1% 이상 임원·주요주주 보고가 있는 종목만. entity_id(search_holder 결과)를 주면 그 한 사람·한 회사의 보유만 나온다. holder(이름 일부)로 찾으면 같은 이름의 다른 보유자와 미확인 보고가 섞일 수 있으니 행의 entity_id를 본다. value는 공시된 주식수 × 최근 종가(원), total_value는 그 합계. total이 shown보다 크면 limit을 올려 더 받을 수 있다. |
get_avg_cost | 한 종목의 보유자별 평균 매입단가(원). 5% 대량보유 보고서 원문의 세부변동내역에 적힌 취득 단가로 매수는 가중평균에 더하고 매도는 수량만 줄이는 이동평균을 내며, 액면분할·병합은 보정한다. 임원·주요주주 보고에는 단가가 없어 쓰지 않는다. holder(보고자명 일부)를 주면 그 보유자만, 없으면 단가가 있는 보유자 전부. 행마다 avg_cost, held_shares(현재 보유), priced_shares(단가가 붙은 매수 주식), coverage_pct, buys, first_trade·last_trade를 준다. basis가 |
get_recent_changes | 최근 N일(기본 7일) 동안 올라온 지분 변동 공시 피드(최신순). 여러 종목을 가로질러 '이번 주 누가 사고팔았나'를 볼 때 쓴다. ticker를 주면 그 종목만, holder·entity_id를 주면 그 보유자만 거른다. 기간 제한 없이 한 종목의 전체 이력이 필요하면 get_holder_history를 쓴다. 기본 50건이며 limit으로 조절. change가 listing이거나 non_trade가 true인 행은 시장 매수·매도가 아니므로 매매 합계에서 빼야 한다. kind는 5% 공시의 신규·증가 방식이다: buy(매수), |
get_filing | 공시 한 건의 세부 내역. 다른 도구 결과의 source_url(DART 주소)이나 14자리 접수번호(rcept_no)를 넣는다. reports는 그 공시의 보유자 행(지분율, 변동, 공시일), members는 5% 보고의 보고자·특별관계자별 보유 주식수와 지분율, trades는 세부변동내역(실제 거래일, 취득·처분 방법, 주식 종류, 변동 전후 수량, 단가). members·trades는 원문을 받은 5% 대량보유 보고에만 있다. 어떤 거래로 지분이 바뀌었는지, 매수인지 출자전환인지 확인할 때 쓴다. |