ETFs
ETF Profile
/v2/etfs/profileReturns ETF identity and classification.
Fees, risk metrics, structure and NAV live in dedicated resources:
/v2/etfs/fees,/v2/etfs/risk,/v2/etfs/structure,/v2/securities/nav,/v2/etfs/metrics. Holdings count ismeta.totalCounton/v2/etfs/holdings.
Included in: Pro, Growth.
Migrating from ETF Profile
The legacy ETF Profile documentation now points here. Use GET /v2/etfs/profile with exactly one query identifier: isin or symbol. For example, use isin=IE00B4L5Y983 and omit symbol.
The v2 profile contains ETF identity and classification. Read other data from its dedicated resource:
- ETF Fees for fees.
- ETF Risk for risk metrics.
- ETF Structure for fund structure.
- Security NAV for net asset value.
- ETF Metrics for additional metrics.
- ETF Holdings for holdings; the holdings count is
meta.totalCounton that response.
Check the response fields below when updating your parser. Handle nullable metadata values and fetch the dedicated resources your application needs instead of expecting all data in one profile response.
This redirect moves documentation. Update your API request and response parsing separately; the legacy response shape is not assumed to match v2.
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
Required: one of symbol, isin, for example isin=IE00B4L5Y983.
- stringquery · one of symbol, isin
ETF ticker symbol (e.g.,
IWDA.AS). Provide exactly one of symbol or isin; clear the ISIN example before using a symbol. - stringquery · one of symbol, isin
ETF ISIN code (e.g.,
IE00B4L5Y983, iShares Core MSCI World UCITS ETF). Provide exactly one of symbol or isin.Example
IE00B4L5Y983
Response 200
Successful response · application/json
data- ETFProfile
Core ETF identity and classification.
Every property is always present in the response; any value may be
nullwhere the issuer does not publish it.cusipandwebsitemay also be an empty string for non-US listings.16 fields in data
symbol- string | null
ETF ticker symbol
Example:
ARKKisin- string | null
ETF ISIN code
Example:
IE00B4L5Y983name- string | null
- required
Official ETF name
Example:
ARK Innovation ETFdescription- string | null
Brief description of the ETF's investment objective
website- string | null
URL of the ETF issuer's product page, empty string if unknown
domicile- string | null
Country of domicile (ISO 3166-1 alpha-2 code)
Example:
IEinceptionDate- string (date) | null
Date the ETF was launched
etfCompany- string | null
Name of the ETF issuer or management company
Example:
ARK InvestassetClass- string | null
Broad asset class (e.g. Equity, Fixed Income, Commodity)
Example:
Equitycusip- string | null
CUSIP identifier for the ETF, empty string for non-US listings
Example:
78462F103distributionPolicy- string | null
Distribution policy (e.g. Accumulating, Distributing)
etfCategory- string | null
Investment category within the asset class
Example:
U.S. EquityetfFocus- string | null
Investment focus or strategy
Example:
Broad MarketetfNiche- string | null
Specific niche or investment approach
Example:
Index Trackingindice- string | null
Name of the tracked index as published by the issuer. Free text, not normalised: either the index family alone (
S&P 500®,MSCI World) or the full index variant with return type, currency and hedging (STOXX Europe 600 NR EUR,S&P 500® ESG Elite (EUR Hedged)). Suffixes are part of the official index name: PR/NR/TR = price, net total return, gross total return; EUR/USD = index currency;Hedged= currency-hedged variant. Null for actively managed ETFs or when the index is not captured. Intended for display; do not join or filter on it.Example:
STOXX Europe 600 NR EURreplicationMethod- string | null
Index replication method (e.g. Full, Sampling, Synthetic)
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.
- 502 Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
- 503 Bavest cannot read its data store right now. The security may well have data; retry after the `Retry-After` header interval.
- 504 The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
- default An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
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.

