Heikin-Ashi Candles
Category: Price & market data · Updated November 2026
The TAAPI.IO Heikin-Ashi Candles API returns values values for the Heikin-Ashi Candles indicator as JSON, for crypto pairs and US stocks. Send an exchange, symbol and timeframe to get real-time or historical data, with no candles to download and no calculations to maintain.
| Spec | Value |
|---|---|
| Endpoint | GET https://v2.taapi.io/indicator/heikinashicandles |
| Outputs | values |
| Markets | Binance, Binance Futures, Bybit, Gate.io, Kraken and US stocks |
| Timeframes | 1m to 1w |
| Delivery | REST, bulk and WebSocket |
Get Heikin-Ashi Candles with one API call
This request returns Heikin-Ashi Candles for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.
curl -G https://v2.taapi.io/indicator/heikinashicandles \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "exchange=binance" \ --data-urlencode "symbol=BTCUSDT" \ --data-urlencode "timeframe=1h"
import requests
resp = requests.get(
'https://v2.taapi.io/indicator/heikinashicandles',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h'},
)
print(resp.json())const params = new URLSearchParams({"exchange": "binance", "symbol": "BTCUSDT", "timeframe": "1h"});
const res = await fetch(`https://v2.taapi.io/indicator/heikinashicandles?${params}`, {
headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
console.log(await res.json());Heikin-Ashi Candles API response
This response came from the live API on 9 November 2026. Long lists are shortened here.
{
"values": [{"open": 74343.41209816196, "high": 74354.01, "low": 74087.91, "close": 74207.9075, "volume": 303.5903099999999, "timestamp": 1794218400, "timestampHuman": "2026-11-09 10:00:00"}],
"timestamp": [1794218400]
}| Field | Type | Description |
|---|---|---|
values | object[] | Heikin-Ashi Candles result |
timestamp | integer[] | Unix time of each candle, in seconds |
Heikin-Ashi Candles API parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
exchange | string | Yes | — | binance, binancefutures, bybit, gateio, kraken or stocks |
symbol | string | Yes | — | Pair or ticker, e.g. BTCUSDT or AAPL |
timeframe | string | Yes | — | 1m 5m 15m 1h 4h 1d 1w |
results | integer | No | 1 | Number of values to return, or max |
backtrack | integer | No | 0 | Candles to skip from the most recent |
What is Heikin-Ashi Candles?
Heikin-Ashi candles average price data to produce smoother candles, which makes trends easier to see. Each new candle blends the current candle with the prior Heikin-Ashi candle.
Heikin-Ashi Candles formula
| Output | Calculation |
|---|---|
| HA close | (open + high + low + close) ÷ 4 |
| HA open | (previous HA open + previous HA close) ÷ 2 |
| HA high / low | Extremes of high or low, HA open and HA close |
How to read Heikin-Ashi Candles in your code
| Signal | Meaning | Condition |
|---|---|---|
| Candle series | Smoothed OHLC data | Entries in values |
| Trend candles | Strong trend | Consecutive HA closes above HA opens, or below |
Limitations: The prices are synthetic and do not match real traded prices, so do not use them for fills or stops. Nothing on this page is financial advice.
Read Heikin-Ashi Candles from Python
Use backtrack=1 to read the result as of the last closed candle.
curl -G https://v2.taapi.io/indicator/heikinashicandles \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "exchange=binance" \ --data-urlencode "symbol=BTCUSDT" \ --data-urlencode "timeframe=1h" \ --data-urlencode "backtrack=1"
import requests
resp = requests.get(
'https://v2.taapi.io/indicator/heikinashicandles',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h', 'backtrack': 1},
)
data = resp.json()
print(data['values'])Get historical Heikin-Ashi Candles values
Add results to return a series for backtesting or charting. The last element is the most recent candle.
curl -G https://v2.taapi.io/indicator/heikinashicandles \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "exchange=binance" \ --data-urlencode "symbol=BTCUSDT" \ --data-urlencode "timeframe=1h" \ --data-urlencode "results=100"
Get Heikin-Ashi Candles for multiple symbols
Combine Heikin-Ashi Candles with other indicators in one request. Each exchange, symbol and timeframe combination is one construct: Basic allows 1 per request, Pro 3 and Expert 10.
curl -X POST https://v2.taapi.io/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"constructs": [
{
"id": "btc_1h",
"exchange": "binance",
"symbol": "BTCUSDT",
"timeframe": "1h",
"indicators": [
{
"id": "heikinashicandles",
"indicator": "heikinashicandles"
},
{
"id": "rsi",
"indicator": "rsi"
}
]
}
]
}'Stream Heikin-Ashi Candles in real time
Subscribe over WebSocket to receive new values every 5 seconds while the candle is forming. Streaming supports 1m, 5m, 15m and 1h, and uses interval where REST uses timeframe.
{
"type": "subscribe",
"id": "heikinashicandles",
"exchange": "binance",
"symbol": "BTCUSDT",
"interval": "1m",
"indicator": "heikinashicandles"
}Heikin-Ashi Candles API FAQ
What does the Heikin-Ashi Candles API return?
It returns values, plus a timestamp for the request. Results are JSON.
Is the latest Heikin-Ashi Candles value final?
No. The newest value belongs to the candle still forming and can change until it closes. Add backtrack=1 to read the last closed candle.
Can I get Heikin-Ashi Candles for US stocks?
Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.
Related indicators
See the full list of indicators, or start for free.