Get Institutional Holdings
secedgar_get_institutional_holdingsRead an institutional manager's 13F-HR information table for a quarter. company is the filer: a 10-digit CIK, ticker, or name; names outside the ticker file use EDGAR entity search, and ambiguous names return candidates. For managers holding an issuer, use secedgar_find_holders and pass its filer_cik here. Positions carry issuer, CUSIP, shares, whole-USD market value, option designation, and the accessions they came from. Same-period 13F-HR/A amendments are composed in acceptance order: a RESTATEMENT replaces the rows, a NEW HOLDINGS amendment adds its rows, and each amendment reports how it was applied. By default, sub-lines consolidate into positions sorted by value; consolidate=false preserves raw filing order, each filing's rows after the last. Page with limit, offset and returned next_offset. When canvas is available, the full composed positions are staged as df_: inspect with secedgar_dataframe_describe, then aggregate or join on cusip + reporting_period with secedgar_dataframe_query. Managers below $100M in 13(f) securities may not file. Use secedgar_search_filings with forms=["13F-HR"] for broader search.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company": "<company>"
},
"name": "secedgar_get_institutional_holdings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of holdings rows to return. 13F filings from large institutions can contain thousands of positions. Default 20. Capped at 500: a larger value, up to 1000, returns what 500 returns. | |
| offset | No | Row to start the page at, 0-based, over the ordered position list. Pass the next_offset from the previous response to read the next page — the filing is parsed whole and sliced, so paging is stable and gap-free. An offset at or past the position count returns an empty page. | |
| company | Yes | The institutional filer whose 13F to fetch — a 10-digit CIK (e.g. "0000102909" for VANGUARD GROUP INC, the most reliable form), a ticker, or an entity name. A name is matched against the registrants in EDGAR's ticker file first (current and former names) and, when none match, resolved through EDGAR entity search, which covers institutional managers absent from that file; a name matching several filers (some legal names are shared across entities) returns those candidates so you can retry with the exact CIK. This is NOT the portfolio company — passing an issuer ticker like "AAPL" finds that operating company's own filings (it files no 13F), not who holds it; use secedgar_find_holders for that direction. | |
| quarter | No | Reporting quarter to target, in "YYYY-QN" format (e.g., "2025-Q4"), matched exactly against each 13F-HR's period of report. When omitted, returns the most recent 13F-HR in the submissions feed's recent window (the last year or 1,000 filings, whichever holds more). Quarters map to the filing window: Q4 2025 = filings submitted roughly Jan–Mar 2026. A quarter older than the recent window is looked up in the archive, reading forward from the quarter end up to 10 archive pages. A quarter the manager covered with a 13F-NT notice (holdings reported by other managers) fails naming that notice. | |
| consolidate | No | When true (default), info-table sub-lines for the same security (CUSIP + class + put/call) are summed into one position and results are sorted by market value descending, so `limit` returns the largest distinct holdings. Set false to return raw information-table rows in filing order (one per investment-discretion/manager sub-line), preserving investment_discretion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit cap applied. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of holdings shown inline. | |
| notice | No | Amendment composition, discovery, paging, and dataframe guidance. | |
| offset | No | Row the returned page starts at, 0-based. | |
| dataset | No | Composed positions, shaped by consolidate; join on cusip + reporting_period. Absent without canvas or holdings. | |
| holdings | No | `limit` rows from `offset`: positions by value when consolidate=true, else raw rows in application order. | |
| filer_cik | No | CIK of the 13F filer, zero-padded to 10 digits. | |
| truncated | No | True when the inline holdings[] was capped by limit. | |
| amendments | No | Known amendments, newest filed first. Absent if none. | |
| filer_name | No | Institutional filer name (the 13F submitter). | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| filing_date | No | Original 13F-HR filing date (YYYY-MM-DD). | |
| next_offset | No | Offset for the next page. Absent on the last page. | |
| total_positions | No | Distinct positions before paging. Only with consolidate=true. | |
| accession_number | No | Original 13F-HR accession for secedgar_get_filing. | |
| reporting_period | No | Cover-page quarter end (YYYY-MM-DD). Absent if omitted. | |
| composed_accessions | No | Accessions whose rows form holdings, in application order. | |
| total_holdings_composed | No | Composed raw row count before consolidation or paging. | |
| total_holdings_in_filing | No | Original 13F-HR raw row count. | |
| amendment_search_complete | No | False if archive discovery was bounded or unavailable. |