> For the complete documentation index, see [llms.txt](https://tychi.gitbook.io/tychi-whitepaper/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tychi.gitbook.io/tychi-whitepaper/ai-powered-modules/candlestick-chart-analyzer.md).

# Candlestick Chart Analyzer

### 📌 Overview

The **Candlestick Chart Analyzer** is a cutting-edge backend service that interprets price action from uploaded candlestick chart images. Using a combination of image processing (OpenCV), optional pattern recognition (YOLO), and real-time technical analysis data (via TradingView\_TA), it delivers professional-grade insights — even from screenshots.

Whether you’re analyzing historical formations or current market momentum, the system bridges visual chart features with algorithmic financial intelligence to produce actionable trading decisions.

***

### 🚀 Key Capabilities

| Capability               | Description                                                                |
| ------------------------ | -------------------------------------------------------------------------- |
| 🖼️ Image-Based Analysis | Extracts data directly from uploaded candlestick screenshots.              |
| 🔤 Symbol Normalization  | Converts inputs like `btc`, `solana`, `SOLUSDT` into `BTC/USDT` format.    |
| 📈 Trend Detection       | Uses line angles, candle ratios, and price zones to classify trend type.   |
| 📊 Technical Indicators  | Fetches RSI, MACD, Bollinger Bands, SMA/EMA using TradingView\_TA API.     |
| 🧠 Pattern Recognition   | Detects patterns like Head & Shoulders, W-Bottoms, Flags (optional YOLO).  |
| 📃 Professional Insights | Generates institutional-style textual analysis with trend + risk insights. |
| 😨 Fear & Greed Index    | Integrates market sentiment via Alternative.me (6-hour cache).             |
| ✍️ Manual Symbol Entry   | Allows fallback entry when auto-detection is uncertain or missing.         |

***

### 🧭 Steps to Use

1. **Upload Chart Image**\
   Supports: `.png`, `.jpg`, `.bmp`, `.webp` screenshots from any charting platform.
2. **Enter Symbol**\
   Users can enter symbols like `SOL`, `BTC`, `ETHUSD`, etc., in any format — the system auto-corrects them.
3. **Select Timeframe**\
   Choose between `1h` or `1d` intervals for technical analysis alignment.
4. **Click Analyze**\
   Triggers full image processing, indicator fetching, and textual insight generation.
5. **Receive Report**\
   Outputs:
   * Trend direction (Bullish/Bearish/Neutral)
   * RSI, MACD, SMA, EMA, Bollinger Bands
   * Pattern list
   * Support & Resistance zones
   * AI-generated insights
   * Fear & Greed Index value

***

### 🧮 Trend Detection Formula

<figure><img src="/files/wRdDvwjy0ce1J2J3vzAj" alt=""><figcaption></figcaption></figure>

***

### 🔄 Data Sources & Processing

| Source / Module     | Role                                                                 |
| ------------------- | -------------------------------------------------------------------- |
| 📊 `tradingview_ta` | Real-time indicators: RSI, MACD, BBANDS, EMA/SMA, support/resistance |
| 🎨 OpenCV           | Image processing for candlestick detection and trend analysis        |
| 🤖 YOLO (optional)  | Pattern recognition (e.g. Head & Shoulders) using trained `.pt` file |
| 🔤 Symbol Corrector | Converts loose symbol input like `eth`, `btc` → `ETH/USDT`           |
| 😨 Fear & Greed API | Market sentiment via `https://api.alternative.me/fng/` (cached)      |
| 🧠 Text Generator   | NLP-based system for trading insight and summary generation          |

***

<figure><img src="/files/3BZcHnIUFlc81mqsur3y" alt=""><figcaption></figcaption></figure>