외국인 보유 추이 조회
get_foreign_holdingQuery foreign holding trends per stock — daily net change, shares held, ratio, limit exhaustion — or market rankings by limit surge, cumulative net buying, and 3-day streaks.
Instructions
외국인 보유(한도) 동향을 조회합니다 (키움 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와는 데이터 소스가 다릅니다(같은 종목에서 부호가 반대일 수 있음).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | rank 모드에서 표시할 종목 수 (기본 20, 최대 100) | |
| days | No | 기준 기간(거래일) — limit_surge는 1/5/10/20 (기본 5), period_net은 1/3/5/10/20/60/120 (기본 20). streak는 3일 고정이라 이 값을 받지 않습니다 | |
| rank | No | 시장 전체 순위 종류 — limit_surge(한도소진율 증가 상위)/period_net(기간 누적 순매매 상위)/streak(3일 연속 같은 방향 순매매). stock_code를 생략할 때 씁니다 | |
| limit | No | 종목 추이 모드에서 표시할 일수 (기본 15, 최대 50; 최신순) | |
| market | No | 시장 구분 — rank 모드에서만 사용 (기본값 all) | |
| direction | No | period_net·streak 방향 — net_sell(순매도, 기본)/net_buy(순매수) | |
| stock_code | No | 조회할 6자리 종목코드 — 주면 종목 추이 모드 |