1. 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)
2. 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)
3. Segment Classification: Identify market status for each timeframe
   • Uptrend segment (DEA > 0)
   • Downtrend segment (DEA < 0)
   • Transition period and breakout attempts
4. 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
5. Multi-Timeframe Linkage:
   • Influence of higher-level cycles on lower-level cycles
   • Confirmation of multi-cycle resonance
   • Recursive analysis of nested relationships
6. Trading Signal Generation:
   • Identification of buy/sell points (rules defined in THEORY.md)
   • Stop-loss and take-profit suggestions
   • Confidence level assessment

• 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

• "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"

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

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

• --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)

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

• 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

• 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)

• 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

• 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

• 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

• 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

• 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

• 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

• 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

• 2-day timeframe is in the 2nd unit adjustment cycle, strong uptrend
• 1-day timeframe shows minor DIF-DEA divergence, need to be cautious

• 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

• 2h timeframe confirmed downtrend segment (DEA crossed below 0-axis)
• 1h, 30m timeframes continue downtrend, but 30m shows histogram convergence (hidden reversal signal)

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

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

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

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

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)

undefined

• 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

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

• 2d →

  2D

• 1d →

  1D

• 12h →

  12H

• 6h →

  6H

• 4h →

  4H

• 2h →

  2H

• 1h →

  1H

• 30m →

  30m

1. 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)
2. Binance API (fallback):
   • Automatically switches if OKX API is unavailable
   • Note: Binance's timeframe names are slightly different
3. Manual Export:
   • Export CSV from TradingView or other platforms
   • Place in

     data/

     directory
   • Script can automatically recognize and parse

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

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

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

• 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

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

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

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

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

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

1. 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
2. Data Latency:
   • OKX API data may have 1-2 seconds of latency
   • Large-cycle (2-day) data updates slower
3. Indicator Accuracy:
   • MACD calculated by Python may have minor differences from TradingView
   • EMA initial value calculation method must match your theory
4. API Limits:
   • OKX: 20 requests/2 seconds
   • 8 timeframes = 8 requests, completed in approximately 1 second
5. Risk Warning:
   • This Skill only provides analysis references, does not constitute investment advice
   • Multi-timeframe may have conflicting signals, need comprehensive judgment

• 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

1. Complete THEORY.md:
   • Define all momentum theory concepts
   • Specify buy/sell point trigger conditions
   • Configure all thresholds and parameters
2. Test Data Retrieval:
   bash

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

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