Holdings

GET/api/fund/holdings

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 key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

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.

Example: SPY
cik integer optional

SEC Central Index Key (CIK).

Example: 884394
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000BDTBL9
share_class_figi string optional

Share-class OpenFIGI identifier.
page integer optional min 1 · max 1000 · default 1

Page number (1-indexed)
pageSize integer optional min 1 · max 1000 · default 50

Number of results per page
reportDate string (date) optional

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.

Example: 2025-09-30

Example request

curl 'https://api.stockfit.io/v1/api/fund/holdings?symbol=SPY&cik=884394&composite_figi=BBG000BDTBL9&reportDate=2025-09-30' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Paginated ETF holdings

Response schema

page integer
Current page number (1-indexed)
pageSize integer
Number of results per page
totalPages integer
Total number of pages
totalResults integer
Total number of holdings
reportDate string | null
Quarter end date of the N-PORT filing
data array of object
array of:
- name string
  Holding name
- cusip string
  CUSIP identifier
- isin string
  ISIN identifier
- ticker string
  Ticker symbol as reported in the filing
- title string
  Security title
- valueUsd number
  Market value of the holding (USD)
- pctVal number
  Percentage of net assets
- balance number
  Number of shares or units held
- units string
  Unit type (NS = number of shares, PA = principal amount, etc.)
- assetCat string
  Asset category (EC = equity common, DBT = debt, etc.)
- issuerCat string
  Issuer category (CORP = corporate, SOVN = sovereign, etc.)
- country string
  Country of issuer (ISO 2-letter code)
- payoffProfile string
  Payoff profile (Long, Short, or N/A)
- fairValueLevel integer
  Fair value hierarchy level (1, 2, or 3)
- mappedCik integer
  SEC CIK of the held company (mapped by us; omitted when unmapped)
- mappedSymbol string
  Ticker symbol of the held company (mapped by us; omitted when unmapped)
- reportDate string
  Report date of the N-PORT filing (YYYY-MM-DD)

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"
    }
  ]
}

400 Bad Request

Symbol not found or not a fund (ETF or mutual fund)

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}