# Real-Time Quote

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

`GET https://api.bavest.co/v2/timeseries/quote`

Group: Timeseries Data. Route id: `v2_timeseries_quote`. 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](https://dashboard.bavest.co/sign-up) (free trial) · [Authentication guide](https://docs.bavest.co/docs/authentication.md).

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `symbol` | query | string | one of symbol, isin | Stock ticker symbol (e.g., `AAPL`, `MSFT`, `GOOGL`). Provide exactly one of symbol or isin. Example `AAPL`. |
| `isin` | query | string | one of symbol, isin | ISIN code (e.g., `US0378331005`). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN. |
| `currency` | query | string | no | Target currency (ISO 4217). When provided, prices are converted from the native currency using the latest FX rate. Example when explicitly filtering: `USD`. |
| `exchange` | query | string | 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. |

Required: one of `symbol`, `isin`, for example `symbol=AAPL`.

## Response

200 Successful response (`application/json`).

| Field | Type | Always present | Description |
|---|---|---|---|
| `data` | Quote | no | Real-time or delayed quote snapshot. |
| `data.exchange` | string \| null | no | 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`. |
| `data.currentPrice` | number (double) | yes | Current or last traded price. Example: `222.75`. |
| `data.open` | number (double) | no | Opening price. Example: `225.05`. |
| `data.high` | number (double) | no | Intraday high. Example: `225.6`. |
| `data.low` | number (double) | no | Intraday low. Example: `220.75`. |
| `data.previousClose` | number (double) | no | Previous session close. When `source` is `nav`, the NAV before the latest one. Example: `225`. |
| `data.change` | number (double) | no | Price change since previous close (absolute) Example: `-2.25`. |
| `data.changePercent` | number (double) | no | Price change since previous close (%) Example: `-1`. |
| `data.timestamp` | integer (int64) | yes | Unix epoch seconds. When `source` is `nav`, the NAV date at 00:00 UTC. Example: `1773352065`. |
| `data.volume` | number (double) \| null | no | Intraday volume. Null when the listing's bars carry no volume, and when `source` is `nav` (a NAV is not traded). Example: `3214728`. |
| `data.currency` | string | no | 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`. |
| `data.source` | string | no | 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 | no | Response metadata, including server-side processing time and resolved request parameters. Successful and error responses use the same metadata shape. |
| `meta.time` | integer | no | Server-side processing time in milliseconds. Example: `17`. |
| `meta.parameters` | object | no | Echo of the request parameters the endpoint resolved. |

## Try it in the browser

Open [Try it](https://docs.bavest.co/docs/v2_timeseries_quote#try-it) on the HTML reference to edit parameters and send a request.

## Example request

```bash
curl 'https://api.bavest.co/v2/timeseries/quote?symbol=AAPL' \
  -H "x-api-key: $BAVEST_API_KEY"
```

## Example response

```json
{
  "data": {
    "exchange": "NASDAQ",
    "currentPrice": 330.32,
    "open": 330,
    "high": 332.48,
    "low": 325.81,
    "previousClose": 333.02,
    "change": -2.7,
    "changePercent": -0.8108,
    "timestamp": 1790812800,
    "volume": 11548257071.44,
    "currency": "USD"
  },
  "meta": {
    "parameters": {
      "symbol": "AAPL"
    },
    "time": 73
  }
}
```

## Errors

| Status | Meaning |
|---|---|
| 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.

## Related routes

- [OHLCV Candles](https://docs.bavest.co/docs/v2_timeseries_candles.md): Sibling route; `GET /v2/timeseries/candles`.
- [End-of-Day Price](https://docs.bavest.co/docs/v2_timeseries_eod.md): Sibling route; `GET /v2/timeseries/eod`.
- [Intraday OHLCV](https://docs.bavest.co/docs/v2_timeseries_intraday.md): Sibling route; `GET /v2/timeseries/intraday`.

## What next

- [Authentication](https://docs.bavest.co/docs/authentication.md): get a key and understand access errors.
- [MCP server](https://docs.bavest.co/docs/mcp.md): use the API from an AI agent.
- [Complete API index](https://docs.bavest.co/llms.txt): find routes in every group.

## Links

- HTML page: https://docs.bavest.co/docs/v2_timeseries_quote
- OpenAPI: https://docs.bavest.co/openapi.json (YAML: https://docs.bavest.co/openapi.yaml)
- Authentication: https://docs.bavest.co/docs/authentication.md
- MCP server for AI agents: https://docs.bavest.co/docs/mcp.md
- All routes: https://docs.bavest.co/llms.txt
