Current Regime

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
}

GET

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 →

Tier: Free ✅ Cache TTL: 300 seconds (5 min)

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

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 | null

Show child attributes

regime_age_hours

number | null

regime_v2

string | null

regime_v2_compatible_strategies

string[] | null

Public

Free Tier

Basic Tier ($49/mo)

Webhooks (Basic+)

Pro Tier ($199/mo)

API Keys

Regime States

Response Fields

Authorizations

Response

​Regime States

​Response Fields

Authorizations

Response

Regime States

Response Fields