# Intraday OHLCV

> Returns intraday OHLCV bars for a security on Munich/Gettex (`MUN`) or Tradegate (`XGAT`).

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

Group: Timeseries Data. Route id: `v2_timeseries_intraday`. Restricted access. Your API key must be enabled for this endpoint; contact Bavest to confirm availability.

## Description

Returns intraday OHLCV bars for a security on Munich/Gettex (`MUN`) or Tradegate (`XGAT`). Choose 1, 5, 15, 30 or 60-minute bars; the defaults are `exchange=MUN` and `resolution=1`.

Restricted access. Your API key must be enabled for this endpoint; documenting it does not grant access or include it in a self-service plan.

An identifier is required: symbol, ISIN or CUSIP. If multiple identifiers are supplied, symbol takes precedence over ISIN, then CUSIP. The requested exchange selects the venue's listing; the endpoint does not substitute another venue.

When omitted, `from` defaults to the start of the current UTC day and `to` defaults to the current time. Both bounds are inclusive. An unknown security, a missing listing on the requested venue, or a window without data returns `404`.

The example response is illustrative and is not a live market quote.

## 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 | no | Stock ticker symbol. Supply a symbol, ISIN or CUSIP; prefer one identifier per request. |
| `isin` | query | string | no | ISIN of the security. The example identifies SAP; the exchange must have a listing for the requested security. Example `DE0007164600`. |
| `cusip` | query | string | no | CUSIP identifier, as an alternative to symbol or ISIN. |
| `exchange` | query | string | no | Venue for the intraday listing. One of `MUN`: Munich/Gettex, `XGAT`: Tradegate. Default `MUN`. |
| `resolution` | query | string | no | Bar duration in minutes. One of `1`: 1-minute bars, `5`: 5-minute bars, `15`: 15-minute bars, `30`: 30-minute bars, `60`: 60-minute bars. Default `1`. |
| `from` | query | string | no | Inclusive start, as Unix epoch seconds or an ISO date/time interpreted in UTC. Defaults to the start of the current UTC day. |
| `to` | query | string | no | Inclusive end, as Unix epoch seconds or an ISO date/time interpreted in UTC. Defaults to the current time. |
| `currency` | query | string | no | Requested output currency (ISO 4217). When available, conversion applies the latest FX rate to every bar, not a separate historical rate. If conversion is unavailable the original currency is retained; read data.currency for the actual currency. |

## Response

200 Intraday bars. Example values are illustrative. (`application/json`).

| Field | Type | Always present | Description |
|---|---|---|---|
| `data` | object | no |  |
| `data.exchange` | string | no | The requested venue. One of `MUN`, `XGAT`. |
| `data.resolution` | string | no | Bar duration in minutes. One of `1`, `5`, `15`, `30`, `60`. |
| `data.currency` | string \| null | no | Currency of the returned prices. |
| `data.candles` | array of object | no | OHLCV bars within the requested window. Timestamps are Unix epoch seconds in UTC. |
| `data.candles[].timestamp` | integer (int64) | yes | Bar timestamp in Unix epoch seconds, UTC. Coarser bars use the timestamp of the last contributing minute bar; do not assume it marks the interval start. |
| `data.candles[].open` | number \| null | yes | Opening price. |
| `data.candles[].high` | number \| null | yes | Highest price. |
| `data.candles[].low` | number \| null | yes | Lowest price. |
| `data.candles[].close` | number \| null | yes | Closing price. |
| `data.candles[].volume` | number | yes | Trading volume; not changed by currency conversion. |
| `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_intraday#try-it) on the HTML reference to edit parameters and send a request.

## Example request

```bash
curl 'https://api.bavest.co/v2/timeseries/intraday?isin=DE0007164600&exchange=MUN&resolution=1' \
  -H "x-api-key: $BAVEST_API_KEY"
```

## Example response

```json
{
  "data": {
    "exchange": "MUN",
    "resolution": "1",
    "currency": "EUR",
    "candles": [
      {
        "timestamp": 1768467600,
        "open": 100,
        "high": 101,
        "low": 99.5,
        "close": 100.5,
        "volume": 1200
      },
      {
        "timestamp": 1768467660,
        "open": 100.5,
        "high": 101.25,
        "low": 100.25,
        "close": 100.75,
        "volume": 900
      }
    ]
  },
  "meta": {
    "parameters": {
      "isin": "DE0007164600",
      "exchange": "MUN",
      "resolution": "1"
    },
    "time": 12
  }
}
```

## Errors

| Status | Meaning |
|---|---|
| 400 | Missing or invalid identifier, unsupported exchange/resolution, or invalid date/time. |
| 401 | Missing or invalid API key. |
| 403 | Missing, invalid or disabled API key, or access not enabled for this endpoint. |
| 404 | Security not found, no listing on the requested venue, or no data in the requested window. |
| 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. |
| 503 | Data is temporarily unavailable. Retry later. |

- `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

- [Real-Time Quote](https://docs.bavest.co/docs/v2_timeseries_quote.md): Sibling route; `GET /v2/timeseries/quote`.
- [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`.

## 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_intraday
- 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
