Allocation Breakdown
GET/v1/allocation-breakdown/{ticker}
Retrieve sector and country portfolio weightings for an ETF or mutual fund. Returns sectorAllocations and countryAllocations arrays with weight percentages plus sync timestamps - the allocation breakdown shown on ETF and fund profile pages.
Use cases
- Sector and geographic exposure panels on fund profiles
- Comparing ETF country and sector weights
- Risk and diversification analysis for fund portfolios
- Feeding allocation data into portfolio analytics tools
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | ETF or fund ticker. |
Output parameters
| Field | Type | Description |
|---|---|---|
| ticker | string | ETF or fund ticker. |
| etf | boolean | True when the ticker is an ETF. |
| fund | boolean | True when the ticker is a mutual fund. |
| sectorAllocations | array | GICS sector weight rows. |
| sectorAllocations[].sector | string | Sector name. |
| sectorAllocations[].weightPercentage | float | Portfolio weight percent. |
| countryAllocations | array | Country weight rows. |
| countryAllocations[].country | string | Country name. |
| countryAllocations[].weightPercentage | float | Portfolio weight percent. |
| sectorSyncedAt | string | Sector allocation sync timestamp (ISO 8601). |
| countrySyncedAt | string | Country allocation sync timestamp (ISO 8601). |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_allocation_breakdown("SPY")
print(result){
"ticker": "SPY",
"etf": true,
"fund": false,
"sectorAllocations": [
{
"sector": "Information Technology",
"weightPercentage": 32.45
},
{
"sector": "Financials",
"weightPercentage": 13.12
},
{
"sector": "Health Care",
"weightPercentage": 12.08
}
],
"countryAllocations": [
{
"country": "United States",
"weightPercentage": 97.82
},
{
"country": "Ireland",
"weightPercentage": 0.89
},
{
"country": "United Kingdom",
"weightPercentage": 0.52
}
],
"sectorSyncedAt": "2026-06-05T22:02:50-04:00",
"countrySyncedAt": "2026-06-05T22:02:50-04:00"
}