This repository contains two powerful Python scripts for analyzing financial markets using the Ichimoku Kinko Hyo (Ichimoku Cloud) technical analysis system.
ichi_scan.py- Single timeframe Ichimoku momentum scannerichi_mtf_scan.py- Multi-timeframe strategy scanner with advanced ranking
Both scripts analyze forex pairs, cryptocurrencies, and commodities to identify trading opportunities based on Ichimoku cloud analysis.
- Ichimoku Cloud Analysis: Complete analysis using all 5 Ichimoku components
- Multi-Asset Support: Forex pairs, cryptocurrencies (BTC, ETH), and commodities (Gold, Silver)
- Advanced Pattern Recognition: Detects Kijun and Kumo bounces
- ATR-Based Filtering: Uses Average True Range for overextension detection
- Automated Scanning: Processes multiple instruments automatically
- Daily Timeframe Analysis: Focuses on 1-day charts
- Momentum Scoring: 11-point scoring system for trend strength
- Categorized Results: Groups results into Bullish, Bearish, and Neutral categories
- Confluence Detection: Identifies multiple confirming signals
- Dual Timeframe Analysis: Combines 1D and 4H timeframes
- Strategic Ranking: Prioritizes signals by quality and strength
- Strategy Signals: Provides specific trading strategies:
- A+ Bullish/Bearish Continuation
- Potential Reversal setups
- Warning signals for pullbacks
- Market ranging conditions
pip install yfinance pandas pandas_tayfinance- Yahoo Finance data retrievalpandas- Data manipulation and analysispandas_ta- Technical analysis indicatorsnumpy- Numerical computations (auto-installed with pandas)
python ichi_scan.pypython ichi_mtf_scan.pyBoth scripts analyze the following instruments:
- EUR pairs: EURUSD, EURJPY, EURCAD, EURAUD, EURGBP, EURCHF
- GBP pairs: GBPUSD, GBPJPY, GBPCAD, GBPAUD, GBPCHF
- USD pairs: USDJPY, USDCAD, USDCHF
- AUD pairs: AUDUSD, AUDCAD, AUDJPY, AUDCHF
- Cross pairs: CADJPY, CADCHF, CHFJPY, NZDCHF
- BTC-USD (Bitcoin)
- ETH-USD (Ethereum)
- GC=F (Gold Futures)
- SI=F (Silver Futures)
- Tenkan-sen (Conversion Line) - 9-period moving average
- Kijun-sen (Base Line) - 26-period moving average
- Senkou Span A - Leading cloud boundary
- Senkou Span B - Leading cloud boundary
- Chikou Span (Lagging Span) - 26-period displaced price
- +2/-2: Price position relative to cloud
- +1/-1: Tenkan-Kijun cross direction
- +2/-2: Chikou span confirmation
- +1/-1: Future cloud direction
- +1/-1: Price overextension (ATR-based)
- +1/-1: Cloud thickness factor
- +2/-2: Bounce event detection
- Strong Bullish: Score ≥ 8
- Moderate Bullish: Score 3-7
- Neutral: Score -2 to 2
- Moderate Bearish: Score -7 to -3
- Strong Bearish: Score ≤ -8
- A+ Bullish Continuation: Daily bullish + 4H bullish
- A+ Bearish Continuation: Daily bearish + 4H bearish
- Potential Bullish Reversal: Daily neutral + 4H strong bullish
- Potential Bearish Reversal: Daily neutral + 4H strong bearish
- Warning: Bullish Pullback: Daily bullish + 4H bearish
- Warning: Bearish Pullback: Daily bearish + 4H bullish
- Wait for Signal: Daily trending + 4H neutral
- Ranging Market: Avoid trading
===============================BULLISH MOMENTUM PAIRS===============================
| Pair | Score | Verdict | Key Confluences |
|------------|----------|--------------------|------------------------------------|
| EURUSD | 9/11 | Strong Bullish | Price > Kumo, TK Cross Bullish... |
============= MULTI-TIMEFRAME STRATEGY REPORT (STRATEGICALLY RANKED) =============
| Pair | Combined | 1D Verdict | 1D Score | 4H Verdict | Strategy Signal |
|------------|----------|--------------------|-----------|--------------------|------------------------------|
| EURUSD | 15 | Strong Bullish | 8 | Moderate Bullish | A+ Bullish Continuation |
- Kijun Bounce: Price rebounds from the Kijun-sen line
- Kumo Bounce: Price rebounds from cloud boundaries
- Cloud Breakouts: Price breaking above/below cloud
- TK Crosses: Tenkan-Kijun line crossovers
- Chikou Confirmation: Lagging span confirming trend direction
- Market Conditions: Scripts work best in trending markets
- Overextension: ATR-based filters help identify stretched moves
- Confluence: Multiple confirming signals increase reliability
- Timeframe Alignment: Multi-timeframe analysis reduces false signals
Modify the forex_pairs list in either script:
forex_pairs = [
'EURUSD=X', 'GBPUSD=X', # Add your symbols here
'AAPL', # Stocks
'SPY', # ETFs
]In ichi_mtf_scan.py, modify the analysis calls:
result_1d = analyze_ichimoku_chart(pair, timeframe="1d") # Daily
result_4h = analyze_ichimoku_chart(pair, timeframe="4h") # 4-HourAdjust verdict thresholds in the analysis functions:
if momentum_score >= 8: verdict = "Strong Bullish" # Customize these values
elif momentum_score >= 3: verdict = "Moderate Bullish"- Data Connection: Ensure internet connection for Yahoo Finance data
- Missing Data: Some instruments may have limited historical data
- Library Versions: Use compatible versions of pandas_ta
Both scripts include comprehensive error handling and will skip instruments with insufficient data.
Feel free to fork and modify these scripts for your specific trading needs. Consider adding:
- Additional timeframes
- More technical indicators
- Database storage for historical results
- Backtesting capabilities
These scripts are for educational and analysis purposes only. Trading financial instruments involves substantial risk of loss. Always conduct your own research and consider consulting with financial advisors before making trading decisions.
Created by: Abhayror Last Updated: 2025 Version: Multi-Timeframe Scanner v5 | Single Scanner Final