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

ETFs

ETF Countries Top

GET/v2/etfs/countries/top

Returns top countries by allocation.

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

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
    object
    2 fields in data
    • atDate
      string (date)

      Observation date for the exposure data

    • countryExposure
      array of ETFCountryExposure
      3 fields in countryExposure
      • country
        string
        required

        Country name

        Example: United States

      • exposure
        number (double)
        required

        Exposure percentage

        Example: 97.57

      • synthetic
        boolean

        true when the row is Bavest-generated rather than scraped from an issuer breakdown. Applies to products without a published geographic allocation, mainly crypto and commodity funds.

        Example: false

  • meta
    ResponseMeta

    Response metadata for paginated endpoints. Offset pagination returns page/pageSize/totalPages/totalCount; cursor pagination returns pageSize/hasMore/nextCursor and totalCount only when known.

    8 fields in meta
    • time
      integer

      Server-side processing time in milliseconds

      Example: 17

    • parameters
      object

      Echo of the request parameters the endpoint resolved

    • page
      integer

      Current page number (offset pagination)

      Example: 1

    • pageSize
      integer

      Number of results per page

      Example: 50

    • totalPages
      integer

      Total number of pages (offset pagination)

      Example: 2

    • totalCount
      integer

      Total number of results across all pages

      Example: 100

    • hasMore
      boolean

      Whether more results follow (cursor pagination)

    • nextCursor
      string | null

      Cursor for the next page (cursor pagination), null on the last page

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_top_countries.md, every route in /llms.txt, the OpenAPI spec at /openapi.json.