Funds & ETFs
Top-10 holdings churn between two snapshot dates
Diff between the top-10 holdings of two ETF snapshots. Returns three buckets: new_top_10 (appeared in to_date, absent from from_date), dropped_from_top_10 (in from_date, absent from to_date), and weight_changed (present in both). The mandatory caveat field discloses that the upstream feed reports a top-10 sample only - drop-outs may remain in the portfolio but fell below the top-10 rank threshold.
get/api/v1/etf/{symbol}/top-holdings/changes
Path parameters
symbolstring required
ETF ticker.
Example:SPY
ETF ticker.
Query parameters
from_datestring required
Older snapshot date (YYYY-MM-DD).
Older snapshot date (YYYY-MM-DD).
to_datestring required
Newer snapshot date (YYYY-MM-DD).
Newer snapshot date (YYYY-MM-DD).
Response
Top-10 churn payload with caveat field.
Example response
{
"data": {
"new_top_10": [
{
"symbol": "AAPL",
"name": "Apple Inc",
"weight_pct": 7.21,
"sector": "technology",
"asset_class": "equity"
}
],
"dropped_from_top_10": [
{
"symbol": "AAPL",
"name": "Apple Inc",
"weight_pct": 7.21,
"sector": "technology",
"asset_class": "equity"
}
]
},
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}