BTC Momentum Theory Analyzer

Feature Overview

This Skill implements a MACD-based nested multi-timeframe momentum theory analysis system, providing:

Multi-Timeframe Data Retrieval: Fetch BTC candlestick data for 8 timeframes from the OKX API
- 2-day (2d), 1-day (1d), 12-hour (12h), 6-hour (6h)
- 4-hour (4h), 2-hour (2h), 1-hour (1h), 30-minute (30m)
Technical Indicator Calculation:
- EMA26, EMA52 (short-term and medium-term trend lines)
- MACD(12, 26, 9): DIF (yellow line), DEA (white line), Histogram (bar chart)
Segment Classification: Identify market status for each timeframe
- Uptrend segment (DEA > 0)
- Downtrend segment (DEA < 0)
- Transition period and breakout attempts
Momentum Theory Analysis (see THEORY.md for details):
- Unit Adjustment Cycle: Determine which adjustment cycle the market is in
- Discrete Regulation: Detect discrete momentum adjustment patterns
- Continuous Gap Divergence: Divergence between price and histogram + price gaps
- DIF-DEA Divergence: Detect divergences between DIF and DEA lines
- Hidden Signals: Concealed momentum changes
Multi-Timeframe Linkage:
- Influence of higher-level cycles on lower-level cycles
- Confirmation of multi-cycle resonance
- Recursive analysis of nested relationships
Trading Signal Generation:
- Identification of buy/sell points (rules defined in THEORY.md)
- Stop-loss and take-profit suggestions
- Confidence level assessment

Momentum Theory System

Complete theoretical definitions can be found in THEORY.md, including:

Precise definitions of uptrend/downtrend segments
Identification methods for unit adjustment cycles
Detection algorithms for discrete regulation
Judgment criteria for continuous gap divergences
Analysis rules for DIF-DEA divergences
Trigger conditions for buy/sell points
Analysis framework for timeframe linkage

Important: All trading parameters, thresholds, and rules are defined in THEORY.md. This Skill does not contain hard-coded trading logic.

Usage Guide

One-Click Analysis (Recommended)

Claude will automatically execute the complete analysis process. You only need to ask:

Example Questions:

"Analyze the current momentum status of BTC"
"Which unit adjustment cycle is BTC in now?"
"Detect multi-timeframe divergences for BTC"
"Does BTC have a buy signal? Give me a detailed analysis"

The Skill will automatically:

Fetch real-time data for 8 timeframes (OKX API)
Calculate all indicators (EMA26/52, MACD)
Perform nested momentum analysis
Generate a detailed report

Manual Execution Steps (Advanced Users)

To manually control the analysis process, follow these steps:

Step 1: Retrieve Multi-Timeframe Data

bash

python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/fetch_btc_data.py \
  --symbol BTC-USDT \
  --timeframes 2d,1d,12h,6h,4h,2h,1h,30m \
  --limit 200 \
  --exchange okx

Parameter Explanation:

```
--symbol
```
: Trading pair (OKX format: BTC-USDT)
```
--timeframes
```
: Comma-separated list of timeframes
```
--limit
```
: Number of candlesticks to retrieve per timeframe
```
--exchange
```
: Exchange (okx, binance, bybit)

Output: JSON file containing OHLCV data for all timeframes

Step 2: Calculate Technical Indicators

bash

python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/calculate_indicators.py \
  /Users/adrian/Desktop/BA/MACD/data/btc_multi_timeframe.json \
  --ema-periods 26,52 \
  --macd-params 12,26,9

Output: Annotated data with EMA and MACD indicators

Step 3: Momentum Theory Analysis

bash

python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/analyze_momentum.py \
  /Users/adrian/Desktop/BA/MACD/data/btc_indicators.json \
  --theory-file /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/THEORY.md

Output:

Segment classification for each timeframe
Unit adjustment cycle judgment
Discrete regulation detection results
Divergence analysis (continuous gap divergence, DIF-DEA divergence)
Multi-timeframe linkage relationships

Step 4: Generate Trading Report

bash

python3 /Users/adrian/Desktop/BA/MACD/.claude/skills/btc-momentum-analyzer/scripts/generate_report.py \
  /Users/adrian/Desktop/BA/MACD/data/btc_analysis.json \
  --format text \
  --detail full

Output: Structured nested multi-timeframe analysis report

Typical Output Example

Complete Momentum Analysis Report

=========================
BTC Momentum Theory Analysis Report
Analysis Time: 2025-12-10 16:30:00 UTC
=========================

## Nested Multi-Timeframe Analysis

