Portfolio composition

GET/api/fund/composition

Returns a breakdown of the fund's portfolio by asset type, country, issuer type, and top 10 holdings from the most recent N-PORT filing. Useful for understanding portfolio diversification at a glance.

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.

Example request

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

Responses

200 OK

Portfolio composition breakdown

Response schema

reportDate string
Report date of the N-PORT filing
assetTypes array of object
Holdings grouped by asset category
array of:
- category string
  Asset category code (EC = equity common, EP = equity preferred, DBT = debt, STIV = short-term investment vehicle, etc.)
- count integer
  Number of holdings in this category
- weight number
  Percentage of net assets
countries array of object
Holdings grouped by country of issuer
array of:
- category string
  ISO 2-letter country code
- count integer
- weight number
issuerTypes array of object
Holdings grouped by issuer category
array of:
- category string
  Issuer category (CORP = corporate, UST = US Treasury, USGA = US Government Agency, etc.)
- count integer
- weight number
top10 array of object
Top 10 holdings by portfolio weight
array of:
- name string
- cusip string
- pctVal number
  Percentage of net assets
- valueUsd number
  Market value (USD)
- mappedSymbol string | null
  Mapped ticker symbol
top10Weight number
Combined weight of top 10 holdings (%)

Example response

{
  "reportDate": "2025-12-31",
  "assetTypes": [
    {
      "category": "EC",
      "count": 498,
      "weight": 99.82
    }
  ],
  "countries": [
    {
      "category": "US",
      "count": 498,
      "weight": 99.52
    }
  ],
  "issuerTypes": [
    {
      "category": "CORP",
      "count": 498,
      "weight": 99.82
    }
  ],
  "top10": [
    {
      "name": "NVIDIA Corp",
      "cusip": "67066G104",
      "pctVal": 7.75,
      "valueUsd": 55218508208,
      "mappedSymbol": "NVDA"
    }
  ],
  "top10Weight": 36.82
}

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

{}