---
title: "Candles"
method: GET
path: "/v1/quotes/{symbol}/candles"
tags: ["quotes"]
---

# Candles

`GET /v1/quotes/{symbol}/candles`

## Request

- Base URL: `https://api.optionwhales.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.optionwhales.io/v1/quotes/{symbol}/candles`
- Auth: none declared

OHLC candles for any ticker — dedicated per-ticker endpoint (PRO+).

Returns ``{symbol, session, timespan, bars: [{t,o,h,l,c,v}], count,
delayed, delay_min}`` (t = epoch ms). Any ticker, browse pattern.

Anti-abuse (2026-06-18): real-time-fresh TODAY candles are a watchlist
privilege, exactly like the quote feed. Charting ANY ticker still works,
but a non-watchlisted ticker's *live* candles are trimmed to
``pro_candles_live_delay_min`` minutes delayed — so the endpoint can't be
swept to rebuild a near-real-time full-market feed (the focused-subset
hole that rate-limiting alone leaves open). Historical sessions are
immutable and always served in full; watchlisted tickers get live candles
untrimmed (consistent with their real-time entitlement).

## Path parameters

- `symbol` string, required

## Query parameters

- `session` string: Session date YYYY-MM-DD; defaults to today
- `timespan` integer: Minutes per bar

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api.md) · [All operations](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api/revisions/e76bc0d3a770?raw)