crypto-kline-analysis

Crypto K-line Analysis Skill

An intelligent AI skill that performs comprehensive cryptocurrency technical analysis using real-time data from Binance API.

🚀 Quick Usage

For AI Agents calling this skill:

# Analyze BTC/USDT (default - full analysis)
python crypto_analyzer.py

# Analyze specific trading pair
python crypto_analyzer.py ETH/USDT

# Long-term analysis only (4h + daily)
python crypto_analyzer.py BTC/USDT long

Short-term analysis only (15m + 1h)

python crypto_analyzer.py BTC/USDT short


**What it does:**
- ✅ Fetches real-time K-line data from Binance
- ✅ Calculates 10+ technical indicators
- ✅ Analyzes trends across multiple timeframes
- ✅ Identifies potential tops and bottoms
- ✅ Detects divergences and crossovers
- ✅ Generates actionable trading recommendations

**Output:** Comprehensive technical analysis report with clear trend direction, signal strength, and trading suggestions.

---

## Core Capabilities

This skill provides **complete cryptocurrency technical analysis**:

1. ✅ **Long-term Analysis** - 4-hour and daily timeframe trend detection with EMA alignment
2. ✅ **Trend Identification** - Determine bullish/bearish/sideways trends with strength indicators
3. ✅ **Top/Bottom Detection** - Identify potential reversal points using RSI, StochRSI, and Bollinger Bands
4. ✅ **Short-term Signals** - Fast 15-minute and 1-hour signals for entry/exit timing
5. ✅ **Divergence Detection** - Spot price-indicator divergences (bullish/bearish)
6. ✅ **Comprehensive Reporting** - Clear, actionable analysis with risk warnings

## When to Use This Skill

Use this skill when the user wants to:
- Analyze cryptocurrency price trends (BTC, ETH, etc.)
- Get technical analysis for trading decisions
- Identify potential entry or exit points
- Understand market trend direction and strength
- Detect overbought/oversold conditions
- Analyze multiple timeframes simultaneously
- Get actionable trading recommendations

## Technical Indicators Implemented

### Moving Averages
- EMA (9, 21, 50, 200)
- SMA (20, 50)

### Momentum Indicators
- RSI (14) - Relative Strength Index
- Stochastic RSI - Enhanced momentum indicator

### Trend Indicators
- MACD (12, 26, 9) - Moving Average Convergence Divergence
- Bollinger Bands (20, 2) - Volatility bands

### Volatility & Volume
- ATR (14) - Average True Range
- Volume SMA (20) - Volume moving average

## Complete Workflow

### 1. Understand User Request

When the user requests cryptocurrency analysis, extract and confirm:

**Required Information:**
- **Trading pair**: Which cryptocurrency to analyze (e.g., BTC/USDT, ETH/USDT)
- **Analysis type**: Long-term, short-term, or comprehensive (all)
- **Specific questions**: Any particular concerns (trend direction, entry points, etc.)

**Example User Requests:**
- "Analyze BTC price trend"
- "Is ETH overbought right now?"
- "Give me a long-term analysis of BTC"
- "What's the short-term signal for SOL?"

**What YOU Must Do:**
- Identify the cryptocurrency symbol
- Determine analysis scope (long/short/all)
- Confirm the trading pair format (symbol/USDT)

### 2. Fetch K-line Data

Navigate to the skill directory and fetch real-time market data:

