GET/indicator/ichimoku

Ichimoku Cloud

Category: Trend · Updated November 2026

The TAAPI.IO Ichimoku Cloud API returns conversion, base, span a, span b values for the Ichimoku Cloud 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/ichimoku`
Outputs	`conversion`, `base`, `spanA`, `spanB`, `currentSpanA`, `currentSpanB` and more
Markets	Binance, Binance Futures, Bybit, Gate.io, Kraken and US stocks
Timeframes	`1m` to `1w`
Delivery	REST, bulk and WebSocket

Get Ichimoku Cloud with one API call

This request returns Ichimoku Cloud for BTCUSDT on 1-hour Binance candles. Add your API key to run it here.

curl -G https://v2.taapi.io/indicator/ichimoku \
  -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/ichimoku',
    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/ichimoku?${params}`, {
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
console.log(await res.json());

Ichimoku Cloud API response

This response came from the live API on 9 November 2026. Long lists are shortened here.

200 OK

{
  "conversion": [74674.61],
  "base": [74855],
  "spanA": [74764.805],
  "spanB": [74879.995],
  "currentSpanA": [75869.20999999999],
  "currentSpanB": [75633],
  "laggingSpanA": [75794.08],
  "laggingSpanB": [77841.005],
  "timestamp": [1794218400]
}

Field	Type	Description
`conversion`	number[]	Conversion
`base`	number[]	Base
`spanA`	number[]	Span a
`spanB`	number[]	Span b
`currentSpanA`	number[]	Current span a
`currentSpanB`	number[]	Current span b
`laggingSpanA`	number[]	Lagging span a
`laggingSpanB`	number[]	Lagging span b
`timestamp`	integer[]	Unix time of each candle, in seconds

Ichimoku Cloud 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`
`conversionPeriod`	integer	No	9	Conversion period
`basePeriod`	integer	No	26	Base period
`spanPeriod`	integer	No	52	Span period
`displacement`	integer	No	26	Displacement
`results`	integer	No	1	Number of values to return, or `max`
`backtrack`	integer	No	0	Candles to skip from the most recent

What is Ichimoku Cloud?

Ichimoku Kinko Hyo, developed by Goichi Hosoda, is a complete trend system built from midpoints of highs and lows. The cloud between its two spans acts as dynamic support and resistance, and the spans are projected forward in time.

Ichimoku Cloud formula

Output	Calculation
Conversion	(highest high + lowest low) ÷ 2 over `conversionPeriod`
Base	(highest high + lowest low) ÷ 2 over `basePeriod`
Span A	(conversion + base) ÷ 2, displaced forward
Span B	(highest high + lowest low) ÷ 2 over `spanPeriod`, displaced forward

How to read Ichimoku Cloud in your code

Signal	Meaning	Condition
Bullish momentum	Tenkan above Kijun	`conversion` above `base`
Bearish momentum	Tenkan below Kijun	`conversion` below `base`
Above the cloud	Bullish trend	Close above `currentSpanA` and `currentSpanB`
Below the cloud	Bearish trend	Close below `currentSpanA` and `currentSpanB`

Limitations: Several lines give several signals, and the cloud is flat and uninformative in ranges. Its default settings were designed for a six-day trading week. Nothing on this page is financial advice.

Compare the last two closed Ichimoku Cloud values

Use backtrack=1 to skip the candle still forming, and results=2 to compare the last two closed candles. Arrays run oldest first.

curl -G https://v2.taapi.io/indicator/ichimoku \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=2" \
  --data-urlencode "backtrack=1"

import requests

resp = requests.get(
    'https://v2.taapi.io/indicator/ichimoku',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    params={'exchange': 'binance', 'symbol': 'BTCUSDT', 'timeframe': '1h', 'results': 2, 'backtrack': 1},
)
data = resp.json()
prev, last = data['conversion']
print('conversion', prev, '->', last)
print('rising' if last > prev else 'falling or flat')

Get historical Ichimoku Cloud 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/ichimoku \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "exchange=binance" \
  --data-urlencode "symbol=BTCUSDT" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "results=100"

Get Ichimoku Cloud for multiple symbols

Combine Ichimoku Cloud 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.

POST/bulk

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": "ichimoku",
          "indicator": "ichimoku"
        },
        {
          "id": "rsi",
          "indicator": "rsi"
        }
      ]
    }
  ]
}'

Stream Ichimoku Cloud 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.

WSSwss://v2.taapi.io/streaming

{
  "type": "subscribe",
  "id": "ichimoku",
  "exchange": "binance",
  "symbol": "BTCUSDT",
  "interval": "1m",
  "indicator": "ichimoku"
}

Ichimoku Cloud API FAQ

What does the Ichimoku Cloud API return?

It returns conversion, base, spanA, spanB, currentSpanA, currentSpanB, laggingSpanA, laggingSpanB, plus a timestamp for the request. Results are JSON.

Is the latest Ichimoku Cloud 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.

Which Ichimoku Cloud settings can I change?

You can set conversionPeriod, basePeriod, spanPeriod, displacement. See the parameters table above for defaults.

Can I get Ichimoku Cloud for US stocks?

Yes. Use exchange=stocks with a ticker such as AAPL. US stocks are included on the Pro plan and above.

What is the difference between spanA and currentSpanA?

spanA and spanB are the projected spans. currentSpanA and currentSpanB are the cloud edges at the current candle, which is what you compare with price.

See the full list of indicators, or start for free.