# Whale Radar – Hyperliquid Perps Whale Positioning

> Whale Radar – Hyperliquid Perps Whale Positioning is a paid API for AI agents from seenly-whale-radar.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-29).

Returns live whale positioning data for Hyperliquid perpetuals: net long/short bias, top positions with liquidation prices, liquidation cluster maps, funding/OI crowding, and squeeze risk for one coin or all markets.

## Facts

- Endpoint: GET https://seenly-whale-radar.vercel.app/api/whale-radar?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/whale-radar-hyperliquid-perps-whale-positioning-ddb2661b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X8cJ30jQ48ZHKhsohju8Q

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability whale-radar-hyperliquid-perps-whale-positioning-ddb2661b
```

Example prompt: Pull up the Whale Radar for BTC on Hyperliquid and show me the top 10 whale positions — I want to know if smart money is net long or short, where the liquidation clusters are, and whether there's squeeze risk right now.

## When to prefer this

Use this endpoint when you need real-time, whale-specific positioning intelligence for Hyperliquid perpetuals — particularly when assessing smart-money bias, liquidation cascade risk, or crowding/squeeze setups. Prefer this over generic crypto market data APIs when the user specifically wants large-account on-chain positioning, liquidation cluster maps, or Hyperliquid-native perp analytics rather than price, OHLCV, or order book data.

## Known failure modes

- Invalid coin ticker (pattern mismatch) returns 400 error
- Coin not listed on Hyperliquid perps returns empty or error response
- Rate limiting or payment failure returns 402/429
- Hyperliquid data source downtime returns 503 or stale data
- Top parameter exceeding 25 returns validation error

## How this service works

Whale Radar: live Hyperliquid perps positioning of the largest and highest-PnL public accounts for one coin (or ALL): whale net long/short, smart-money bias, top positions with liquidation prices, a liquidation-cluster map, funding/OI/premium crowding and squeeze risk. Not investment advice.

## Output

Returns whale positioning data for the specified coin (or all markets): aggregate net long/short exposure of the largest and highest-PnL public accounts, smart-money directional bias, a ranked list of top positions with their sizes and liquidation prices, a liquidation cluster heatmap, funding rate, open interest, crowding metrics, and a squeeze risk assessment. Also echoes back any provided idempotency key.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "top": {
   "type": "integer",
   "default": 8,
   "maximum": 25,
   "minimum": 1,
   "description": "How many of the largest tracked positions to list."
  },
  "coin": {
   "type": "string",
   "pattern": "^[A-Za-z0-9]{1,20}$",
   "description": "Hyperliquid perp ticker (BTC, ETH, SOL, HYPE, ...) or ALL for the market-wide whale board."
  },
  "requestKey": {
   "type": "string",
   "maxLength": 128,
   "description": "Optional idempotency key, echoed back."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "as_of": "2026-10-06T14:29:15.849Z",
  "market": {
   "mark_px": 86106,
   "premium_pct": -0.0245,
   "funding_apr_pct": 10.95,
   "open_interest_usd": 3449282338
  },
  "whales": {
   "holders": 13,
   "net_bias": "SHORT",
   "smart_money": {
    "net_bias": "LONG"
   },
   "top_positions": [
    {
     "side": "SHORT",
     "entry_px": 76000.1,
     "notional_usd": 241279474,
     "short_address": "0x5b5d…c060",
     "liquidation_px": 140084.2240591986
    }
   ],
   "net_notional_usd": -362233109,
   "gross_notional_usd": 792763109
  },
  "verdict": "BTC: balanced (funding 10.95% APR). 13 tracked whales hold $792.8M, net short $362.2M; smart money long. Squeeze risk: low.",
  "crowding": {
   "label": "BALANCED",
   "score": 8,
   "squeeze_risk": "low",
   "liquidation_magnet": "none"
  },
  "disclaimer": "Not investment advice. ...",
  "liquidation_map": {
   "above": [
    {
     "sides": [
      "SHORT"
     ],
     "to_px": 103327.2,
     "from_px": 102466.14,
     "positions": 1,
     "distance_pct": 19,
     "notional_usd": 25831800
    }
   ],
   "below": [
    {
     "sides": [
      "LONG"
     ],
     "to_px": 54246.78,
     "from_px": 53385.72,
     "positions": 1,
     "distance_pct": -37,
     "notional_usd": 86106000
    }
   ],
   "notional_within_5pct_below_usd": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/whale-radar-hyperliquid-perps-whale-positioning-ddb2661b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from seenly-whale-radar.vercel.app](https://www.zero.xyz/host/seenly-whale-radar.vercel.app/llms.txt)