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

Timeseries Data

Real-Time Quote

GET/v2/timeseries/quote

Returns real-time or delayed quote with OHLC, price change, volume.

Access depends on your account agreement and API-key permissions.

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.

  • stringquery · no

    Target currency (ISO 4217). When provided, prices are converted from the native currency using the latest FX rate. Example when explicitly filtering: USD.

  • stringquery · no

    Optional listing venue to pin the response to a specific exchange. Accepts the venue's ISO 10383 MIC (XWBO for the Wiener Börse, XNAS for NASDAQ) as well as our own short code for the same venue (VIE, NASDAQ, MUN); both spellings resolve to the same listings. Segment MICs are not resolved yet. For a venue whose segments carry their own MIC (the Wiener Börse's WBAH, WBGF, WBDM), pin the operating MIC XWBO or the short code VIE. Honored for isin AND symbol requests. When omitted, the listing named by the symbol answers (our symbols are RICs: EBS.VI is the Vienna listing, EBO.DE the XETRA one); for an isin request, or for a named listing that has no data in the requested window, the security's canonical listing answers. Where the response has an exchange field, it always names the venue that actually answered. A venue the instrument is not listed on is never silently replaced by another listing. /v2/timeseries/candles rejects it with 400 and names the venues the instrument does have, while /v2/timeseries/eod and /v2/timeseries/quote return no data.

Response 200

Successful response · application/json

  • data
    Quote

    Real-time or delayed quote snapshot.

    12 fields in data
    • exchange
      string | null

      Venue the quote was read from. Set from the listing that answered, not from the request, so an unpinned quote still names its exchange. Null when the listing carries no venue. NAV when source is nav.

      Example: NASDAQ

    • currentPrice
      number (double)
      required

      Current or last traded price

      Example: 222.75

    • open
      number (double)

      Opening price

      Example: 225.05

    • high
      number (double)

      Intraday high

      Example: 225.6

    • low
      number (double)

      Intraday low

      Example: 220.75

    • previousClose
      number (double)

      Previous session close. When source is nav, the NAV before the latest one.

      Example: 225

    • change
      number (double)

      Price change since previous close (absolute)

      Example: -2.25

    • changePercent
      number (double)

      Price change since previous close (%)

      Example: -1

    • timestamp
      integer (int64)
      required

      Unix epoch seconds. When source is nav, the NAV date at 00:00 UTC.

      Example: 1773352065

    • volume
      number (double) | null

      Intraday volume. Null when the listing's bars carry no volume, and when source is nav (a NAV is not traded).

      Example: 3214728

    • currency
      string

      Quote currency (ISO 4217), always a MAJOR unit. A venue quoting in a minor unit (LSE in pence) is restated in its major unit, so this never returns GBp, ZAc or KWF and the client needs no scaling.

      Example: USD

    • source
      string

      What the quote is. listing is an exchange listing's latest tick or bar. nav is the security's net asset value (NAV), in either of two cases. The quote was read from the fund's NAV series, reported with exchange NAV. Or no listing of the ISIN has a tick or a bar in the last 180 days and the latest stored NAV is served instead. On a NAV quote, currentPrice, open, high and low are the latest NAV, previousClose is the NAV before it, and volume is null. Listing prices always take precedence over the stored NAV.

      One of listing, nav.

      Example: listing

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