ichimoku-cloud

What problem does it solve?

It generates objective buy/sell/stand-aside signals from OHLCV price data using the Ichimoku Kinko Hyo five-line method, so you don’t have to manually compute indicators and interpret the cloud.

Core Features & Use Cases

• Five-line Ichimoku computation: Calculates Tenkan-sen, Kijun-sen, Senkou Span A/B (cloud boundaries), and derives cloud top/bottom for filtering.
• Deterministic signal generation: Emits 1 (long), -1 (short), or 0 (stand aside) using TK crossover detection plus cloud position and cloud direction filters (A > B vs A < B).
• Warm-up handling: Enforces a minimum history length (52 + 26) so signals aren’t produced with insufficient data.
• Use case: Apply it to daily crypto candles (e.g., BTC-USDT / ETH-USDT) to consistently evaluate trend quality and create a rule-based signal series for backtesting.

Quick Start

Use the ichimoku-cloud skill to generate long/short/neutral signals from a pandas OHLCV DataFrame that includes open, high, low, and close columns indexed by datetime.