Daily Holdings

GET/api/fund/holdings/daily

Returns a fund's daily holdings, sourced directly from the issuer's own website once a day, with pagination. This is far more current than the quarterly SEC N-PORT data behind /api/fund/holdings.

When reportDate is omitted (the default), returns the most recent day we have on file. When reportDate is set, resolves point-in-time: the most recent snapshot on or before that date is returned. Either way the actual as-of date served is in the reportDate response field — it can be older than the requested date, since some issuers publish month- or quarter-end holdings. We retain roughly 30 days of snapshot history per fund (accumulating from early August 2026), and a fund's most recent snapshot is always kept regardless of age. An empty result set means the fund has no snapshot on or before the requested date. Holdings are sorted by portfolio weight (pctVal) descending.

Each holding carries only the fields the source actually provides; fields without a value are omitted. The shape mirrors /api/fund/holdings and is a superset of it: in addition to the common equity fields it surfaces sedol, currency, sector, and bond economics (couponRate, maturityDate) for fixed-income funds. Note that, unlike the N-PORT endpoint, daily holdings are not mapped to a CIK/mappedSymbol and carry no fair-value level.

Use /api/fund/holdings/daily/supported-funds to discover which funds are covered.

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)

Example: 1
pageSize integer optional min 1 · max 1000 · default 50

Number of results per page

Example: 50
reportDate string (date) optional

Historical date (YYYY-MM-DD) to retrieve holdings as of. When omitted (the default), the most recent day on file is returned. When set, resolves point-in-time: the most recent snapshot on or before this date is returned — possibly older than requested, so check the reportDate response field for the actual as-of day. Roughly 30 days of history are retained per fund; a date earlier than the fund's oldest stored snapshot returns an empty result set.

Example: 2026-08-01

Example request

curl 'https://api.stockfit.io/v1/api/fund/holdings/daily?symbol=SPY&cik=884394&composite_figi=BBG000BDTBL9&page=1&pageSize=50&reportDate=2026-08-01' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Paginated daily fund holdings (most recent day on file, or the most recent snapshot on or before `reportDate` when given)

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 on the as-of day
reportDate string | null
As-of date of the holdings (YYYY-MM-DD), or null when the fund has no daily holdings on file
data array of object
Holdings for the page, sorted by weight descending. Each object contains only the fields the source provides.
array of:
- name string
  Security / issuer name
- ticker string
  Ticker symbol as published by the fund
- cusip string
  CUSIP identifier
- isin string
  ISIN identifier
- sedol string
  SEDOL identifier
- title string
  Security title / class (e.g. "Common Stock")
- balance number
  Quantity held (shares, or par for fixed income — see `units`)
- units string
  Unit of `balance` (NS = number of shares, PA = principal amount)
- currency string
  Trading/local currency (ISO 4217)
- valueUsd number
  Market value of the position (USD)
- pctVal number
  Weight as a percentage of net assets
- sector string
  Sector classification, as published by the fund
- assetCat string
  Asset category, as published by the fund
- issuerCat string
  Issuer category, as published by the fund
- country string
  Country of the issuer (ISO 2-letter code, or fund-published name)
- payoffProfile string
  Payoff profile (Long or Short)
- couponRate number
  Coupon rate for a fixed-income holding (percent). Present only for bond holdings.
- maturityDate string
  Maturity date for a fixed-income holding (YYYY-MM-DD; left as the issuer's raw text only when it is a non-date value such as a pooled-MBS range). Present only for bond holdings.

Example response

{
  "page": 1,
  "pageSize": 50,
  "totalPages": 11,
  "totalResults": 505,
  "reportDate": "2026-06-22",
  "data": [
    {
      "name": "NVIDIA CORP",
      "ticker": "NVDA",
      "cusip": "67066G104",
      "isin": "US67066G1040",
      "sedol": "2379504",
      "title": "Common Stock",
      "balance": 9876543,
      "units": "NS",
      "currency": "USD",
      "valueUsd": 1404483720,
      "pctVal": 7.21,
      "sector": "Information Technology",
      "assetCat": "Equity",
      "issuerCat": "Corporate",
      "country": "US",
      "payoffProfile": "Long",
      "couponRate": 4.25,
      "maturityDate": "2035-02-15"
    }
  ]
}

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

{}