Perp Setup Scanner

Scans BTC, ETH, and SOL perp regimes simultaneously. Returns the highest-confidence setup with signal alignment, edge description, invalidation conditions, and MSSI market bias overlay. $1.00. 30s cache.

What It Does

Calls Perp Regime (Layer 2) for BTC, ETH, and SOL concurrently, then scores each setup by confidence, regime type, and risk. Applies an MSSI market bias overlay — when the market is RISK_OFF, LONG setups are downgraded.

Returns only setups above a minimum confidence threshold (0.55) with a non-NEUTRAL bias. If no setups meet the threshold, setups_found is 0 and highest_confidence_setup is null.

Scoring Logic

Market Bias Overlay

Endpoint

Response Format

{
  "service": "perp_setup",
  "layer": "Oracle Intelligence",
  "highest_confidence_setup": {
    "currency": "BTC",
    "signal_alignment": "SHORT",
    "regime": "BEARISH_MOMENTUM",
    "confidence": 0.7,
    "risk": "MODERATE",
    "score": 65.0,
    "edge": "funding_negative, oi_declining",
    "invalidation_conditions": "funding turns strongly negative or liq flow flips to SHORT dominant",
    "funding_pct": -0.00180,
    "basis_regime": "CONTANGO",
    "liq_dominant": "SHORT"
  },
  "all_setups": [
    {
      "currency": "BTC",
      "signal_alignment": "SHORT",
      "regime": "BEARISH_MOMENTUM",
      "confidence": 0.7,
      "score": 65.0
    },
    {
      "currency": "SOL",
      "signal_alignment": "SHORT",
      "regime": "BEARISH_MOMENTUM",
      "confidence": 0.7,
      "score": 60.0
    }
  ],
  "setups_found": 2,
  "market_bias": "CAUTIOUS",
  "mssi_value": 45.8,
  "mssi_regime": "ELEVATED",
  "scanned": ["BTC", "ETH", "SOL"],
  "disclaimer": "This is a signal alignment classification derived from quantitative regime data, not financial advice...",
  "signed": true,
  "fetched_at": 1781100000
}

Signal Alignment vs Buy/Sell

signal_alignment is LONG, SHORT, or NEUTRAL — describing how the quantitative signals are aligned, not a trading recommendation. What you do with that alignment is your decision.

invalidation_conditions describes which signal changes would negate the current alignment — useful for agents monitoring regime changes.

edge lists the specific signal notes that drove the classification, e.g. funding_extreme_negative, liq_short_dominant.

Preview Endpoint

Returns top setup currency, signal alignment, confidence, risk, setups found, and market bias — unsigned. No full setup details or invalidation conditions.

curl https://api.myceliasignal.com/oracle/intel/perp/setup/preview

Payment

x402 only (USDC on Base). $1.00 per query. 30s background cache.