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.
symbol string optional 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.
cik integer optional SEC Central Index Key (CIK).
cusip string optional CUSIP identifier (9 characters).
composite_figi string optional Composite OpenFIGI identifier.
share_class_figi string optional Share-class OpenFIGI identifier.
days integer optional How many calendar days back the window starts
top integer optional How many of each snapshot's largest holdings are followed
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'The window's snapshots and what moved across them
dates array of string (date) Snapshot dates, oldest first
portfolio array of object One entry per date, aligned with `dates`
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
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
{
"dates": [
"string"
],
"portfolio": [
{
"date": "string",
"positions": 0,
"totalWeight": 0
}
],
"holdings": [
{
"cusip": "string",
"name": "string",
"ticker": "string",
"weights": [
0
]
}
],
"change": {}
}Invalid parameters or unknown fund
error string Human-readable error message
{
"error": "Error description goes here"
}Feature not available on current plan
error string Human-readable error message
{
"error": "Error description goes here"
}