# Hyperliquid BTC Liquidation Levels API

> Hyperliquid BTC Liquidation Levels API is a paid API for AI agents from whaletape.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns BTC whale liquidation price levels with notional at risk, sorted nearest to furthest, from Hyperliquid perpetuals data

## Facts

- Endpoint: GET https://whaletape.xyz/liquidations/BTC
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-btc-liquidation-levels-api-379fc669
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wEWTc1-7slnGuTW5-LXMz

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 hyperliquid-btc-liquidation-levels-api-379fc669
```

Example prompt: Pull the current BTC liquidation levels from Hyperliquid whale data — I want to see which price levels have the most notional at risk and how close they are to spot.

## When to prefer this

Use this endpoint when you specifically need BTC liquidation level data without fetching all 320+ markets. It is more efficient than the full /liquidations endpoint when your agent is only tracking BTC. Prefer this over generic order book or funding rate endpoints when your goal is to find cascading liquidation risk zones from whale positions specifically on Hyperliquid perpetuals.

## Known failure modes

- No active whale liquidation levels near current price — returns empty set
- Hyperliquid data feed delay causes stale liquidation levels
- Rate limit exceeded — 402 payment required if credits exhausted
- Market temporarily unavailable or symbol not found
- Network timeout if Hyperliquid upstream is slow

## How this service works

Where BTC whale positions get liquidated and how far price must move to trigger it: levels with notional at risk, nearest first. Single-market slice of /liquidations, for agents that only track BTC

## Output

An ordered list of BTC liquidation price levels from Hyperliquid, each with the notional value at risk and the distance the price must move to trigger it, sorted nearest-first so agents can immediately identify the most proximate liquidation risk zones.

## Request schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-btc-liquidation-levels-api-379fc669/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from whaletape.xyz](https://www.zero.xyz/host/whaletape.xyz/llms.txt)