ETFs
ETF Asset Class Breakdown
/v2/etfs/asset-class-breakdownReturns asset-class allocation percentages based on holdings, including recursive look-through of underlying funds and ETFs. Preserves signed weights and reports missing or unclassified exposure as unknown.
Included in: Pro, Growth.
Authentication
Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key (free trial) · Authentication guide.
Parameters
Optional, at most one of symbol, isin, cusip, for example isin=IE00B4L5Y983.
- stringquery · no (at most one of symbol, isin, cusip)
ETF ticker symbol (e.g.,
IWDA.AS). Provide exactly one of symbol or isin; clear the ISIN example before using a symbol. - stringquery · no (at most one of symbol, isin, cusip)
ETF ISIN code (e.g.,
IE00B4L5Y983, iShares Core MSCI World UCITS ETF). Provide exactly one of symbol or isin.Example
IE00B4L5Y983 - stringquery · no (at most one of symbol, isin, cusip)
CUSIP code (e.g.,
037833100). Provide at most one of symbol, isin, or cusip.
Response 200
Holdings-based allocation including explicit unknown weight. · application/json
data- object
3 fields in data
atDate- string (date) | null
oldestHoldingsDate- string (date) | null
assetClassBreakdown- array of object
- required
4 fields in assetClassBreakdown
assetClass- string
- required
One of
equity,fixed_income,cash_money_market,commodities,crypto,other,unknown.percent- number
- required
longPercent- number
shortPercent- number
meta- ResponseMeta
Response metadata, including server-side processing time and resolved request parameters. Successful and error responses use the same metadata shape.
2 fields in meta
time- integer
Server-side processing time in milliseconds
Example:
17parameters- object
Echo of the request parameters the endpoint resolved
Errors
- 400 Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).
- 401 Missing or invalid API key.
- 404 Resource not found.
- 429 Rate limit exceeded. Retry after the `Retry-After` header interval.
- 500 An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
- 503 Bavest cannot read its data store right now. The security may well have data; retry after the `Retry-After` header interval.
403from the gateway: the API key is invalid or switched off.429with messageLimit Exceeded: the monthly quota of the key is used up. WithToo Many Requests: the key is throttled, or this route is not in the key's plan. Wait forRetry-Afterwhen it is sent.

