latestOpenAPI 3.0.02026-08-2010141507.9 KB

3d5897270d8a

ETF/MF

Holdings

Starter ETF Pro

Returns the individual holdings of a fund from a single SEC N-PORT filing, with pagination. Defaults to the most recent filing; pass reportDate to retrieve the holdings as of a specific historical quarter. Holdings are sorted by portfolio weight descending. Where possible, holdings are mapped to their CIK and ticker symbol.

Use /api/fund/profile to discover which quarter-end reportDate values are available for a fund.

get/api/fund/holdings

Query parameters

symbolstring

Fund ticker symbol (ETF or mutual fund). Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

cikinteger

SEC Central Index Key (CIK).

cusipstring

CUSIP identifier (9 characters).

composite_figistring

Composite OpenFIGI identifier.

share_class_figistring

Share-class OpenFIGI identifier.

pageinteger

Page number (1-indexed)

pageSizeinteger

Number of results per page

reportDatestring date

Report date (YYYY-MM-DD) to retrieve holdings as of. Resolves point-in-time: the holdings from the most recent N-PORT filing on or before this date are returned, so you do not need to know the exact quarter-end. The actual filing date used is returned in the reportDate response field. When omitted, the most recent filing is used. A date earlier than the fund's first filing returns an empty result set. Available report dates are listed by /api/fund/profile.

Response

Paginated ETF holdings

pageinteger

Current page number (1-indexed)

pageSizeinteger

Number of results per page

totalPagesinteger

Total number of pages

totalResultsinteger

Total number of holdings

reportDatestring nullable

Quarter end date of the N-PORT filing

Example response

{
  "page": 1,
  "pageSize": 50,
  "totalPages": 10,
  "totalResults": 503,
  "reportDate": "2025-12-31",
  "data": [
    {
      "name": "NVIDIA Corp",
      "cusip": "67066G104",
      "isin": "US67066G1040",
      "ticker": "NVDA",
      "title": "NVIDIA Corp",
      "valueUsd": 55218508208,
      "pctVal": 7.754618397194,
      "balance": 296077792,
      "units": "NS",
      "assetCat": "EC",
      "issuerCat": "CORP",
      "country": "US",
      "payoffProfile": "Long",
      "fairValueLevel": 1,
      "mappedCik": 1045810,
      "mappedSymbol": "NVDA",
      "reportDate": "2025-12-31"
    }
  ]
}