# HYPERNATT Liquidity Radar (liq-radar)

> HYPERNATT Liquidity Radar (liq-radar) is a paid API for AI agents from hypernatt.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns real-time crypto liquidity cluster analysis including magnet bias, long/short ratio, liquidation density, and recent liquidation events for a given symbol.

## Facts

- Endpoint: GET https://hypernatt.com/api/m2m/liq-radar
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hypernatt-liquidity-radar-liq-radar-ae16ccf2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cs7-JHZyCHQyIYVWcL65t

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 hypernatt-liquidity-radar-liq-radar-ae16ccf2
```

Example prompt: Pull the HYPERNATT liq-radar for BTC — I want to see whether there's a bullish or bearish magnet right now, where the biggest liquidation clusters are above and below price, and what the long/short ratio looks like.

## When to prefer this

Use this endpoint when you need real-time crypto liquidation cluster intelligence — specifically magnet bias direction, long/short ratio, and mapped liquidation density zones — for trading decisions or automated signals. Prefer over generic order book endpoints when you specifically want liquidation heatmap and magnet scoring rather than raw order book depth.

## Known failure modes

- Unsupported or invalid symbol returns an error or empty result
- Network timeout if market data feed is temporarily unavailable
- Payment failure if x402 USDC micropayment is not completed (0.001 USDC required per call)
- Rate limiting if too many requests are made in a short window
- Stale data if underlying exchange feed lags

## How this service works

Forced-order map. If cluster_grammar is present, read it before liq_radar. class=noise (<3%) is high-leverage bait - ignore. class=true (~7%+) is the low-leverage stack. Terrain, not a signal. Whitelist BTC ETH SOL BNB XRP HYPE ZEC (omit = BTC).

## Output

Returns a JSON object with: magnet bias label (e.g. BEARISH_MAGNET) and numeric score, long/short percentage split, liquidity density asymmetry score, arrays of liquidation clusters above and below current price (each with price level, size in base currency, and distance %), and recent liquidation counts with dominant side over the past 1-hour window.

## Example request

```json
{
 "properties": "BTC"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "symbol": "BTC",
  "product": "hypernatt_liq_radar_v1",
  "liq_radar": {
   "magnet": {
    "bias": "BEARISH_MAGNET",
    "score": -60
   },
   "ls_ratio": {
    "long_pct": 67,
    "short_pct": 33
   },
   "liq_density": {
    "asymmetry": 0.32,
    "clusters_above": [
     {
      "price": 64100,
      "size_btc": 60.8,
      "distance_pct": 3.45
     }
    ],
    "clusters_below": [
     {
      "price": 59100,
      "size_btc": 123.5,
      "distance_pct": 4.62
     }
    ]
   },
   "real_liquidations": {
    "window_1h": {
     "count": 43,
     "dominant": "short"
    }
   }
  },
  "default_symbol": "BTC",
  "payload_schema": "hypernatt_liq_radar_v2",
  "supported_symbols": [
   "BTC",
   "ETH",
   "SOL",
   "BNB",
   "XRP",
   "HYPE",
   "ZEC"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hypernatt-liquidity-radar-liq-radar-ae16ccf2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hypernatt.com](https://www.zero.xyz/host/hypernatt.com/llms.txt)