bitcoin-model/NOTES.md

# Bitcoin Price Model Description

## Overview
This Bitcoin price prediction model uses a combination of log returns, cycle awareness, market maturity eras, 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

### Market Maturity
- Recognizes distinct market eras with different characteristics
- Adjusts projections based on market maturity level
- Accounts for major market structure changes (e.g., futures introduction)
- Provides era-specific calibration of uncertainty estimates

### 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: 16.8%
- RMSE: ~$13,940
- Max Error: $32,536
- 95% CI Coverage: 100%
- 68% CI Coverage: 79.5%

## 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

## Development History
1. Started with direct cycle analysis of returns
2. Added log-based analysis for better handling of exponential growth
3. Incorporated market maturity through era-specific adjustments
4. Refined volatility calculation using multiple timeframes
5. Calibrated confidence intervals through era-aware scaling

## Current Implementation
The model uses four main functions:
1. `calculate_market_maturity_score()`: Evaluates market maturity indicators
2. `analyze_trends()`: Calculates cycle-position-specific log returns
3. `calculate_volatility()`: Computes era-adjusted volatility estimates
4. `project_prices()`: Generates price projections using Monte Carlo simulation

## Strengths
- Well-calibrated uncertainty estimates for post-2013 data
- Captures both cycle effects and market maturity
- Handles exponential price growth naturally
- Balances complexity with interpretability
- Adapts to different market eras

## Possible Future Improvements
- Non-linear cycle progression
- Regime detection for market phases
- External factor incorporation
- Dynamic adjustment of parameters based on market conditions
- Improved handling of market transitions

## 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.