GET /screener

$0.06 USDC

Scans all available Hyperliquid perpetuals and returns a compact summary for each coin — signal strength, RSI zone, trend direction, volatility regime, funding bias, confluence, and open interest trend. Ideal for market-wide scanning before drilling into individual coins.

Request

GET https://api.cerebruspulse.xyz/screener

Query Parameters

Parameter	Type	Default	Range	Description
`top_n`	integer	`50`	1–50	Maximum number of coins to return.

Response

Field	Type	Description
`timestamp_iso`	string	ISO 8601 timestamp
`coins_scanned`	integer	Number of coins analyzed
`coins`	array	Per-coin summary objects
`coins[].coin`	string	Coin ticker
`coins[].signal_strength`	number	Overall signal strength (0.0–1.0)
`coins[].rsi_zone`	string	RSI zone: `OVERSOLD`, `NEUTRAL`, `OVERBOUGHT`
`coins[].trend`	string	Trend direction: `BULLISH`, `BEARISH`, `NEUTRAL`
`coins[].vol_regime`	string	Volatility regime: `LOW`, `NORMAL`, `HIGH`, `EXTREME`
`coins[].funding_bias`	string	Funding bias: `LONG_PAYING`, `SHORT_PAYING`, `NEUTRAL`
`coins[].confluence_bias`	string	Confluence bias: `BULLISH`, `BEARISH`, `NEUTRAL`
`coins[].oi_trend`	string	OI trend: `RISING`, `FALLING`, `FLAT`
`coins[].cex_dex_spread_bps`	number	CEX-DEX price divergence in basis points (where available)
`coins[].cex_dex_direction`	string	`cex_premium`, `dex_premium`, or `null`
`meta`	object	Provider metadata

Example

GET /screener?top_n=5

{
  "timestamp_iso": "2026-03-04T10:00:00Z",
  "coins_scanned": 48,
  "coins": [
    {
      "coin": "BTC",
      "signal_strength": 0.72,
      "rsi_zone": "NEUTRAL",
      "trend": "BULLISH",
      "vol_regime": "NORMAL",
      "funding_bias": "LONG_PAYING",
      "confluence_bias": "BULLISH",
      "oi_trend": "RISING",
      "cex_dex_spread_bps": 5.2,
      "cex_dex_direction": "cex_premium"
    },
    {
      "coin": "ETH",
      "signal_strength": 0.58,
      "rsi_zone": "NEUTRAL",
      "trend": "NEUTRAL",
      "vol_regime": "LOW",
      "funding_bias": "NEUTRAL",
      "confluence_bias": "NEUTRAL",
      "oi_trend": "FLAT",
      "cex_dex_spread_bps": 8.6,
      "cex_dex_direction": "cex_premium"
    }
  ],
  "meta": {
    "provider": "Cerebrus Pulse",
    "offering": "cerebrus_pulse",
    "execution_ms": 2400
  }
}

Next Steps

GET /pulse/{coin} — Drill into a specific coin with full multi-timeframe analysis
Python SDK Guide — Build a screener integration in Python
TypeScript SDK Guide — Build a screener integration in TypeScript
x402 Payments — Understand the payment flow

Errors

Status	Reason
402	Payment required (standard x402 flow)
429	Rate limit exceeded
503	Data freshness guarantee exceeded