Ichimoku Cloud Explained: Automating the Most Complex Indicator

// GET /v1/indicators?symbol=EURUSD&timeframe=H4
{
  "success": true,
  "data": {
    "symbol": "EURUSD",
    "timeframe": "H4",
    "ohlcv": {
      "close": 1.0868
    },
    "indicators": {
      "Ichimoku_tenkan": 1.0862,
      "Ichimoku_kijun": 1.0845,
      "Ichimoku_senkou_a": 1.0854
    },
    "updated_at": 1787229614
  }
}

import requests

API_KEY = "your_api_key_here"
BASE_URL = "https://tickatlas.com/v1"

def ichimoku_score(symbol: str, timeframe: str = "H4") -> dict:
    """Score Ichimoku signal from -5 (strong bearish) to +5 (strong bullish)."""
    resp = requests.get(f"{BASE_URL}/indicators", params={
        "symbol": symbol,
        "timeframe": timeframe,
    }, headers={"X-API-Key": API_KEY})

    data = resp.json()["data"]
    ich = data["indicators"]
    price = data["ohlcv"]["close"]

    # The API publishes Tenkan, Kijun and Senkou Span A. Senkou Span B and the
    # Chikou Span are not published, so derive both from the candles.
    candles = requests.get(f"{BASE_URL}/ohlc", params={
        "symbol": symbol, "timeframe": timeframe, "limit": 60
    }, headers={"X-API-Key": API_KEY}).json()["data"]["candles"]

    last_52 = candles[-52:]
    senkou_a = ich["Ichimoku_senkou_a"]
    senkou_b = (max(c["high"] for c in last_52) + min(c["low"] for c in last_52)) / 2
    close_26_ago = candles[-27]["close"]

    score = 0
    reasons = []

    # 1. Price vs Cloud
    cloud_top = max(senkou_a, senkou_b)
    cloud_bottom = min(senkou_a, senkou_b)

    if price > cloud_top:
        score += 1
        reasons.append("Price above cloud (bullish)")
    elif price < cloud_bottom:
        score -= 1
        reasons.append("Price below cloud (bearish)")
    else:
        reasons.append("Price inside cloud (neutral)")

    # 2. Tenkan-sen vs Kijun-sen (TK cross)
    if ich["Ichimoku_tenkan"] > ich["Ichimoku_kijun"]:
        score += 1
        reasons.append("Tenkan above Kijun (bullish cross)")
    else:
        score -= 1
        reasons.append("Tenkan below Kijun (bearish cross)")

    # 3. Cloud color (future cloud direction)
    if senkou_a > senkou_b:
        score += 1
        reasons.append("Cloud is bullish (Span A > Span B)")
    else:
        score -= 1
        reasons.append("Cloud is bearish (Span A < Span B)")

    # 4. Price vs Kijun-sen
    if price > ich["Ichimoku_kijun"]:
        score += 1
        reasons.append("Price above Kijun (bullish)")
    else:
        score -= 1
        reasons.append("Price below Kijun (bearish)")

    # 5. Chikou span: today's close against the price 26 periods back
    if price > close_26_ago:
        score += 1
        reasons.append("Chikou above price (bullish confirmation)")
    else:
        score -= 1
        reasons.append("Chikou below price (bearish confirmation)")

    # Determine signal
    if score >= 4:
        signal = "STRONG_BUY"
    elif score >= 2:
        signal = "BUY"
    elif score <= -4:
        signal = "STRONG_SELL"
    elif score <= -2:
        signal = "SELL"
    else:
        signal = "NEUTRAL"

    return {
        "symbol": symbol,
        "signal": signal,
        "score": score,
        "reasons": reasons
    }

# Scan all major pairs with Ichimoku
pairs = ["EURUSD", "GBPUSD", "USDJPY", "AUDUSD", "XAUUSD", "BTCUSD"]

for pair in pairs:
    result = ichimoku_score(pair)
    if result["signal"] in ("STRONG_BUY", "STRONG_SELL"):
        print(f"\n{result['symbol']}: {result['signal']} (score: {result['score']})")
        for reason in result["reasons"]:
            print(f"  - {reason}")

# Example output:
# XAUUSD: STRONG_BUY (score: 5)
#   - Price above cloud (bullish)
#   - Tenkan above Kijun (bullish cross)
#   - Cloud is bullish (Span A > Span B)
#   - Price above Kijun (bullish)
#   - Chikou above price (bullish confirmation)

def ichimoku_levels(symbol: str) -> dict:
    """Extract key support/resistance levels from Ichimoku."""
    resp = requests.get(f"{BASE_URL}/indicators", params={
        "symbol": symbol,
        "timeframe": "H4",
    }, headers={"X-API-Key": API_KEY})

    ich = resp.json()["data"]["indicators"]

    return {
        "cloud_edge": ich["Ichimoku_senkou_a"],  # Senkou Span A — one cloud boundary
        "key_level": ich["Ichimoku_kijun"],  # Strong S/R level
        "fast_level": ich["Ichimoku_tenkan"],  # Minor S/R level
    }