--- title: "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." method: GET path: "/v1/etfs/{ticker}/holdings" tags: ["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. `GET /v1/etfs/{ticker}/holdings` ## Request - Base URL: `https://api.equibles.com` - URL: `https://api.equibles.com/v1/etfs/{ticker}/holdings` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `ticker` string, required ## Query parameters - `limit` integer - `offset` integer ## Response `200` OK - EtfHoldingsResponse: Paged holdings of an ETF's most recent NPORT-P report, with the report header facts alongside the standard paged envelope. Matches the shape of the registered-fund holdings endpoint so a caller can read either with one parser. - `ticker` string, nullable: The exchange-traded ticker the holdings were resolved from. - `name` string, 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. - `reportPeriodDate` string, date, nullable: The date the reported portfolio is as of. - `netAssets` number, 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. - `netAssetsCurrency` string, nullable: ISO 4217 currency of netAssets for a fund on another exchange; absent for a US fund. - `exchange` string, nullable: The exchange (MIC) of a fund listed outside the US; absent for a US fund. - `totalHoldings` integer: Total holding rows stored for the report; paging spans this count. - `reportedHoldingCount` integer, 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. - `holdingsCoverage` string, 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. - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data. - `status` string, nullable: "delisted" or "renamed". - `ticker` string, nullable: The retired ticker as listed. - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known. - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted". - `data` EtfHoldingDto[], nullable - `name` string, nullable: Holding name exactly as the source states it. - `ticker` string, nullable: For a US fund, the ticker resolved from the holding CUSIP against tracked stocks; for a fund on another exchange, the platform symbol of the listing the holding's ISIN (or stated US ticker) names, such as AAPL or XETR:SAP. Null when nothing we hold matches. - `cusip` string, nullable: CUSIP as filed in an NPORT-P report; null where the filing states none, and for a fund on another exchange. Always present, as it was before those funds shared this row. - `isin` string, nullable: ISIN as the sponsor's file states it; absent for a US fund and where the file states none. - `balance` number, double, nullable: Quantity held, in the unit stated by units; absent where the source states none. - `units` string, nullable: The unit balance is expressed in, as filed (for example NS for number of shares); absent where unstated. - `valueUsd` number, double, nullable: Position value in US dollars, as filed in an NPORT-P report; absent for a fund on another exchange. - `percentOfNetAssets` number, double, nullable: Position value as a percentage of the fund's net assets, as filed in an NPORT-P report. - `weightPercent` number, double, nullable: Weight of the position in the fund, in percent, as the sponsor's file states it; absent for a US fund. - `marketValue` number, double, nullable: Position value in the stated currency, as the sponsor's file states it; absent where unstated. - `currency` string, nullable: ISO 4217 currency of marketValue and of the holding's line; absent where unstated. - `assetCategory` string, nullable: Asset category as the source states it (SEC code such as EC for a US fund; the sponsor's own class, such as Equity or Futures, for a fund on another exchange). - `sector` string, nullable: Sector as the sponsor's file states it; absent for a US fund. - `exchange` string, nullable: Exchange name as the sponsor's file states it; absent for a US fund. - `country` string, nullable: Investment country: the SEC code as filed for a US fund, the sponsor's own country name otherwise. - `meta` PageMeta - `limit` integer - `offset` integer - `count` integer - `hasMore` boolean - `total` integer, nullable ## Other responses - `400`: Bad Request - `404`: Not Found ## Changes - **2026-11-06** `666e06778588`: 1 info - endpoint added [Operation history](https://skmtc.dev/equibles/apis/equibles-api/changes/v1/etfs/:ticker/holdings/get.md) --- [API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/83f13ba1a993?raw)