From solo bot builders to institutional desks, Regime gives you the market context layer your stack is missing. One API call to know if the market is bull, bear, or chop.
Use regime classification to filter entries and dynamically scale position sizes. Your bot trades aggressively in trending markets and goes defensive in chop -- without you building a regime detector from scratch.
Regime returns a single action field (long_bias, short_bias, or hold) plus a confidence score you can use as a position sizing multiplier.
import requests
def get_regime():
r = requests.get("https://getregime.com/api/v1/market/regime",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=5)
return r.json()
regime = get_regime()
# regime = {"regime": "bull", "confidence": 0.82, "action": "long_bias", ...}
if regime["action"] == "hold":
# Chop market -- reduce or skip entries
position_size *= 0.25
elif regime["confidence"] > 0.8:
# High-confidence trend -- full size
position_size *= 1.0
else:
# Low-confidence -- scale down
position_size *= regime["confidence"]Overlay regime classification on your portfolio allocation model. Scale gross exposure by regime confidence, and receive instant webhook alerts when the regime shifts -- before the crowd repositions.
The Institutional tier gives you full historical regime data for backtesting, webhook subscriptions for automated rebalancing, and 1,000 RPM for high-frequency polling.
// Your webhook receives this payload on every regime transition:
{
"event": "regime.shift",
"previous": { "regime": "bull", "confidence": 0.78 },
"current": { "regime": "bear", "confidence": 0.85 },
"signals": {
"macro_trend": "bearish",
"funding_bias": -0.012,
"liquidation_imbalance": "long_heavy",
"fear_greed": 23
},
"ts": 1711411200000
}
// In your risk engine:
if (event.current.regime === "bear" && event.current.confidence > 0.8) {
reduceGrossExposure(0.5); // Cut exposure 50%
hedgeWithPuts();
}Add regime awareness to your Freqtrade bot with a single API call. The dedicated /api/v1/freqtrade/regime endpoint returns a flat JSON response designed for Freqtrade's confirm_trade_entry hook -- your bot pauses in hostile regimes and trades in favorable ones.
Works with any Freqtrade strategy. No strategy rewrite needed -- just add a mixin class.
# In your Freqtrade strategy class:
from regime_filter import RegimeFilter
class MyStrategy(IStrategy, RegimeFilter):
"""Your existing strategy + regime awareness."""
regime_api_key = "YOUR_API_KEY"
# That's it. RegimeFilter overrides confirm_trade_entry
# and blocks entries when regime = "bear" or "chop".
def populate_entry_trend(self, dataframe, metadata):
# Your normal entry logic -- unchanged
...Embed a live regime widget in your newsletter or website. Cite real data instead of vibes. Your readers see the current market regime, confidence score, and key signals -- updated in real-time and sourced from 6 independent data feeds.
The embed widget is a single script tag. Works on Substack, Ghost, WordPress, or any HTML page.
<!-- Add this anywhere in your page -->
<script
src="https://getregime.com/embed.js"
data-key="YOUR_API_KEY"
data-theme="dark">
</script>
<!-- Renders a compact card showing:
Regime: BULL | Confidence: 82% | Fear/Greed: 67
With color-coded regime indicator -->Monitor the macro conditions that drive TVL flows and user behavior. Use regime data to time liquidity incentive programs -- boost rewards when the market is turning bullish and users are actively deploying capital, pause incentives during bearish regimes when TVL naturally contracts.
The intelligence endpoints give you crowd positioning, funding bias, and liquidation imbalance data that correlates directly with DeFi user behavior.
import { RegimeClient } from "getregime"; // npm install getregime
const regime = new RegimeClient({ apiKey: process.env.REGIME_KEY });
async function adjustIncentives() {
const { regime: state, confidence } = await regime.getRegime();
const crowd = await regime.getCrowdPositioning();
if (state === "bull" && confidence > 0.7) {
// Users deploying capital -- boost LP rewards
await setRewardMultiplier(1.5);
} else if (state === "bear") {
// Preserve treasury -- baseline rewards only
await setRewardMultiplier(0.5);
}
}getregime) for TypeScript-native integrationWhite-label Regime intelligence for your customers. Show a regime indicator in your trading UI so traders know the macro context before placing orders. Reduce support tickets from users surprised by "sudden" market moves -- the regime shift was visible hours earlier.
The Institutional tier includes full API access, webhook subscriptions, and historical data for backtesting -- everything your platform needs to offer premium market intelligence.
// Fetch regime status for your trading UI header bar
GET https://getregime.com/api/v1/market/regime
Authorization: Bearer INSTITUTIONAL_API_KEY
// Response:
{
"regime": "bear",
"confidence": 0.85,
"action": "short_bias",
"signals": {
"fear_greed": 23,
"btc_dominance": 58.2,
"macro_trend": "bearish",
"funding_bias": -0.008,
"defi_tvl_trend": "declining",
"stablecoin_flow": "outflow"
},
"updated_at": "2026-03-26T14:30:00Z"
}
// Display in your UI: [BEAR 85%] or [BULL 72%]Free tier gets you started in 60 seconds. No credit card required.
Get Your API Key Compare Plans