# AgentFeed Liquidation Heatmap by Price Level

> AgentFeed Liquidation Heatmap by Price Level is a paid API for AI agents from x402.ochinimus.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-01).

Returns a price-bucketed liquidation heatmap for a USDT perpetual, showing USD volume flushed and long/short split per zone over the last N hours, with the hottest zone flagged — built from real liquidation prints, not estimates.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/liq-heatmap?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-liquidation-heatmap-by-price-level-29c257a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZB0hRPYqfQQQhQkf9fn33

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 agentfeed-liquidation-heatmap-by-price-level-29c257a7
```

Example prompt: Show me the liquidation heatmap for SOLUSDT over the last 48 hours using 25 price buckets — I want to see where leverage actually got flushed by price zone, with longs and shorts split out and the hottest zone highlighted.

## When to prefer this

Choose this endpoint when you need to understand WHERE by price level leverage was actually flushed — not estimated liquidation clusters based on open interest, but real historical liquidation prints aggregated into price buckets. It is ideal for identifying high-liquidation price zones, understanding long vs short pressure by price level, and pinpointing the single hottest flush zone. Prefer this over time-bucketed liquidation endpoints when the question is about price geography rather than time sequence.

## Known failure modes

- Missing required 'symbol' query parameter returns an error
- Symbol not found or not a valid Bybit USDT perp returns no data or error
- Hours outside 1–168 range may be rejected or clamped
- Buckets outside 5–50 range may be rejected or clamped
- Payment failure (x402 protocol) results in unpaid response with no data
- Low liquidity perps may return sparse or empty bucket arrays

## How this service works

Liquidation heatmap by PRICE LEVEL: where leverage actually got flushed in the last N hours — USD, prints and long/short split per price zone, with the hottest zone flagged. Use when you need to answer: At which price levels did leverage actually get flushed? Built from real liquidation prints, not entry-price estimates.

## Output

A JSON object containing an array of price-level buckets, each with price_low, price_high, usd_total, longs_usd, shorts_usd, and prints count. Also includes the symbol, lookback hours, overall price_range, and a hottest_zone object identifying the bucket with the highest liquidation volume. Data is built from real liquidation tape prints, not entry-price estimates.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "hours": {
       "type": "number",
       "description": "lookback 1-168, default 24"
      },
      "symbol": {
       "type": "string",
       "description": "USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"
      },
      "buckets": {
       "type": "number",
       "description": "price buckets 5-50, default 20"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "note": {
         "type": "string"
        },
        "hours": {
         "type": "number"
        },
        "levels": {
         "type": "array"
        },
        "symbol": {
         "type": "string"
        },
        "price_range": {
         "type": "array"
        },
        "hottest_zone": {
         "type": "object"
        }
       }
      },
      "paid": {
       "type": "boolean"
      },
      "tool": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "note": "historical flush zones from our tape — where leverage DIED, not an entry-price liq-level estimate",
   "hours": 24,
   "levels": [
    {
     "prints": 14,
     "longs_usd": 25212,
     "price_low": 115.24,
     "usd_total": 25212,
     "price_high": 115.6175,
     "shorts_usd": 0
    },
    {
     "prints": 32,
     "longs_usd": 214279,
     "price_low": 115.6175,
     "usd_total": 214279,
     "price_high": 115.995,
     "shorts_usd": 0
    },
    {
     "prints": 68,
     "longs_usd": 342110,
     "price_low": 115.995,
     "usd_total": 346785,
     "price_high": 116.3725,
     "shorts_usd": 4675
    }
   ],
   "symbol": "SOLUSDT",
   "price_range": [
    115.24,
    122.79
   ],
   "hottest_zone": {
    "prints": 143,
    "longs_usd": 1239307,
    "price_low": 118.6375,
    "usd_total": 2268785,
    "price_high": 119.015,
    "shorts_usd": 1029478
   }
  },
  "paid": true,
  "tool": "get_liq_heatmap"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-liquidation-heatmap-by-price-level-29c257a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ochinimus.app](https://www.zero.xyz/host/x402.ochinimus.app/llms.txt)