# Regime

> Regime is a real-time crypto market regime detection API. A single API call returns whether the crypto market is in a bull, bear, or chop regime, with a confidence score and the weighted signals behind the classification. Built for quant traders, trading bots (Freqtrade, 3Commas, custom), and algo developers who need to know when to trade and when to sit out.

## What it does
- Classifies the crypto market into one of three regimes — bull, bear, or chop — from weighted signals (price trend, volatility, funding, liquidations, fear & greed, volume, breadth, and macro).
- Returns a confidence score and the contributing signals, updated continuously.
- Backed by a data moat of 84,000+ historical market snapshots recorded continuously since 2026-03-02, forward-only and never restated.

## Docs and key pages
- [Quickstart](https://getregime.com/quickstart): API docs + interactive playground (run live calls in-browser).
- [API reference (OpenAPI / Swagger)](https://getregime.com/api/docs): full endpoint spec; machine-readable at https://getregime.com/api/openapi.json
- [Freqtrade integration](https://getregime.com/freqtrade): pip install getregime + a regime-filtered strategy example.
- [Pricing](https://getregime.com/pricing): Free (BTC/ETH, 15-min delayed), Pro $49/mo (real-time, all assets, intelligence, webhooks), Institutional $149/mo.
- [The tape](https://getregime.com/tape): every regime change we have recorded, forward-only and never restated.
- [Use cases](https://getregime.com/use-cases) and [comparison vs Glassnode/Nansen/Santiment](https://getregime.com/compare).

## Public endpoints (no auth required)
- GET https://getregime.com/api/v1/market/regime — current regime (bull/bear/chop) + confidence + signals.
- GET https://getregime.com/api/v1/market/overview — market cap, BTC/ETH dominance, fear & greed, DeFi TVL, regime.
- GET https://getregime.com/api/v1/stats — platform stats (snapshots, regimes, uptime).

## Pro endpoints (Bearer API key, 14-day free trial, no credit card)
- GET /api/v1/intelligence/brief — regime + crowd positioning + macro + risk synthesis.
- GET /api/v1/signals/all — strategy signals from candle lanes.
- GET /api/v1/market/futures, /api/v1/market/macro, /api/v1/freqtrade/regime.

## SDKs
- Python: pip install getregime (https://pypi.org/project/getregime/)
- Get a free API key: https://getregime.com (no credit card).

## About
Regime (getregime.com) is a productized crypto market intelligence API. The differentiator is a continuous, always-on data service with a forward-only, never-restated transition history — the algorithm is commoditizable; the continuous data moat is not.