Candlestick (OHLCV) Data API
Get raw candlestick data — open, high, low, close and volume — for any crypto pair, stock or forex symbol through one API call. Whether you're charting, backtesting, or detecting candlestick patterns like doji and engulfing, our Candles API delivers clean OHLCV in JSON on any timeframe, real-time or historical.
Try it in 30 seconds
Code samples: Node · Python · PHP · cURL →[GET] https://v2.taapi.io/candles
Authorization: Bearer YOUR_API_KEY
?exchange=binance
&symbol=BTC/USDT
&timeframe=1h
[
{
"timestamp": 1718233200,
"timestampHuman": "2024-06-12 21:00:00",
"open": 67420.50,
"high": 68100.00,
"low": 67180.20,
"close": 67854.30,
"volume": 1842.73
}
]
What is Candles?
Candlestick data (OHLCV) is the foundation of technical analysis. Each candle encodes four price points — open, high, low, close — plus the period's total volume. The shape and sequence of candles form patterns (doji, hammer, engulfing, morning star) that traders have used for centuries to anticipate market moves. Our Candles API delivers this data for any asset, on any exchange, on any timeframe, without you managing WebSocket connections or normalising exchange-specific data formats.
Candles trading strategies
Candlestick pattern detection
Pull multiple candles in one call using the 'results' parameter, then scan for classic patterns: doji (open ≈ close), hammer (long lower wick), engulfing (current candle body swallows previous). 'Doji API' is a top search query landing on this page — the data is here.
Backtesting & strategy development
Historical OHLCV is the raw material for every backtest. Use the 'results' parameter to fetch hundreds of candles per call and feed them directly into your strategy engine — no exchange WebSocket juggling required.
Live charting data feeds
Need to power a real-time chart? Poll the Candles endpoint on your chosen interval for the latest candle, or combine with the Price endpoint for a tick-level feed. Lightweight and exchange-agnostic.
Frequently asked questions
What does the Candles API return?
The Candles endpoint returns an array of OHLCV objects. Each object contains: timestamp, open, high, low, close, and volume for the requested candle interval and symbol.
How do I get multiple candles in one call?
Use the 'results' parameter (e.g. results=100) to return the last N closed candles in a single request. This is the most efficient way to fetch historical data for backtesting or chart rendering.
What candlestick patterns can I detect?
You can detect any pattern from the raw OHLCV data — doji, hammer, shooting star, engulfing, morning star, evening star, and hundreds more. The Candles endpoint gives you the raw data; your code or a pattern library does the detection.
Is the data real-time?
Yes. The current (unclosed) candle updates in real time. Closed candles are final. For the most current close price, use the Price endpoint for simplicity.
Related indicators
Building with the Candles API?
The developer documentation covers the full technical reference: the /candles endpoint, every parameter, the response schema, rate limits, bulk queries and ready-to-run samples in Node.js, Python, PHP and cURL.
Ready to get started?
Request your free API key and pull Candles values for any market in minutes. 7-day free trial on all paid plans.
Get free API key