Get Institutional Holders
get_institutional_holdersWho holds a company, from 13F filings: how much of each share class institutions hold, and how that changed quarter by quarter. The company-side view of 13F; get_holdings is the manager side (what one institution owns).
Use it for questions like:
"What % of AMD do institutions hold, and how has it changed over the last 4 quarters?" -> quarters=4; read quarters[].share_classes[].pct_of_class.
"Is Baupost an investor in AMD?" -> holder="Baupost" (a name fragment or a filer CIK). holder.matched_filers says which filers the name matched (empty: no 13F filer has it), holder.positions each quarter's position, holder.not_held_in the quarters with none. With holder the response is lean unless detail="full".
"Who are the largest holders / who bought or sold most last quarter?" -> top_holders, biggest_buyers, biggest_sellers, largest_new_positions, largest_exits.
"Who owns more than 5%?" -> large_holders_5pct (latest 13D/13G per holder).
"Every holder, with last quarter's position" -> limit=500, then offset=next_offset while next_offset is present (quarters[0].holders says how many there are). Each row has prev_shares and change_shares.
"How big is the position for each manager?" -> each holder row carries book_value_usd (the manager's whole 13F for the quarter, as filed, options included) and pct_of_book; no need to call get_holdings per manager.
quarters[] is newest complete quarter first (the one still being filed is in_progress_quarter), each with holders, shares_held, value_usd and share_classes[] (per cover-page class: shares_outstanding, held_by_13f, pct_of_class), share_count_source and holders_url.
Report each share class separately; never add classes together. Caveats to state: 13F is as filed and not deduplicated, options are excluded, holdings can exceed 100% for heavily shorted stocks, and a "new position" may be a manager whose previous 13F was late. Cite share_count_source for share counts and holders_url for holdings.
Args: company: Ticker (e.g. "AMD") or CIK of the company being held (not of the institution); for a company name, get them from search_companies first quarters: Number of complete quarters, newest first (1-12, default 4) holder: Optional 13F filer to follow across the quarters: a name fragment ("Baupost", "Berkshire") or a CIK ("1061768") limit: Number of top holders to return for the latest quarter (1-500, default 25) detail: "lean" or "full". Default: lean when holder is given (just the holder's positions, share classes and sources), full otherwise (adds top holders, buyers, sellers, new positions, exits and 5%+ holders) ticker: Same as company (models often name it so) cik: Same as company offset: Skip this many top holders (paging; the response's next_offset gives the next page)
A ticker that cannot be tied to a company (an index option such as XSP, a former ticker) is not an error: the response has empty quarters and not_covered with the reason, and ticker_used_by names companies whose cover pages stated it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_institutional_holders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | No | ||
| limit | No | ||
| detail | No | ||
| holder | No | ||
| offset | No | ||
| ticker | No | ||
| company | No | ||
| quarters | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||