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

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

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

### Meta

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

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


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