ichimoku

name	ichimoku
description	Ichimoku Kinko Hyo five-line system signal engine. A standalone Japanese technical-analysis school that generates trading signals from Tenkan/Kijun crossovers, cloud position, and Chikou confirmation. Pure pandas implementation.
category	strategy

Ichimoku Kinko Hyo

Purpose

A standalone Japanese technical analysis framework that uses a five-line system and the cloud to provide a complete trend-evaluation structure:

Line	Japanese	Calculation	Meaning
Conversion line	Tenkan-sen	(9H+9L)/2	Short-term trend
Base line	Kijun-sen	(26H+26L)/2	Medium-term trend
Leading Span A	Senkou Span A	(Tenkan+Kijun)/2 shifted forward by 26	Upper cloud boundary
Leading Span B	Senkou Span B	(52H+52L)/2 shifted forward by 26	Lower cloud boundary
Lagging Span	Chikou Span	Closing price shifted backward by 26	Trend confirmation

Signal Logic

Signals are triggered only on TK crossover events, with three filters:

• Strong buy: bullish TK cross + price above the cloud + bullish cloud (A > B)
• Strong sell: bearish TK cross + price below the cloud + bearish cloud (A < B)
• All other cases → stand aside

Warm-up requires 78 candles (52+26).

Parameters

Parameter	Default	Description
tenkan_period	9	Tenkan-sen period
kijun_period	26	Kijun-sen period
senkou_b_period	52	Senkou Span B period
displacement	26	Forward/backward shift period

Dependencies

pip install pandas numpy requests

Signal Convention

• 1 = long, -1 = short, 0 = stand aside