ETF Holdings
GET/v1/etf-holdings/{ticker}
Retrieve constituent holdings and weight percentages for an ETF or mutual fund ticker. Each holding includes the underlying asset ticker, name and portfolio weight so you can analyze concentration, replicate baskets or explain what a fund owns. Use ETF and fund tickers only (e.g. SPY, QQQ); for common stocks this endpoint returns no holdings.
Use cases
- Analyzing ETF exposure and top holdings (e.g. SPY constituents)
- Portfolio overlap and concentration checks
- Fund comparison and due diligence
- Feeding constituent lists into quote or risk systems
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | ETF or fund ticker, e.g. SPY. |
Output parameters
| Field | Type | Description |
|---|---|---|
| ticker | string | ETF or fund ticker requested. |
| holdings | array | Indexed constituent positions. |
| holdings[].asset | string | Underlying asset ticker. |
| holdings[].name | string | Underlying asset name. |
| holdings[].weightPercentage | float | Portfolio weight percent. |
| holdings[].sharesNumber | integer | Shares held when available. |
| holdings[].marketValue | float | Reported market value in USD when available. |
| holdingsCount | integer | Total constituents reported by the fund. |
| syncedAt | string | Holdings sync timestamp (ISO 8601). |
| valuesSyncedAt | string | Market-value enrichment timestamp (ISO 8601). |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_etf_holdings("SPY")
print(result){
"ticker": "SPY",
"holdings": [
{
"hasCompanyProfile": true,
"computedValueUsd": 63618134101.14,
"holdingValueSyncedAt": "2026-06-03T16:00:07Z",
"securityCusip": "67066G104",
"name": "NVIDIA CORP",
"weightPercentage": 8.39,
"sharesNumber": 293144107,
"marketValue": 63920382154,
"asset": "NVDA",
"isin": "US67066G1040",
"updatedAt": "2026-05-13 02:05:01",
"lastPrice": 217.02
},
{
"hasCompanyProfile": true,
"computedValueUsd": 55172012522.88,
"holdingValueSyncedAt": "2026-06-03T16:00:07Z",
"securityCusip": "037833100",
"name": "APPLE INC",
"weightPercentage": 6.76,
"sharesNumber": 177105844,
"marketValue": 51507242219,
"asset": "AAPL",
"isin": "US0378331005",
"updatedAt": "2026-05-13 02:05:01",
"lastPrice": 311.52
}
],
"valuesSyncedAt": "2026-06-03T16:00:07Z",
"syncedAt": "2026-06-05T22:02:50-04:00",
"holdingsCount": 504
}