【2-Day Timeframe】
Segment Status: Uptrend Segment
- DEA: +1250.3 (above 0-axis, strong bullish)
- DIF: +1580.7
- Histogram: +330.4 (continuously expanding)
- Segment Duration: 8 candlesticks
- EMA Arrangement: EMA26 (98,500) > EMA52 (96,200) ✓
- Unit Adjustment Cycle: 2nd cycle
- Inter-Cycle Divergence: None
- DIF-DEA Divergence: None (DIF and DEA rising in the same direction)

【1-Day Timeframe】
Segment Status: Uptrend Segment
- DEA: +850.5 (above 0-axis)
- DIF: +920.3
- Histogram: +69.8 (positive bar, weakening momentum)
- Segment Duration: 12 candlesticks
- EMA Arrangement: EMA26 (98,200) > EMA52 (96,800) ✓
- Unit Adjustment Cycle: 1st cycle
- Inter-Cycle Divergence: None
- DIF-DEA Divergence: ⚠️ Minor divergence (price hit new high, DIF did not)
- Relationship with Higher Timeframe: Resonating upward with 2-day timeframe

【12-Hour Timeframe】
Segment Status: Uptrend Segment
- DEA: +420.8
- DIF: +380.2
- Histogram: -40.6 (negative bar, momentum turning weak)
- Segment Duration: 18 candlesticks
- EMA Arrangement: EMA26 (98,100) > EMA52 (97,200) ✓
- Unit Adjustment Cycle: 2nd cycle
- Inter-Cycle Divergence: ✓ Detected (high of 1st cycle vs 2nd cycle)
- DIF-DEA Divergence: ✓ Bearish divergence (DIF crossed below DEA, death cross)
- Discrete Regulation: None
- Relationship with Higher Timeframe: 1-day timeframe is uptrending, but 12h momentum is exhausted

【6-Hour Timeframe】
Segment Status: Transition Period (adjustment after uptrend)
- DEA: +180.3
- DIF: +120.5
- Histogram: -59.8 (negative bar, pullback)
- Segment Duration: 6 candlesticks (transition period)
- EMA Arrangement: EMA26 (97,800) < EMA52 (97,850) ✗ (short-term breakdown)
- Unit Adjustment Cycle: N/A (in transition period)
- Discrete Regulation: ✓ Detected (discrete adjustment in candlesticks 3-5)
- Relationship with Higher Timeframe: 12h divergence warning, 6h entered adjustment

【4-Hour Timeframe】
Segment Status: Transition Period
- DEA: +80.2
- DIF: +50.1
- Histogram: -30.1
- Segment Duration: 10 candlesticks
- EMA Arrangement: EMA26 (97,600) < EMA52 (97,700) ✗
- Continuous Gap Divergence: None
- DIF-DEA Divergence: ✓ Death cross divergence
- Relationship with Higher Timeframe: 6h adjustment continues to 4h

【2-Hour Timeframe】
Segment Status: Downtrend Segment (warning)
- DEA: -20.5 (crossed below 0-axis)
- DIF: -45.3
- Histogram: -24.8
- Segment Duration: 4 candlesticks
- EMA Arrangement: EMA26 (97,400) < EMA52 (97,650) ✗
- Unit Adjustment Cycle: 1st cycle (start of downtrend)
- Relationship with Higher Timeframe: 4h adjustment turned into 2h downtrend

【1-Hour Timeframe】
Segment Status: Downtrend Segment
- DEA: -35.8
- DIF: -50.2
- Histogram: -14.4
- Segment Duration: 8 candlesticks
- EMA Arrangement: EMA26 (97,350) < EMA52 (97,550) ✗
- Unit Adjustment Cycle: 1st cycle
- Continuous Gap Divergence: None
- DIF-DEA Divergence: None (declining in the same direction)
- Relationship with Higher Timeframe: 2h downtrend continues to 1h

【30-Minute Timeframe】
Segment Status: Downtrend Segment
- DEA: -45.2
- DIF: -55.8
- Histogram: -10.6
- Segment Duration: 12 candlesticks
- EMA Arrangement: EMA26 (97,300) < EMA52 (97,500) ✗
- Unit Adjustment Cycle: 1st cycle
- Hidden Signal: ⚠️ Histogram convergence (potential reversal imminent)
- Relationship with Higher Timeframe: 1h downtrend continues

---

## Multi-Timeframe Linkage Summary

【Large-Cycle Trend】(2-day - 1-day)
✓ Uptrend confirmed
- 2-day timeframe is in the 2nd unit adjustment cycle, strong uptrend
- 1-day timeframe shows minor DIF-DEA divergence, need to be cautious

