---
title: "Holdings"
method: GET
path: "/api/fund/holdings"
tags: ["ETF/MF"]
---

# Holdings

`GET /api/fund/holdings`

![Starter](https://img.shields.io/badge/Starter-3b82f6) ![ETF](https://img.shields.io/badge/ETF-14b8a6) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

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.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `page` integer
- `pageSize` integer
- `reportDate` string, date

## Response `200`

Paginated ETF holdings

- object
  - `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, nullable — Quarter end date of the N-PORT filing
  - `data` object[]
    - `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)

## Other responses

- `400` — Symbol not found or not a fund (ETF or mutual fund)
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)