Dashboard

Daily Holdings History

GET/api/fund/holdings/daily/history

Pro

How a fund's portfolio moved across its daily snapshots, in one call instead of one call per day. Returns the dates in the window, the position count and total weight of each snapshot, the weight of every holding that reached the daily top N, and what was added, removed, increased and decreased between the first and last snapshot.

days defaults to 30 and goes up to 365. Snapshots are kept from early October 2026 on, so a longer window returns what has accumulated since then. top defaults to 10 and bounds what is read out of each snapshot: a holding that never reached a top-top position is not visible in holdings or in change, so raise it to follow smaller positions.

A snapshot can be missing a date even inside the window: the issuer may not have published, or the crawl failed. dates lists what is actually stored, oldest first, and every array is aligned with it.

Get API key Try it live in the API explorer

Query parameters

Example request

curl 'https://api.stockfit.io/v1/api/fund/holdings/daily/history?symbol=SPY&cik=884394&composite_figi=BBG000BDTBL9&days=30&top=10' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

The window's snapshots and what moved across them

Response schema

  • dates array of string (date)

    Snapshot dates, oldest first

  • portfolio array of object

    One entry per date, aligned with `dates`

    array of:
    • date string (date)
    • positions integer

      Rows in the snapshot

    • totalWeight number | null

      Sum of the position weights (about 100)

  • holdings array of object

    Holdings that reached the top N on at least one date, ordered by their best weight

    array of:
    • cusip string | null
    • name string | null
    • ticker string | null
    • weights array of number | null

      Weight per date, aligned with `dates`; null when outside that snapshot's top N

  • change object | null

    Added, removed and moved holdings between the first and last snapshot; null with fewer than two snapshots

Example response

{
  "dates": [
    "string"
  ],
  "portfolio": [
    {
      "date": "string",
      "positions": 0,
      "totalWeight": 0
    }
  ],
  "holdings": [
    {
      "cusip": "string",
      "name": "string",
      "ticker": "string",
      "weights": [
        0
      ]
    }
  ],
  "change": {}
}

400 Bad Request

Invalid parameters or unknown fund

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}

403 Forbidden

Feature not available on current plan

Response schema

  • error string

    Human-readable error message

Example response

{
  "error": "Error description goes here"
}