Regime Change

Monitors BTC, ETH, and SOL perp regime state over a rolling 2-hour window. Returns regime_changed flag, from_regime, to_regime, and bias_changed per currency. Ed25519 signed. $0.50. 30s cache.

What It Does

Compares the current perp regime for each currency against the regime recorded 2 hours ago from perp_history.db. If they differ, regime_changed is true and the transition details are returned.

This is a point-in-time diff — it tells you whether the regime has changed in the last 2 hours, not a full history of all intermediate transitions. For regime duration and persistence, see Regime Persistence.

Endpoint

Response Format

{
  "service": "regime_change",
  "layer": "Oracle Intelligence",
  "regime_changed": true,
  "transitions": [
    {
      "currency": "BTC",
      "regime_changed": true,
      "from_regime": "BULLISH_MOMENTUM",
      "to_regime": "NEUTRAL_CHOPPY",
      "bias_changed": true,
      "current": {
        "regime": "NEUTRAL_CHOPPY",
        "bias": "NEUTRAL",
        "confidence": 0.55,
        "risk": "LOW"
      },
      "two_hours_ago": {
        "regime": "BULLISH_MOMENTUM",
        "bias": "LONG",
        "confidence": 0.75
      }
    },
    {
      "currency": "ETH",
      "regime_changed": false
    },
    {
      "currency": "SOL",
      "regime_changed": false
    }
  ],
  "transitions_found": 1,
  "disclaimer": "This is a market regime classification derived from quantitative signals, not financial advice...",
  "signed": true,
  "fetched_at": 1781100000
}

Preview Endpoint

Returns regime_changed, transitions_found, and a summary of which currencies changed — unsigned, up to 24h stale.

curl https://api.myceliasignal.com/oracle/intel/regime/change/preview

Agent Use Patterns

Position invalidation: Poll every 30s. If a position was entered on BULLISH_MOMENTUM and regime_changed is true with to_regime = NEUTRAL_CHOPPY or BEARISH, trigger review or exit logic.

Entry gate: Require regime_changed = false before entering a new position — avoid entering immediately after a transition when the new regime hasn't had time to establish.

Alert trigger: Fire a notification whenever regime_changed flips true. Include from_regime, to_regime, and bias_changed in the alert payload.