crypto-kline-analysis

加密货币 K 线分析技能

一项智能 AI 技能，使用 Binance API 的实时数据，对加密货币进行全面的技术分析。

🚀 快速使用

供调用此技能的 AI Agent 使用：

# 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

功能：

• ✅ 从 Binance 获取实时 K 线数据
• ✅ 计算 10 多种技术指标
• ✅ 分析多个时间周期的趋势
• ✅ 识别潜在顶部和底部
• ✅ 检测背离和交叉
• ✅ 生成可执行的交易建议

**输出：**全面的技术分析报告，清晰展示趋势方向、信号强度和交易建议。

---

核心功能

此技能提供全面的加密货币技术分析：

1. ✅ 长期分析 - 检测 4 小时和日线周期的趋势及 EMA 排列情况
2. ✅ 趋势识别 - 判断看涨、看跌或横盘趋势，并提供强度指标
3. ✅ 顶部/底部检测 - 使用 RSI、StochRSI 和布林带识别潜在反转点
4. ✅ 短期信号 - 提供快速的 15 分钟和 1 小时信号，用于判断入场/出场时机
5. ✅ 背离检测 - 识别价格与指标之间的背离（看涨/看跌）
6. ✅ 综合报告 - 提供清晰、可执行的分析和风险警告

何时使用此技能

当用户希望进行以下操作时，请使用此技能：

• 分析加密货币价格趋势（BTC、ETH 等）
• 获取交易决策所需的技术分析
• 识别潜在的入场点或出场点
• 了解市场趋势的方向和强度
• 检测超买/超卖情况
• 同时分析多个时间周期
• 获取可执行的交易建议

已实现的技术指标

移动平均线

• EMA（9、21、50、200）
• SMA（20、50）

动量指标

• RSI（14）- 相对强弱指数
• Stochastic RSI - 增强型动量指标

趋势指标

• MACD（12、26、9）- 移动平均收敛发散指标
• Bollinger Bands（20、2）- 波动率带

波动率与成交量

• ATR（14）- 平均真实波幅
• Volume SMA（20）- 成交量移动平均线

完整工作流

1. 理解用户请求

当用户请求加密货币分析时，提取并确认以下信息：

必需信息：

• 交易对：要分析的加密货币（例如 BTC/USDT、ETH/USDT）
• 分析类型：长期、短期或综合分析（全部）
• 具体问题：用户特别关注的事项（趋势方向、入场点等）

用户请求示例：

• “分析 BTC 价格趋势”
• “ETH 现在是否超买？”
• “给我一份 BTC 长期分析”
• “SOL 的短期信号是什么？”

你必须执行的操作：

• 确认加密货币代码
• 确定分析范围（长期/短期/全部）
• 确认交易对格式（代码/USDT）

2. 获取 K 线数据

进入技能目录并获取实时市场数据：

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

获取的数据：

• 4 小时 K 线（200 根）
• 日线 K 线（200 根）
• 1 小时 K 线（200 根）
• 15 分钟 K 线（200 根）
• 24 小时行情信息

3. 技术分析流程

工具会自动执行以下操作：

1. 计算指标 - 计算每个时间周期的所有技术指标
2. 分析趋势 - 根据 EMA 排列确定趋势方向
3. 检测顶部/底部 - 识别超买/超卖情况
4. 查找背离 - 识别价格与指标之间的背离
5. 生成信号 - 生成看涨、看跌或中性信号

4. 解读分析结果

重要：你必须为用户解读结果。

工具会输出以下部分：

长期分析（4 小时和日线）

• 趋势方向：强势看涨、看涨、横盘、看跌、强势看跌
• 趋势强度：强、中、弱
• EMA 排列：当前价格与 EMA（9、21、50、200）的对比
• MACD 状态：金叉（看涨）或死叉（看跌）
• 位置：潜在顶部、潜在底部或中性
• RSI 水平：超买（>70）、超卖（<30）或中性

短期分析（15 分钟和 1 小时）

• 短期趋势：看涨或看跌
• 快速信号：RSI 状况、MACD 交叉
• 入场时机：较短时间周期上的超买/超卖情况

5. 向用户提供清晰的总结

重要：始终将技术分析结果转化为可执行的见解。

总结必须包括：

✅ 看涨信号：

📈 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

❌ 看跌信号：

📉 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

📊 始终包括：

