bitcoin-model/NOTES.md

# Bitcoin Price Model Description

## Overview
This Bitcoin price prediction model uses a combination of log returns, cycle awareness, and Monte Carlo simulation to generate price projections with confidence intervals. The model was developed through several iterations, with each refinement aimed at improving accuracy and reliability.

## Core Components

### 1. Trend Analysis
- Uses log returns of Bitcoin prices to better handle exponential growth patterns
- Groups returns by position within the halving cycle (0-1460 days)
- Applies simple moving average smoothing to reduce noise while preserving underlying patterns
- Position within cycle is calculated linearly between known halving dates

### 2. Market Era Adjustments
Uses distinct eras with specific characteristics:
- Early (2013-2017): Higher volatility, conservative trends, moderate trend following
- Transition (2017-2020): Slightly elevated uncertainty during futures market introduction
- Mature (2020+): Reduced volatility, balanced trends, lighter trend following

Each era has specific scaling factors for volatility, trend expectations, and trend following behavior

### 3. Volatility Estimation
Uses a multi-timeframe approach:
- Short window (30 days)
- Medium window (90 days)
- Long window (180 days)
- Combines these using weighted exponential moving averages
- Applies era-specific scaling factors

### 4. Price Projection
- Uses Monte Carlo simulation with 1000 paths
- Incorporates era-aware adjustments to volatility and trends
- Generates both point estimates and confidence intervals
- Projects forward using cycle-aware return expectations

## Key Features

### Log Returns
Instead of working directly with prices or simple returns, the model uses log returns which:
- Better handle Bitcoin's exponential price growth
- Provide more stable statistical properties
- Allow for simpler cumulative return calculations

### Cycle Awareness
- Recognizes Bitcoin's ~4 year (1460 day) halving cycle
- Maps historical returns to cycle positions
- Allows the model to capture recurring patterns around halving events

### Enhanced Monte Carlo
- Base simulation using normal distribution
- Includes era-specific adjustments for volatility and trends
- Generates both median projections and confidence intervals
- Well-calibrated uncertainty estimates for post-2013 data

## Performance Metrics
When trained on 2016-2024 (two full cycles):
- MAPE: 11.7%
- RMSE: ~$9,011
- Max Error: $18,786
- 95% CI Coverage: 99.5%
- 68% CI Coverage: 69.0%

## Model Limitations
- Not suitable for pre-2013 market data
- Assumes future cycles will resemble post-2013 patterns
- Uses simple linear interpolation between halving dates
- May not capture extreme market events well
- Shows increased error in transition periods (2015-2018)

## Development History
1. Started with direct cycle analysis of returns
2. Added log-based analysis for better handling of exponential growth
3. Refined volatility calculation using multiple timeframes
4. Calibrated confidence intervals through era-aware scaling
5. Attempted model refinements for transition periods

### Recent Refinement Attempts (2024)

#### Attempt 1: Era Subdivision
- Split transition period into multiple sub-periods
- Added skew adjustments for different market phases
- Results: Made the model more complex without clear benefits
- Outcome: Abandoned in favor of simpler approach

#### Attempt 2: Dynamic Regime Detection
- Implemented real-time market regime detection
- Used volatility ratios and trend strength metrics
- Results: Made the model too reactive to short-term changes
- Outcome: Less stable than original era-based approach

#### Attempt 3: Weighted Rolling Regression
- Used weighted regression for trend estimation
- Combined cycle position and time-based weights
- Results: Similar performance to original model but more complex
- Key Findings:
  - Recent Period: Slightly worse (MAPE 12.4% vs 11.7%)
  - Mid Period: Marginally better coverage but similar overall
  - Early Period: Similar coverage but worse accuracy
- Outcome: Returned to original implementation due to comparable performance with less complexity

## Current Implementation
The model uses four main functions:
1. `analyze_trends()`: Calculates cycle-position-specific log returns
2. `calculate_volatility()`: Computes era-adjusted volatility estimates
3. `project_prices()`: Generates price projections using Monte Carlo simulation
4. `get_projection_adjustments()`: Handles uncertainty scaling over time

## Strengths
- Well-calibrated uncertainty estimates for post-2013 data
- Handles exponential price growth naturally
- Balances complexity with interpretability
- Adapts to different market eras
- Maintains consistent performance across multiple validation periods

## Key Learnings from Recent Attempts
1. Added complexity doesn't necessarily improve performance:
   - Multiple sub-periods led to over-fitting
   - Dynamic regime detection made the model too reactive
   - Weighted regression provided similar results with more complexity

2. Transition period challenges:
   - 2015-2018 remains consistently challenging across approaches
   - Sharp regime changes are difficult to model without compromising overall stability
   - Simple era boundaries may be as effective as more complex transitions

3. Model stability considerations:
   - Simpler approaches tend to be more robust
   - Era-based adjustments provide good balance of adaptability and stability
   - Over-optimization for specific periods can harm general performance

## Future Improvement Possibilities
1. Conservative Approaches:
   - Fine-tune existing era boundaries
   - Adjust scaling factors within current framework
   - Optimize window sizes for different periods

2. Alternative Approaches to Consider:
   - Hybrid models combining multiple timeframes
   - Conditional volatility models
   - Cycle strength indicators

3. Areas Needing Further Research:
   - Better handling of regime transitions
   - More robust volatility estimation during market structure changes
   - Improved cycle position effects near halving events

## Usage Notes
The model works best when:
- Using post-2013 data
- Trained on at least one full cycle of data
- Used for medium-term projections (months to years)
- Interpreted probabilistically rather than as point forecasts

The confidence intervals should be understood as ranges of likely outcomes based on historical patterns, not hard bounds on future prices. When using the model, particular attention should be paid to the training period selection, as this can significantly impact projection quality.

Special consideration should be given to projections spanning major market structure changes or halving events, as these periods have shown higher uncertainty in backtests.