Skip to main content
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
}

Documentation Index

Fetch the complete documentation index at: https://docs.aioka.io/llms.txt

Use this file to discover all available pages before exploring further.

To use the playground, enter your API key in the X-API-Key field above. Don’t have a key? Get one free →
Tier: Free ✅ Cache TTL: 300 seconds (5 min)

​
Regime States

RegimeDescription
BULL_TRENDINGStrong uptrend with momentum
BEAR_TRENDINGStrong downtrend with distribution
HIGH_VOLATILITYElevated vol — reduced sizing
DISTRIBUTIONSmart money offloading
WHALE_ACCUMULATIONLarge entity accumulation
RISK_ONRisk appetite elevated
LOW_VOLATILITYCompression — breakout pending
ACCUMULATIONStealth accumulation at support

​
Response Fields

FieldTypeDescription
regimestringCurrent regime label
confidencefloatHMM confidence score (0–1)
btc_pricefloat | nullBTC price at detection time
detected_atdatetime | nullWhen the regime was detected
cachedboolWhether response is from cache
cache_ttl_secondsintSeconds remaining in cache
strengthstring | nullSTRONG / MODERATE / WEAK based on confidence
sub_regimestring | nullGranular sub-classification (e.g. MOMENTUM_CONFIRMED)
volatility_statestring | nullEXPANDING / COMPRESSED / NORMAL / ELEVATED / CONTRACTING
chop_scorefloat | nullMarket choppiness 0.0 (trending) → 1.0 (choppy)
breakout_imminentbool | nulltrue when LOW_VOLATILITY + confidence ≥ 0.70
compatible_strategiesstring[] | nullStrategy types that suit this regime
incompatible_strategiesstring[] | nullStrategy types to avoid in this regime
transition_probabilitiesobject | nullProbability of transitioning to each next regime
regime_age_hoursfloat | nullHours 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

​
X-API-Key
string
header
required

Your AIOKA Intelligence API key (format: aik_{tier}_{random})

Response

Current regime

​
regime
string
required
​
confidence
number
required
​
btc_price
number | null
required
​
detected_at
string<date-time> | null
required
​
cached
boolean
required
​
cache_ttl_seconds
integer
required
​
strength
string | null
​
sub_regime
string | null
​
volatility_state
string | null
​
chop_score
number | null
​
breakout_imminent
boolean | null
​
compatible_strategies
string[] | null
​
incompatible_strategies
string[] | null
​
transition_probabilities
Transition Probabilities · object
​
regime_age_hours
number | null
​
regime_v2
string | null
​
regime_v2_compatible_strategies
string[] | null