• 明确的趋势方向（看涨/看跌/横盘）
• 各时间周期的趋势强度
• 关键支撑位/阻力位（EMA）
• 超买/超卖情况
• 具体的入场/离场建议
• 风险警告和免责声明

6. 回答后续问题

提供分析后，请准备好进一步解释：

常见问题：

• “MACD 金叉是什么意思？”→ 解释看涨动能转变
• “现在是买入的好时机吗？”→ 结合趋势、RSI 和位置分析
• “有什么风险？”→ 解释超买情况或趋势走弱
• “什么时候应该卖出？”→ 结合阻力位和趋势变化分析

重要提醒：

• 始终附上免责声明：“本内容仅用于教育目的，不构成财务建议”
• 强调加密货币市场波动性极高
• 建议做好风险管理
• 建议用户自行研究

环境设置

1. 安装依赖项

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

2. 测试安装

# Activate virtual environment
source venv/bin/activate

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

无需 API 密钥——使用 Binance 公共 API 端点。

分析方法

趋势检测逻辑

1. EMA 排列检查

   • 强势看涨：EMA(9) > EMA(21) > EMA(50)
   • 看涨：EMA(9) > EMA(21)
   • 强势看跌：EMA(9) < EMA(21) < EMA(50)
   • 看跌：EMA(9) < EMA(21)
   • 横盘：排列混杂或没有明确排列

2. MACD 确认

   • 金叉：MACD 线向上穿过信号线（看涨）
   • 死叉：MACD 线向下穿过信号线（看跌）

3. 长期市场结构

   • 高于 200 EMA = 牛市
   • 低于 200 EMA = 熊市

顶部/底部检测逻辑

1. RSI 水平

   • RSI < 30 = 超卖（潜在底部）
   • RSI > 70 = 超买（潜在顶部）
   • RSI 40-60 = 中性区间

2. StochRSI 确认

   • StochRSI < 20 = 严重超卖
   • StochRSI > 80 = 严重超买

3. 布林带位置

   • 价格接近上轨 = 超买区
   • 价格接近下轨 = 超卖区

4. 背离检测

   • 看跌：价格创新高，但 RSI 没有创新高（潜在顶部）
   • 看涨：价格创新低，但 RSI 没有创新低（潜在底部）

使用示例

示例 1：基本趋势检查

用户：“BTC 现在的趋势是什么？”

Agent 操作：

1. 运行：python crypto_analyzer.py BTC/USDT long
2. 分析输出
3. 给出清晰的总结

Agent 回复：

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.

示例 2：入场点分析

用户：“现在是买入 ETH 的好时机吗？”

Agent 操作：

1. 运行：python crypto_analyzer.py ETH/USDT all
2. 检查长期趋势和短期信号
3. 提供平衡的评估

Agent 回复：

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.

示例 3：风险评估

用户：“我需要担心自己的 BTC 持仓吗？”

Agent 操作：

1. 运行全面分析
2. 检查警示信号
3. 提供风险评估

Agent 回复：

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.

故障排除

问题：连接 Binance API 时出错

可能的原因：

• 网络连接问题
• Binance API 暂时不可用
• 速率限制（请求过多）

解决方案：

• 检查互联网连接
• 等待几分钟后重试
• 在 https://www.binance.com/en/support 查看 Binance API 状态

问题：未找到交易对

问题：“Failed to fetch BTC/USDT data”

解决方案：

• 确保交易对格式正确：BTC/USDT（而不是 BTCUSDT）
• 检查 Binance 现货市场中是否存在该交易对
• 尝试其他交易对（例如 ETH/USDT）

问题：未激活虚拟环境

**问题：**出现“Module not found”错误

解决方案：

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

重要免责声明

致 AI Agent：你必须在每次分析中包含以下免责声明：

1. ⚠️ 非财务建议：本分析仅用于教育目的
2. ⚠️ 高风险：加密货币交易存在重大亏损风险
3. ⚠️ 自行研究：用户在交易前应自行进行研究
4. ⚠️ 不作保证：过往表现无法预测未来结果
5. ⚠️ 波动性：加密货币市场波动极大且难以预测

技术支持

• GitHub Issues：报告错误或请求新功能
• 文档：详细设置说明请参阅 README.md
• Binance API 文档：https://binance-docs.github.io/apidocs/spot/en/

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件