For AI agents: complete Markdown index · compact index. Follow the explicit .md links for the Markdown version of each page.

ETFs

ETF Profile

GET/v2/etfs/profile

Returns 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 is meta.totalCount on /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:

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 null where the issuer does not publish it. cusip and website may also be an empty string for non-US listings.

    16 fields in data
    • symbol
      string | null

      ETF ticker symbol

      Example: ARKK

    • isin
      string | null

      ETF ISIN code

      Example: IE00B4L5Y983

    • name
      string | null
      required

      Official ETF name

      Example: ARK Innovation ETF

    • description
      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: IE

    • inceptionDate
      string (date) | null

      Date the ETF was launched

    • etfCompany
      string | null

      Name of the ETF issuer or management company

      Example: ARK Invest

    • assetClass
      string | null

      Broad asset class (e.g. Equity, Fixed Income, Commodity)

      Example: Equity

    • cusip
      string | null

      CUSIP identifier for the ETF, empty string for non-US listings

      Example: 78462F103

    • distributionPolicy
      string | null

      Distribution policy (e.g. Accumulating, Distributing)

    • etfCategory
      string | null

      Investment category within the asset class

      Example: U.S. Equity

    • etfFocus
      string | null

      Investment focus or strategy

      Example: Broad Market

    • etfNiche
      string | null

      Specific niche or investment approach

      Example: Index Tracking

    • indice
      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 EUR

    • replicationMethod
      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: 17

    • parameters
      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.
  • 403 from the gateway: the API key is invalid or switched off.

  • 429 with message Limit Exceeded: the monthly quota of the key is used up. With Too Many Requests: the key is throttled, or this route is not in the key's plan. Wait for Retry-After when it is sent.

For AI agents: this page as Markdown at /docs/v2_etfs_profile.md, every route in /llms.txt, the OpenAPI spec at /openapi.json.