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

Equities

Market Capitalization

GET/v2/equities/market-cap

Returns the current market capitalization for an equity.

The currency is not fixed per security: since 1 Sep 2026 new values are in the filer's reporting currency where one is on file, otherwise EUR; not the listing currency. Read metricCurrency rather than assuming EUR, USD or the listing currency. It is the same series served as market_cap by /v2/equities/metrics.

Included in: Startup, 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 symbol=AAPL.

  • stringquery · one of symbol, isin

    Stock ticker symbol (e.g., AAPL, MSFT, GOOGL). Provide exactly one of symbol or isin.

    Example AAPL

  • stringquery · one of symbol, isin

    ISIN code (e.g., US0378331005). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN.

Response 200

Successful response · application/json

  • data
    MarketCapSnapshot

    Current market capitalization.

    3 fields in data
    • metricCurrency
      string
      required

      Currency of the market capitalization value (ISO 4217)

      Example: USD

    • metricDate
      string

      Observation date

      Example: 2026-03-24T00:00:00

    • metricValue
      number (double)
      required

      Market capitalization value

      Example: 3690170000000

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