🕯️ Crypto Candlestick Pattern Watcher

A Streamlit web application for long-term crypto investors. Analyzes market phases (Accumulation/Distribution), detects 50+ candlestick patterns, provides entry signals, and monitors derivatives data (Open Interest, Funding Rate, Long/Short Ratio).

✨ Features

Feature	Description
📋 Watchlist Dashboard	Monitor multiple assets at a glance with A/D status
🟢 Phase Zones	Shaded chart areas showing Accumulation/Distribution periods
🛒 Simplified Wyckoff	Beginner-friendly labels: "Smart Money Buying/Selling"
⭐ Entry Signals	Strong Buy/Sell when A/D + Pattern align
🔄 Timeframe Compare	Daily vs Weekly alignment check
50+ Patterns	Hammer, Doji, Engulfing, Morning Star, and more
📈 Open Interest Monitor	Derivatives analysis with investment scoring

📈 Open Interest Monitor (NEW)

Analyze futures market data for smarter investment decisions:

• Open Interest (OI): Track rising/falling OI with price divergence
• Funding Rate: Identify market sentiment (bullish/bearish bias)
• Long/Short Ratio: See market positioning at a glance
• Investment Score: 0-100 score combining all derivatives metrics
• Historical Signals: Visual markers showing past bullish/bearish signals

Derivatives Signal Interpretation

OI Change	Price Change	Signal	Meaning
↑ Rising	↑ Rising	🟢 Bullish	New money entering, trend strengthening
↑ Rising	↓ Falling	🔴 Bearish	Short sellers entering aggressively
↓ Falling	↑ Rising	🟡 Weak Rally	Short covering, may not sustain
↓ Falling	↓ Falling	🟠 Capitulation	Liquidations, potential bottom

🚀 Live Demo

Open App

📊 How to Use (For Long-Term Investors)

1. Watchlist Dashboard

Add your favorite coins (BTC, ETH, SOL, etc.) and see which ones are in Accumulation (🟢) or Distribution (🔴) at a glance.

2. Single Asset Analysis

Select a coin and click "Analyze" to see:

• Phase Zones: Green shaded areas = Accumulation periods
• Wyckoff Phase: Simple labels like "Smart Money Buying"
• Entry Signals: ⭐ markers when pattern + phase align

3. Timeframe Comparison

Check if Daily AND Weekly charts agree:

• ✅ Both bullish = High confidence entry
• ⚠️ Mixed = Wait for confirmation

4. Open Interest Monitor

Select a coin and analyze derivatives data:

• 4-Hour Resolution: ~3 months of data for short-term trends
• Daily Resolution: ~1 year of data for long-term analysis
• Investment Score: 0-100 rating based on derivatives health

🛠️ Tech Stack

• Frontend: Streamlit
• Data Sources:
  • Yahoo Finance (yfinance) - Default, native daily + weekly support
  • CryptoCompare API - Alternative source, best for daily timeframe
• Derivatives: Coinalyze API
• Analysis: TA-Lib (Technical Analysis Library)
• Charts: Plotly

Data Source Toggle

The app includes a toggle to switch between Yahoo Finance and CryptoCompare:

• Yahoo Finance (Default): Recommended for weekly timeframe analysis as it provides native weekly candlestick data
• CryptoCompare: Great for daily timeframe, but weekly data is simulated by aggregating daily candles (less accurate for weekly analysis)

📦 Installation (Local)

# Clone repo
git clone https://github.com/foxy1402/candlestick-watcher.git
cd candlestick-watcher

# Install dependencies (requires TA-Lib C library)
pip install -r requirements.txt

# Run
streamlit run app.py

⚠️ Note: TA-Lib requires a C library. On Windows, use pre-built wheels. On Linux/Mac, install via brew install ta-lib or apt-get install libta-lib-dev.

☁️ Deploy to Streamlit Cloud

1. Push this repo to GitHub
2. Go to share.streamlit.io
3. Connect your repo, select app.py
4. Add Secrets (Settings → Secrets):

   COINALYZE_API_KEY = "your-api-key-here"

5. Deploy!

Getting a Coinalyze API Key

1. Sign up at coinalyze.net
2. Get your free API key (1000 calls/month)
3. Add to Streamlit Secrets as shown above

📝 License

MIT

🙏 Credits

• Original pattern logic inspired by Caner Irfanoglu's article
• TA-Lib
• Coinalyze API for derivatives data