【Medium-Cycle Adjustment】(12h - 6h - 4h)
⚠️ Adjustment period
- 12h timeframe detected inter-cycle divergence + DIF-DEA death cross divergence
- 6h timeframe found discrete regulation, entered transition period
- 4h timeframe continues adjustment, momentum weakening continuously

【Small-Cycle Downtrend】(2h - 1h - 30m)
✗ Short-term downtrend
- 2h timeframe confirmed downtrend segment (DEA crossed below 0-axis)
- 1h, 30m timeframes continue downtrend, but 30m shows histogram convergence (hidden reversal signal)

---

## Trading Signals and Recommendations

【Current Market Status】
Bull-bear divergence: Large-cycle bullish vs small-cycle bearish

【Buy Point Analysis】
❌ Not recommended to open long positions immediately
Reasons:
1. 12h timeframe shows obvious bearish divergence (price hit new high, DIF did not)
2. 6h timeframe detected discrete regulation, market is in adjustment period
3. 2h/1h timeframes confirmed downtrend segments, short-term trend downward
4. Wait for small-cycle stabilization before considering entry

【Potential Buy Point Trigger Conditions】(refer to THEORY.md rules)
1. 30m timeframe DEA crosses above 0-axis, confirming reversal
2. 1h timeframe EMA26 crosses above EMA52 again
3. 2h timeframe adjustment ends, resumes resonance with 4h timeframe
4. Large-cycle 1-day, 2-day timeframes maintain uptrend segments

【Sell Point Analysis】
⚠️ Short position risk warning
Reasons:
1. Large-cycle (2-day, 1-day) timeframes are still in strong uptrend segments
2. Current downtrend may just be a normal pullback in the large cycle
3. 30m histogram convergence, potential rebound imminent

【Recommended Operations】
Maintain wait-and-see attitude, wait for one of the following situations:
1. 30m reversal signal confirmed → Open small long positions (follow large-cycle trend)
2. 2h DEA continues to drop below -100 → Consider short-term short positions
3. 1-day DEA crosses below 0-axis → Large-cycle trend reversal, short cautiously

【Risk Level】: Medium
【Confidence Level】: 60% (wait-and-see recommendation)

---

## Key Monitoring Indicators

1. **30-Minute Histogram**: Whether it reverses with volume after convergence
2. **2-Hour DEA**: Whether it continues to decline or stabilizes
3. **12-Hour DIF-DEA**: Whether a new bullish arrangement forms after divergence
4. **1-Day EMA26/EMA52**: Whether bullish arrangement is maintained

=========================
Report Generation Time: 2025-12-10 16:30:12 UTC
Data Source: OKX API
Theoretical Basis: THEORY.md (user-defined momentum theory)
=========================

Data Source Explanation

OKX API

This Skill uses the free public API of OKX exchange:

Advantages:

Free, no API Key required (public data)
Supports all required timeframes (2d, 1d, 12h, 6h, 4h, 2h, 1h, 30m)
High data quality, low latency
Limit: 20 requests/2 seconds

API Endpoint:

https://www.okx.com/api/v5/market/candles

Timeframe Mapping:

2d →
```
2D
```
1d →
```
1D
```
12h →
```
12H
```
6h →
```
6H
```
4h →
```
4H
```
2h →
```
2H
```
1h →
```
1H
```
30m →
```
30m
```

Alternative Data Sources

Local Cache:
- Location:
```
/Users/adrian/Desktop/BA/MACD/data/btc_cache_{timeframe}.json
```
- Cache Validity: Dynamically adjusted based on timeframe (30m cached for 5 minutes, 2d cached for 1 hour)
Binance API (fallback):
- Automatically switches if OKX API is unavailable
- Note: Binance's timeframe names are slightly different
Manual Export:
- Export CSV from TradingView or other platforms
- Place in
```
data/
```
  directory
- Script can automatically recognize and parse

Output Formats

Text Report (Default)

Structured nested multi-timeframe report including:

Detailed analysis for each timeframe
Segment status, unit cycles, divergence detection
Multi-timeframe linkage summary
Trading signals and operation recommendations
Key monitoring indicators

JSON Report

bash

--format json

Machine-readable format, suitable for further processing or storage.

Simplified Report

bash

--detail simple

Only includes key information and trading recommendations, suitable for quick review.

Analysis Depth Control

Adjust the level of analysis detail as needed:

Complete Analysis (Default)

bash

python3 scripts/analyze_momentum.py data.json --detail full

Includes complete analysis for all 8 timeframes

Focused Analysis

bash

