Get Fund Holdings
secedgar_get_fund_holdingsList what an ETF or mutual fund holds, parsed from the NPORT-P portfolio report it files with the SEC every quarter. The input is the fund — a ticker like VOO, a fund series ID, or the registrant trust — which is the opposite direction from the ownership tools: secedgar_get_institutional_holdings and secedgar_find_holders answer who owns a company, this answers what a fund owns. Each position carries the security name, CUSIP/ISIN/LEI where the filer reports them, share balance, market value in USD, and percent of the fund's net assets, alongside fund-level net assets and total assets. Positions are returned largest-first by percent of net assets, one page of limit rows starting at offset; the full report registers as df_ when a canvas is available — inspect it with secedgar_dataframe_describe, then analyze it with secedgar_dataframe_query, which is how a fund running to thousands of positions is aggregated or joined against the 13F and insider dataframes. An NPORT-P covers exactly one fund series and a registrant trust files one report per series, so a trust with several funds needs the specific fund named — pass its ticker or series_id. Reports publish roughly two months after the period they cover, so every result is dated: the holdings are the portfolio as of report_period_date, not as of today.
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": {
"fund": "<fund>"
},
"name": "secedgar_get_fund_holdings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fund | Yes | The fund whose portfolio you want — a fund ticker ("VOO", "SCHD"), an SEC fund series ID ("S000002839"), or a 10-digit CIK. A ticker names one share class of one series and routes directly; a CIK names the registrant, which files a separate report per series and needs series_id when it runs more than one fund. Fund trusts are indexed by ticker and series, not by name, so a trust name only resolves for a fund that trades under its own name ("SPDR S&P 500 ETF Trust") — pass the CIK otherwise. | |
| limit | No | Number of positions to return inline, largest first by percent of net assets. Default 20. A broad index fund reports thousands of positions, so the inline list is a preview — read the whole portfolio from the dataframe, or page it with offset. Capped at 100: a larger value, up to 1000, returns what 100 returns. | |
| offset | No | Position to start the page at, 0-based, over the full ordered holdings list. Pass the returned next_offset to read the next page — the report is parsed whole and sliced, so paging is stable and gap-free. | |
| series_id | No | SEC fund series identifier ("S000002839"), naming which fund of the registrant to report. Takes precedence over any series the fund input implies. Series IDs come back on fund results from secedgar_company_search and in the series list of a series_required error. | |
| report_date | No | Target a specific reporting period by its last day (YYYY-MM-DD), e.g. "2025-12-31". Omit for the most recent report. Period ends follow the fund's own fiscal quarters, which are not always calendar quarters — Direxion funds report to February, May, August, and November. available_report_periods in the response lists the ones this call identified; a period missing from that list is still worth requesting directly, since a report the submissions window no longer dates is dated by reading it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit cap applied. | |
| form | No | EDGAR form name — "NPORT-P", or "NPORT-P/A" for an amended report. | |
| fund | No | The fund input, echoed. | |
| as_of | No | The portfolio date these holdings are reported as of, and the publication lag behind it. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of positions shown inline. | |
| notice | No | Guidance when the report carried no positions or the page fell past the end. | |
| offset | No | Position the returned page starts at, 0-based. | |
| dataset | No | Dataframe of every position, each row carrying the fund keys; joins 13F and 13D/G dataframes on cusip. Absent when canvas is unavailable or the report had no positions. | |
| holdings | No | One page of positions, `limit` rows starting at `offset`, largest first by percent of net assets. | |
| class_ids | No | SEC class IDs covered; one report covers every class of the series. | |
| series_id | No | SEC series ID of the fund. Absent when the registrant files as a single fund with no series. | |
| truncated | No | True when the inline holdings list was capped by limit. | |
| resolvedAs | No | How the input was read: a ticker spelling, former ticker, earlier holder, or entity-index match. | |
| filing_date | No | Date the report was submitted to EDGAR (YYYY-MM-DD). | |
| next_offset | No | Offset for the next page. Absent on the last page. | |
| series_name | No | Fund name on the report; a single-registrant closed-end fund names itself here, with no series_id. Absent when blank or "N/A". | |
| net_assets_usd | No | Fund net assets in USD at the report date — the denominator of percent_of_net_assets. | |
| registrant_cik | No | CIK of the registrant trust, zero-padded to 10 digits. | |
| total_holdings | No | Positions in the full report, before offset and limit. | |
| is_final_filing | No | True when the fund marks this its last filing for the series (liquidation or merger). Absent when unstated. | |
| registrant_name | No | EDGAR-conformed name of the registrant trust. | |
| accession_number | No | Accession number for secedgar_get_filing. | |
| total_assets_usd | No | Fund total assets in USD at the report date. | |
| report_period_end | No | Fiscal year end the reporting period falls in (YYYY-MM-DD), not the portfolio date. | |
| report_period_date | No | Portfolio date (YYYY-MM-DD): positions as of this date, not today. Absent only when the filer omits it. | |
| publication_lag_days | No | Days from the portfolio date to the filing date. Absent when the report omits its period date. | |
| total_liabilities_usd | No | Fund total liabilities in USD at the report date. | |
| available_report_periods | No | Period ends of this fund's reports, newest first, about a decade back: what report_date can address. For a trust filing thousands of reports a year, report_date also reaches periods missing here. |