Etfs

Get an ETF's stored holdings from its latest SEC Form NPORT-P report, largest position first. holdingsCoverage is fullPortfolio, trackedEquitiesOnly, or unknown when counts are missing or inconsistent.

Changed on
get/v1/etfs/{ticker}/holdings

Request

Path parameters

tickerstring required

Exact exchange-traded ticker (for example SPY).

Query parameters

limitinteger

Maximum rows to return (1–500; default varies per endpoint).

offsetinteger

Rows to skip before the first returned row (default 0).

Response

OK

tickerstring nullable

The exchange-traded ticker the holdings were resolved from.

namestring nullable

SEC series name, or the listing's own registered security name when the ticker is that listing's own primary ticker; null when neither is stated.

reportPeriodDatestring date nullable

The date the reported portfolio is as of.

netAssetsnumber double nullable

Net assets from the report header: US dollars for a US fund, netAssetsCurrency for a fund on another exchange; null where the source states none.

netAssetsCurrencystring nullable

ISO 4217 currency of netAssets for a fund on another exchange; absent for a US fund.

exchangestring nullable

The exchange (MIC) of a fund listed outside the US; absent for a US fund.

totalHoldingsinteger

Total holding rows stored for the report; paging spans this count.

reportedHoldingCountinteger nullable

Full investment-row count reported in the NPORT-P filing before this platform's storage filter. Null while an older filing awaits parser replay.

holdingsCoveragestring nullable

What totalHoldings counts: "fullPortfolio" when stored and reported counts agree, "trackedEquitiesOnly" when fewer rows are stored, "unknown" when counts are missing or inconsistent, or "sponsorFile" for a fund on another exchange, whose rows are its sponsor's whole published file.

Changes