crypto-regime-analyzer

Run the crypto_regime_analyzer.py script with an output directory to compute a 0-100 composite score across six components. Scores of 80-100 indicate RISK_ON, 40-79 NEUTRAL, and 0-39 RISK_OFF, with a posture line explaining the result.

The dominance calculator scores BTC dominance direction jointly with BTC trend: falling dominance during a BTC uptrend signals alt rotation (score 90), while rising dominance in a downtrend signals defensive rotation. It requires at least 31 daily dominance observations.

No API keys are required. Live mode uses CoinGecko's free public API for prices and dominance plus Binance's public futures endpoint for funding rates, with per-day caching to respect free-tier rate limits.

Yes, pass a snapshot JSON file via --input-json containing price series, dominance history, and funding rates. The schema is documented in the methodology reference, and offline mode uses only the Python standard library.

The funding component is skipped gracefully and reports data_available as false. Its 15% weight is proportionally redistributed to the remaining components, provided at least four components covering 65% of model weight remain.

No, the score is a descriptive heuristic of market conditions only. It issues no coin picks, price targets, or trade instructions, and the zone bands are not validated allocation rules per the validation documentation.