# Hyperliquid BTC Forced-Liquidation Tape

> Hyperliquid BTC Forced-Liquidation Tape is a paid API for AI agents from api.hyperextend.xyz, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-15).

Returns reconstructed forced-liquidation trade rows for BTC on Hyperliquid over a specified time window, including trade details and liquidation metadata.

## Facts

- Endpoint: GET https://api.hyperextend.xyz/v1/liquidations/BTC
- Price: $0.006/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-forced-liquidation-tape-05cdab14
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n2KxDerRDgdYwY9ValdhA

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-forced-liquidation-tape-05cdab14
```

Example prompt: Pull the BTC forced-liquidation tape from Hyperliquid for the last 6 hours — I want to see which users got liquidated, at what prices, and whether they were market or backstop liquidations.

## When to prefer this

Use this endpoint when you need granular, per-trade liquidation data for BTC on Hyperliquid, including who was liquidated, at what price, and by which method (market vs backstop). Hyperliquid has no native public liquidations feed, so this reconstructed archive is the only structured source for this data. Prefer this over generic trade feed endpoints when liquidation-specific metadata (liquidated user, mark price, method) is required.

## Known failure modes

- Requested time window not yet available (data available ~2h after hour closes)
- Request exceeds 24 asset-hours per request limit
- Invalid coin symbol returns 400 or empty result
- start/end timestamps out of range or malformed
- Payment insufficient for uncached archive hours requested
- Network timeout on large archive pulls

## How this service works

Forced-liquidation tape over a time window, reconstructed from the node-fills archive (Hyperliquid has no public liquidations feed). Each row is a trade row (coin, side, px, sz, time, hash, tid, users:[buyer, seller]) plus the liquidation markers (method market|backstop, markPx, liquidatedUser, dir). Priced per asset-hour ($0.005 base, $0.01 HIP-3/HIP-4) plus $0.05 per uncached archive hour pulled; up to 24 asset-hours/request, available ~2h after the hour closes.

## Output

A list of trade rows each containing coin, side, price, size, timestamp, transaction hash, trade ID, buyer and seller addresses, plus liquidation-specific fields: method (market or backstop), mark price at liquidation, the liquidated user address, and direction. Data is available approximately 2 hours after each hour closes.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "coin": {
       "type": "string",
       "description": "Asset symbol, e.g. BTC"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "end": {
       "type": "integer"
      },
      "start": {
       "type": "integer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-btc-forced-liquidation-tape-05cdab14/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hyperextend.xyz](https://www.zero.xyz/host/api.hyperextend.xyz/llms.txt)