Perp Regime
10-signal perp trading regime for BTC, ETH, and SOL. Returns a regime classification with signal alignment, confidence score, and risk level. $0.15 per currency. 30s cache.
Overview
The Perp Regime oracle fans out to 10 Layer 1 signals internally — funding rate, open interest delta, basis/carry regime, liquidation flow, orderbook depth imbalance, implied volatility, spot price trend, VWAP deviation, term structure, and MSXI/MSVI sentiment — then classifies the combined signal into a named regime with directional bias and confidence.
Rather than calling 10 endpoints and writing your own classification logic, one call returns a signed interpretation your agent can act on directly.
Endpoints
| Endpoint | Currency | Price | Cache | Preview |
|---|---|---|---|---|
/oracle/perp/btc | BTC | $0.15 | 30s | /preview ↗ |
/oracle/perp/eth | ETH | $0.15 | 30s | /preview ↗ |
/oracle/perp/sol | SOL | $0.15 | 30s | /preview ↗ |
Note: MSXI and MSVI are not available for SOL — the SOL regime uses 8 signals and classifies without sentiment/volatility index overlay.
Regime Classifications
| Regime | Bias | Description |
|---|---|---|
BULLISH_MOMENTUM | LONG | Funding positive, OI rising, liq flow LONG dominant, basis contango |
BEARISH_MOMENTUM | SHORT | Funding negative, OI declining, liq flow SHORT dominant |
SQUEEZE_SETUP | LONG | Funding extreme negative with rising OI — short squeeze conditions |
LONG_TRAP | SHORT | Funding extreme positive, OI stalling, orderbook thinning above |
VOLATILITY_SPIKE | NEUTRAL | IV spike, liquidations elevated both sides, regime unclear |
BEARISH_FUNDING_EXTREME | SHORT | Funding at multi-week lows, persistent SHORT bias across signals |
NEUTRAL_CONSOLIDATION | NEUTRAL | Signals mixed or weak — no clear directional alignment |
Response Format
{
"currency": "BTC",
"layer": "Oracle Information",
"regime": {
"perp_regime": "BEARISH_MOMENTUM",
"bias": "SHORT",
"confidence": 0.7,
"risk": "MODERATE",
"signal_notes": "funding_negative, oi_declining, liq_short_dominant"
},
"signals": {
"funding_pct": -0.00180,
"oi_delta_1h": -0.024,
"basis_regime": "CONTANGO",
"liq_dominant": "SHORT",
"liq_imbalance": 0.68,
"orderbook_imbalance": -0.12,
"iv_atm": 58.4,
"price_trend": "DOWN",
"vwap_deviation": -0.0031,
"msxi_value": -18.4,
"msxi_regime": "BEARISH",
"msvi_value": 54.2,
"msvi_regime": "ELEVATED"
},
"signed": true,
"fetched_at": 1781100000
}Confidence and Risk
Confidence (0.0–1.0) reflects signal agreement. High confidence means most of the 10 signals point the same direction. Low confidence means mixed signals — useful as a position sizing input.
Risk levels: LOW, MODERATE, ELEVATED, HIGH, EXTREME. Derived from IV regime, liquidation intensity, and orderbook depth. HIGH or EXTREME risk means the regime reading is valid but conditions are volatile enough that invalidation could be rapid.
Preview Endpoints
Each currency has a free preview returning perp_regime, bias, confidence, and risk — unsigned, no signal breakdown.
curl https://api.myceliasignal.com/oracle/perp/btc/preview curl https://api.myceliasignal.com/oracle/perp/eth/preview curl https://api.myceliasignal.com/oracle/perp/sol/preview
Payment
x402 only (USDC on Base). $0.15 per currency per query. 30s background cache — queries within the same 30s window receive the same signed snapshot.