# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tychi.gitbook.io/tychi-whitepaper/ai-powered-modules/candlestick-chart-analyzer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.