# Intraday Stock Candles API
> Live intraday and historical OHLCV candles for stocks, indices, ETFs, crypto and FX, served from Yahoo Finance's public chart feed. The candles endpoint returns regular-session bars — open, high, low, close and volume — at a chosen interval (1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 1wk, 1mo) over a range, each bar timestamped. The extended endpoint returns the pre-market and after-hours (extended-hours) bars, each labelled with its session. The latest endpoint returns an intraday snapshot — current price, day change and percent, the day open/high/low and volume, the 52-week range and the most recent bar. Symbols follow Yahoo conventions: US tickers (AAPL, MSFT), indices (^GSPC, ^IXIC), crypto (BTC-USD) and FX (EURUSD=X). This is the intraday candlestick / OHLCV view — per-minute to hourly bars plus extended hours — distinct from the daily price-history, the live-quote and the FX/rate APIs in the catalogue. Live, no key on the upstream, nothing stored.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/intraday-api/..."
```

## Pricing
- **Free** (Free) — 27,000 calls/Mo, 5 req/s
- **Starter** ($9/Mo) — 315,000 calls/Mo, 15 req/s
- **Pro** ($25/Mo) — 1,360,000 calls/Mo, 40 req/s
- **Scale** ($57/Mo) — 4,900,000 calls/Mo, 100 req/s

## Endpoints

### Candles

#### `GET /v1/candles` — Regular-session OHLCV bars

**Parameters:**
- `symbol` (query, required, string) — Yahoo symbol (ticker, ^index, crypto, FX) Example: `AAPL`
- `interval` (query, optional, string) — 1m,2m,5m,15m,30m,60m,90m,1h,1d,1wk,1mo Example: `5m`
- `range` (query, optional, string) — 1d,5d,1mo,3mo,6mo,1y,2y,5y,10y,ytd,max Example: `1d`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/intraday-api/v1/candles?symbol=AAPL&interval=5m&range=1d"
```

**Response:**
```json
{
    "data": {
        "type": "EQUITY",
        "count": 78,
        "price": 295.63,
        "range": "1d",
        "source": "Yahoo Finance",
        "symbol": "AAPL",
        "candles": [
            {
                "low": 291.0400085449219,
                "high": 293.7850036621094,
                "open": 293.7200012207031,
                "time": "2026-06-11T13:30:00.000Z",
                "close": 291.32000732421875,
                "volume": 1642520
            },
            {
                "low": 290.3800048828125,
                "high": 292.05999755859375,
                "open": 291.3349914550781,
                "time": "2026-06-11T13:35:00.000Z",
                "close": 292.05999755859375,
                "volume": 564024
            },
            {
                "low": 291.4700012207031,
                "high": 292.29998779296875,
                "open": 292.0295104980469,
                "time": "2026-06-11T13:40:00.000Z",
                "close": 292.04901123046875,
                "volume": 463823
            },
            {
                "low": 291.6400146484375,
                "high": 293.1400146484375,
                "open": 292.0450134277344,
                "time": "2026-06-11T13:45:00.000Z",
                "close": 292.739990234375,
                "volume": 538144
            },
            {
                "low": 292.6199951171875,
                "high": 293.95001220703125,
                "open": 292.7300109863281,
               
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/extended` — Pre-market & after-hours bars

**Parameters:**
- `symbol` (query, required, string) — Yahoo symbol Example: `AAPL`
- `interval` (query, optional, string) — Intraday interval Example: `5m`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/intraday-api/v1/extended?symbol=AAPL&interval=5m"
```

**Response:**
```json
{
    "data": {
        "type": "EQUITY",
        "count": 115,
        "price": 295.63,
        "range": "1d",
        "source": "Yahoo Finance",
        "symbol": "AAPL",
        "currency": "USD",
        "exchange": "NasdaqGS",
        "interval": "5m",
        "timezone": "America/New_York",
        "extended_hours_candles": [
            {
                "low": 291.58,
                "high": 294.23,
                "open": 292.5277,
                "time": "2026-06-11T08:00:00.000Z",
                "close": 293.1488,
                "volume": 0,
                "session": "pre"
            },
            {
                "low": 292.45,
                "high": 294.18,
                "open": 293.1407,
                "time": "2026-06-11T08:05:00.000Z",
                "close": 292.74,
                "volume": 0,
                "session": "pre"
            },
            {
                "low": 291.73,
                "high": 292.8465,
                "open": 292.7112,
                "time": "2026-06-11T08:10:00.000Z",
                "close": 291.9927,
                "volume": 0,
                "session": "pre"
            },
            {
                "low": 291.7392,
                "high": 292.6961,
                "open": 291.97,
                "time": "2026-06-11T08:15:00.000Z",
                "close": 292.336,
                "volume": 0,
                "session": "pre"
            },
            {
                "low": 292,
                "high":
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/latest` — Intraday snapshot

**Parameters:**
- `symbol` (query, required, string) — Yahoo symbol Example: `AAPL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/intraday-api/v1/latest?symbol=AAPL"
```

**Response:**
```json
{
    "data": {
        "type": "EQUITY",
        "price": 295.63,
        "change": 4.05,
        "source": "Yahoo Finance",
        "symbol": "AAPL",
        "day_low": 289.6000061035156,
        "currency": "USD",
        "day_high": 297,
        "day_open": 293.7200012207031,
        "exchange": "NasdaqGS",
        "timezone": "America/New_York",
        "change_pct": 1.389,
        "day_volume": 31814827,
        "last_bar_time": "2026-06-11T19:55:00.000Z",
        "previous_close": 291.58,
        "fifty_two_week_low": 195.07,
        "fifty_two_week_high": 317.4
    },
    "meta": {
        "timestamp": "2026-06-12T01:41:39.151Z",
        "request_id": "eaf7b4da-3cbe-463c-930a-3dbb4d54d2da"
    },
    "status": "ok",
    "message": "Latest snapshot retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Spec

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/intraday-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "symbol uses Yahoo conventions: US tickers (AAPL), indices (^GSPC, ^IXIC), crypto (BTC-USD), FX (EURUSD=X). interval: 1m,2m,5m,15m,30m,60m,90m,1h,1d,1wk,1mo. range: 1d,5d,1mo,3mo,6mo,1y,2y,5y,10y,ytd,max. Per-minute intervals are limited by Yahoo to short ranges; extended hours apply only intraday.",
        "source": "Yahoo Finance chart v8 (query1.finance.yahoo.com, live)",
        "service": "intraday-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/latest": "Intraday snapshot — price, day change, day high/low, 52w range, last bar (symbol=AAPL).",
            "GET /v1/candles": "Regular-session OHLCV bars (symbol=AAPL, interval=5m, range=1d).",
            "GET /v1/extended": "Pre-market & after-hours bars with session label (symbol=AAPL, interval=5m)."
        },
        "aapl_price": 295.63,
        "description": "Live intraday & historical OHLCV candles for stocks, indices, ETFs, crypto and FX from Yahoo Finance. candles returns regular-session bars at a chosen interval (1m…1h, 1d, 1wk, 1mo) over a range; extended returns pre-market and after-hours bars with a session label; latest returns an intraday snapshot (current price, day change, day high/low, volume, 52-week range, last bar). Live, no key, nothing stored. The intraday candlestick/OHLCV view, distinct from the daily price-history, live-quote and FX/rate APIs.",
        "upstream_status": "ok"
    },
    "meta": {
        "timesta
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/intraday-api
OpenAPI spec: https://www.oanor.com/api/intraday-api/openapi.json