python3 scripts/analyze_momentum.py data.json --focus 1h,4h,1d

Only analyzes specified timeframes, but still considers upper-lower level linkage relationships

Quick Scan

bash

python3 scripts/analyze_momentum.py data.json --mode quick

Only outputs current segment status and key signals, skips detailed analysis

Error Handling

The scripts have built-in multi-layer error handling:

API Rate Limiting: Automatically waits and retries
Network Errors: Automatically retries 3 times, falls back to cache if failed
Data Missing: Skips missing timeframes, records warnings
Calculation Exceptions: Returns null values without interrupting the process
THEORY.md Parsing Errors: Uses default rules and warns the user

Performance Optimization

Parallel Data Retrieval: 8 timeframes requested in parallel to reduce waiting time
Incremental Updates: Only fetches new candlesticks, reduces data transmission
Intelligent Caching: Dynamically sets cache expiration time based on timeframe
Lazy Loading: Only calculates detailed indicators when needed

Related Files

THEORY.md - Complete definition of momentum theory (core, requires user input)
EXAMPLES.md - Usage examples and Q&A
MACD.pine - Reference Pine Script strategy (for reference only)
README.md - Original strategy documentation

Supported Question Types

This Skill automatically activates when detecting the following keywords:

Momentum Analysis:

"BTC momentum", "Bitcoin momentum status"
"Analyze BTC", "BTC market analysis"

Segment and Cycle:

"Uptrend segment", "Downtrend segment", "Segment status"
"Unit adjustment cycle", "Which cycle"
"Inter-cycle divergence"

Divergence and Signals:

"Continuous gap divergence", "Histogram divergence"
"DIF-DEA divergence", "DIF DEA divergence"
"Discrete regulation", "Hidden signal"

Trading Related:

"Buy point", "Sell point", "Trading signal"
"Open long", "Open short", "Stop-loss"

Timeframes:

"1-hour", "4-hour", "Daily"
"Multi-timeframe", "Timeframe linkage"

Limitations and Notes

THEORY.md Must Be Completed:
- This Skill does not contain any hard-coded trading logic
- All rules, parameters, and thresholds are read from THEORY.md
- If THEORY.md is incomplete, analysis results may be inaccurate
Data Latency:
- OKX API data may have 1-2 seconds of latency
- Large-cycle (2-day) data updates slower
Indicator Accuracy:
- MACD calculated by Python may have minor differences from TradingView
- EMA initial value calculation method must match your theory
API Limits:
- OKX: 20 requests/2 seconds
- 8 timeframes = 8 requests, completed in approximately 1 second
Risk Warning:
- This Skill only provides analysis references, does not constitute investment advice
- Multi-timeframe may have conflicting signals, need comprehensive judgment

Maintenance and Updates

Script Location:

.claude/skills/btc-momentum-analyzer/scripts/

Theory Updates: Takes effect immediately after modifying THEORY.md, no restart required
Parameter Adjustments: All parameters configured in THEORY.md
Version Control: Submit updates via git, team members sync automatically

Next Steps

Complete THEORY.md:
- Define all momentum theory concepts
- Specify buy/sell point trigger conditions
- Configure all thresholds and parameters

Test Data Retrieval:

bash

python3 scripts/fetch_btc_data.py --symbol BTC-USDT --timeframes 1h --limit 10

Verify Indicator Calculation:
- Compare Python calculation results with TradingView
- Ensure EMA26/52 and MACD values are consistent
Complete Analysis Test:
- Run the complete analysis process
- Check report format and content
- Adjust THEORY.md based on actual trading experience

Important Note: The core of this Skill is THEORY.md. Please ensure all rules and definitions in this file are fully completed. The Skill will strictly analyze according to your defined theory, without adding any subjective judgments.

btc-momentum-analyzer

NPX Install

Tags

SKILL.md Content (Chinese)

BTC Momentum Theory Analyzer

Feature Overview

Momentum Theory System

Usage Guide

One-Click Analysis (Recommended)

Manual Execution Steps (Advanced Users)

Step 1: Retrieve Multi-Timeframe Data

Step 2: Calculate Technical Indicators

Step 3: Momentum Theory Analysis

Step 4: Generate Trading Report

Typical Output Example

Complete Momentum Analysis Report

Data Source Explanation

OKX API

Alternative Data Sources

Output Formats

Text Report (Default)

JSON Report

Simplified Report

Analysis Depth Control

Complete Analysis (Default)

Focused Analysis

Quick Scan

Error Handling

Performance Optimization

Related Files

Supported Question Types

Limitations and Notes

Maintenance and Updates

Next Steps