teamily-ai 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:
- ✅ Long-term Analysis - 4-hour and daily timeframe trend detection with EMA alignment
- ✅ Trend Identification - Determine bullish/bearish/sideways trends with strength indicators
- ✅ Top/Bottom Detection - Identify potential reversal points using RSI, StochRSI, and Bollinger Bands
- ✅ Short-term Signals - Fast 15-minute and 1-hour signals for entry/exit timing
- ✅ Divergence Detection - Spot price-indicator divergences (bullish/bearish)
- ✅ 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:
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