curl https://api.aioka.io/v1/regime/current \
-H "X-API-Key: aik_free_your_key_here"
{
"regime": "BULL_TRENDING",
"confidence": 0.84,
"btc_price": 67124.0,
"detected_at": "2026-04-03T10:00:00Z",
"cached": true,
"cache_ttl_seconds": 290,
"strength": "STRONG",
"sub_regime": "MOMENTUM_CONFIRMED",
"volatility_state": "NORMAL",
"chop_score": 0.22,
"breakout_imminent": false,
"compatible_strategies": ["momentum", "trend_following", "breakout", "dip_buying"],
"incompatible_strategies": ["short_momentum", "mean_reversion"],
"transition_probabilities": {
"BULL_TRENDING": 0.72,
"WHALE_ACCUMULATION": 0.18,
"HIGH_VOLATILITY": 0.10
},
"regime_age_hours": 4.5
}
Free Tier
Current Regime
Current HMM-detected market regime with enrichment
GET
/
v1
/
regime
/
current
curl https://api.aioka.io/v1/regime/current \
-H "X-API-Key: aik_free_your_key_here"
{
"regime": "BULL_TRENDING",
"confidence": 0.84,
"btc_price": 67124.0,
"detected_at": "2026-04-03T10:00:00Z",
"cached": true,
"cache_ttl_seconds": 290,
"strength": "STRONG",
"sub_regime": "MOMENTUM_CONFIRMED",
"volatility_state": "NORMAL",
"chop_score": 0.22,
"breakout_imminent": false,
"compatible_strategies": ["momentum", "trend_following", "breakout", "dip_buying"],
"incompatible_strategies": ["short_momentum", "mean_reversion"],
"transition_probabilities": {
"BULL_TRENDING": 0.72,
"WHALE_ACCUMULATION": 0.18,
"HIGH_VOLATILITY": 0.10
},
"regime_age_hours": 4.5
}
To use the playground, enter your API key in the X-API-Key field above.
Don’t have a key? Get one free →
Regime States
| Regime | Description |
|---|---|
BULL_TRENDING | Strong uptrend with momentum |
BEAR_TRENDING | Strong downtrend with distribution |
HIGH_VOLATILITY | Elevated vol — reduced sizing |
DISTRIBUTION | Smart money offloading |
WHALE_ACCUMULATION | Large entity accumulation |
RISK_ON | Risk appetite elevated |
LOW_VOLATILITY | Compression — breakout pending |
ACCUMULATION | Stealth accumulation at support |
Response Fields
| Field | Type | Description |
|---|---|---|
regime | string | Current regime label |
confidence | float | HMM confidence score (0–1) |
btc_price | float | null | BTC price at detection time |
detected_at | datetime | null | When the regime was detected |
cached | bool | Whether response is from cache |
cache_ttl_seconds | int | Seconds remaining in cache |
strength | string | null | STRONG / MODERATE / WEAK based on confidence |
sub_regime | string | null | Granular sub-classification (e.g. MOMENTUM_CONFIRMED) |
volatility_state | string | null | EXPANDING / COMPRESSED / NORMAL / ELEVATED / CONTRACTING |
chop_score | float | null | Market choppiness 0.0 (trending) → 1.0 (choppy) |
breakout_imminent | bool | null | true when LOW_VOLATILITY + confidence ≥ 0.70 |
compatible_strategies | string[] | null | Strategy types that suit this regime |
incompatible_strategies | string[] | null | Strategy types to avoid in this regime |
transition_probabilities | object | null | Probability of transitioning to each next regime |
regime_age_hours | float | null | Hours the current regime has been active |
curl https://api.aioka.io/v1/regime/current \
-H "X-API-Key: aik_free_your_key_here"
{
"regime": "BULL_TRENDING",
"confidence": 0.84,
"btc_price": 67124.0,
"detected_at": "2026-04-03T10:00:00Z",
"cached": true,
"cache_ttl_seconds": 290,
"strength": "STRONG",
"sub_regime": "MOMENTUM_CONFIRMED",
"volatility_state": "NORMAL",
"chop_score": 0.22,
"breakout_imminent": false,
"compatible_strategies": ["momentum", "trend_following", "breakout", "dip_buying"],
"incompatible_strategies": ["short_momentum", "mean_reversion"],
"transition_probabilities": {
"BULL_TRENDING": 0.72,
"WHALE_ACCUMULATION": 0.18,
"HIGH_VOLATILITY": 0.10
},
"regime_age_hours": 4.5
}
Authorizations
Your AIOKA Intelligence API key (format: aik_{tier}_{random})
Response
Current regime
Show child attributes
Show child attributes