```bash
cd ~/.claude/skills/crypto-kline-analysis
source venv/bin/activate
python crypto_analyzer.py BTC/USDT [timeframe]

Data Retrieved:

4-hour K-lines (200 candles)
Daily K-lines (200 candles)
1-hour K-lines (200 candles)
15-minute K-lines (200 candles)
24-hour ticker information

3. Technical Analysis Process

The tool automatically:

Calculates Indicators - Computes all technical indicators on each timeframe
Analyzes Trends - Determines trend direction using EMA alignment
Detects Top/Bottom - Identifies overbought/oversold conditions
Finds Divergences - Spots price-indicator divergences
Generates Signals - Creates bullish/bearish/neutral signals

4. Interpret Analysis Results

CRITICAL: You MUST interpret the results for the user.

The tool outputs sections for:

Long-term Analysis (4h & Daily)

Trend Direction: Strong Bullish, Bullish, Sideways, Bearish, Strong Bearish
Trend Strength: Strong, Medium, Weak
EMA Alignment: Current price vs EMAs (9, 21, 50, 200)
MACD Status: Golden Cross (bullish) or Death Cross (bearish)
Position: Potential Top, Potential Bottom, or Neutral
RSI Level: Overbought (>70), Oversold (<30), or Neutral

Short-term Analysis (15m & 1h)

Short-term Trend: Bullish or Bearish
Quick Signals: RSI conditions, MACD crossovers
Entry Timing: Overbought/oversold on shorter timeframes

5. Provide Clear Summary to User

CRITICAL: Always translate the technical output into actionable insights.

Your Summary Must Include:

✅ For Bullish Signals:

📈 BTC/USDT Analysis Summary

Current Trend: Strong Bullish
- Daily trend is up with EMA(9) > EMA(21) > EMA(50)
- MACD showing golden cross on 4h timeframe
- Price above 200-day EMA = Bull market confirmed

Key Signals:
✅ Long-term trend is strong and upward
✅ Momentum indicators support continued upside
⚠️  Watch for RSI overbought on daily (currently 68)

Recommendation: Bullish bias - Consider holding or buying on dips
Risk: Monitor for RSI >70 which may signal short-term pullback

❌ For Bearish Signals:

📉 BTC/USDT Analysis Summary

Current Trend: Strong Bearish
- Daily trend is down with EMA(9) < EMA(21) < EMA(50)
- MACD showing death cross on daily timeframe
- Price below 200-day EMA = Bear market confirmed

Key Signals:
❌ Long-term trend is weak and downward
❌ Multiple timeframes confirm bearish structure
💡 RSI oversold on daily (currently 28) = potential bounce

Recommendation: Bearish bias - Consider staying in cash or waiting
Opportunity: Watch for bullish divergence on RSI for reversal signal

📊 Always Include:

Clear trend direction (bullish/bearish/sideways)
Trend strength across timeframes
Key support/resistance levels (EMAs)
Overbought/oversold conditions
Specific entry/exit suggestions
Risk warnings and disclaimers

6. Answer Follow-up Questions

After providing analysis, be ready to clarify:

Common Questions:

"What does MACD golden cross mean?" → Explain bullish momentum shift
"Is it a good time to buy?" → Reference trend + RSI + position analysis
"What's the risk?" → Explain overbought conditions or trend weakness
"When should I sell?" → Reference resistance levels and trend changes

Important Reminders:

Always include disclaimer: "This is for educational purposes only, not financial advice"
Emphasize that crypto markets are highly volatile
Recommend proper risk management
Suggest the user do their own research

Environment Setup

1. Install Dependencies

cd crypto-kline-analysis
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2. Test Installation

# Activate virtual environment
source venv/bin/activate

# Run test analysis
python crypto_analyzer.py BTC/USDT long

No API keys required - Uses Binance public API endpoints.

Analysis Methodology

Trend Detection Logic

EMA Alignment Check
- Strong Bullish: EMA(9) > EMA(21) > EMA(50)
- Bullish: EMA(9) > EMA(21)
- Strong Bearish: EMA(9) < EMA(21) < EMA(50)
- Bearish: EMA(9) < EMA(21)
- Sideways: Mixed or no clear alignment
MACD Confirmation
- Golden Cross: MACD line crosses above signal line (bullish)
- Death Cross: MACD line crosses below signal line (bearish)
Long-term Market Structure
- Above 200 EMA = Bull market
- Below 200 EMA = Bear market

Top/Bottom Detection Logic

RSI Levels
- RSI < 30 = Oversold (potential bottom)
- RSI > 70 = Overbought (potential top)
- RSI 40-60 = Neutral zone
StochRSI Confirmation
- StochRSI < 20 = Strong oversold
- StochRSI > 80 = Strong overbought
Bollinger Bands Position
- Price near upper band = Overbought zone
- Price near lower band = Oversold zone
Divergence Detection
- Bearish: Price makes new high, RSI doesn't (potential top)
- Bullish: Price makes new low, RSI doesn't (potential bottom)

Usage Examples

Example 1: Basic Trend Check

User: "What's the BTC trend right now?"

Agent Actions:

Run: python crypto_analyzer.py BTC/USDT long
Analyze output
Respond with clear summary

Agent Response:

BTC/USDT is currently in a Strong Bearish trend on the daily timeframe:

📉 Daily: Strong Bearish (EMA 9 < 21 < 50)
📉 4-hour: Bearish
💡 Price is below 200-day EMA ($102,074) = Bear market
⚠️  MACD death cross confirmed

However, daily RSI is at 35 (approaching oversold), which may signal
a potential bounce in the near term.

Conclusion: Strong downtrend with possible short-term bounce opportunity.

Example 2: Entry Point Analysis

User: "Is this a good entry point for ETH?"

Agent Actions:

Run: python crypto_analyzer.py ETH/USDT all
Check both long-term trend AND short-term signals
Provide balanced assessment

Agent Response:

ETH/USDT Entry Analysis:

Long-term (Daily): Bearish trend, price below key EMAs
Short-term (1h): Showing bullish divergence, RSI oversold at 28

Signals:
✅ Short-term RSI oversold = potential bounce
⚠️  Long-term trend still bearish
⚠️  Price below 200 EMA

Assessment: Risky for long-term entry, but short-term bounce trade
possible if you have tight stop-loss.

Safer entry would be: Wait for daily trend to turn bullish (EMA crossover)

⚠️  Disclaimer: This is educational analysis only, not financial advice.
Crypto markets are highly volatile.

Example 3: Risk Assessment

User: "Should I be worried about my BTC position?"

Agent Actions:

Run comprehensive analysis
Check for warning signals
Provide risk assessment

Agent Response:

Risk Assessment for BTC/USDT:

⚠️  WARNING SIGNALS DETECTED:

1. Daily RSI: 72 (overbought) - Price may face pullback pressure
2. 4h StochRSI: 87 (extremely overbought)
3. Price position: Near Bollinger Band upper limit
4. Potential bearish divergence forming

Risk Level: MEDIUM-HIGH for short-term pullback

Recommendations:
- Consider taking partial profits if in profit
- Set stop-loss at recent support level
- Watch for RSI to drop below 70 as confirmation of reversal
- Don't chase if price continues up (let it cool down first)

Long-term trend is still bullish, so this may be temporary correction.

Troubleshooting

Issue: Connection Error to Binance API

Possible Causes:

Network connectivity issues
Binance API temporarily down
Rate limiting (too many requests)

Solutions:

Check internet connection
Wait a few minutes and retry
Verify Binance API status at https://www.binance.com/en/support

Issue: Symbol Not Found

Problem: "Failed to fetch BTC/USDT data"

Solution:

Ensure correct symbol format: BTC/USDT (not BTCUSDT)
Check if symbol exists on Binance spot market
Try different symbol (e.g., ETH/USDT)

Issue: Virtual Environment Not Activated

Problem: "Module not found" errors

Solution:

cd crypto-kline-analysis
source venv/bin/activate
python crypto_analyzer.py BTC/USDT

Important Disclaimers

For AI Agents: You MUST include these disclaimers in every analysis:

⚠️ Not Financial Advice: This analysis is for educational purposes only
⚠️ High Risk: Cryptocurrency trading carries significant risk of loss
⚠️ DYOR: Users should conduct their own research before trading
⚠️ No Guarantees: Past performance does not predict future results
⚠️ Volatility: Crypto markets are extremely volatile and unpredictable

Technical Support

GitHub Issues: Report bugs or request features
Documentation: See README.md for detailed setup
Binance API Docs: https://binance-docs.github.io/apidocs/spot/en/

License

MIT License - See LICENSE file for details

About this skill

🚀 Quick Usage

3. Technical Analysis Process

4. Interpret Analysis Results

Long-term Analysis (4h & Daily)

Short-term Analysis (15m & 1h)

5. Provide Clear Summary to User

6. Answer Follow-up Questions

Environment Setup

1. Install Dependencies

2. Test Installation

Analysis Methodology

Trend Detection Logic

Top/Bottom Detection Logic

Usage Examples

Example 1: Basic Trend Check

Example 2: Entry Point Analysis

Example 3: Risk Assessment

Troubleshooting

Issue: Connection Error to Binance API

Issue: Symbol Not Found

Issue: Virtual Environment Not Activated

Important Disclaimers

Technical Support

License