Get 13F Holdings
get_holdingsGet parsed 13F-HR institutional holdings for a filer.
Returns individual stock positions with issuer name, CUSIP, FIGI, market value, share count, investment discretion, and voting authority, parsed from the 13F information table XML ("format": "xml"), as filed: one row per entry, values in the filer's unit (thousands of dollars for most filings before 2023, dollars since).
13F-HRs filed before SEC introduced the XML table (2013 Q2) carry their holdings as a plain-text table in the filing's own document. For those the result has "format": "text" and "text": that document as filed, paged by line (limit/offset count lines, total_lines says how many). Read the table from it; search_document on its filename finds one position. "period" in the result is the quarter the report covers; "filing_date" is about 45 days later. A "period_note" says when the filer has no 13F for the period asked for and an earlier one is returned (that quarter is not filed yet, or the filer stopped).
Each holding also carries issuer_cik, sic and sic_description (the SEC's SIC industry classification of the issuer, not GICS) when the CUSIP maps to a company with a SIC. In a typical quarter that is about 87% of the value held; funds, ETFs, options and unmapped CUSIPs have none. "with_sic" in the result says how many holdings on this page were classified, so say how much of a portfolio an industry breakdown covers. Use sic_url from get_company to see peers in an industry.
Args: cik: CIK of the 13F filer / institutional investor (e.g. "1535950") period: Report period (YYYY-MM-DD), e.g. 2026-06-30 for the second quarter: the 13F for that period, else the latest period before it. Default: the latest period. limit: Max holdings per page (1-5000, default 500) offset: Pagination offset
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": {
"cik": "<cik>"
},
"name": "get_holdings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | ||
| limit | No | ||
| offset | No | ||
| period | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||