# Hyperextend Liquidations History

> Hyperextend Liquidations History 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 per-minute historical liquidation events for a given Hyperliquid asset, including price, size, direction, and involved wallet addresses.

## Facts

- Endpoint: GET https://api.hyperextend.xyz/v1/liquidations/%7Bcoin%7D
- 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/hyperextend-liquidations-history-9ba8df59
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KnbAxwh7v8vvsFmJ8oawt

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 hyperextend-liquidations-history-9ba8df59
```

Example prompt: Pull the liquidation history for BTC on Hyperliquid between Unix timestamps 1700000000 and 1700086400 — I want to see which positions were closed, at what price, and who got liquidated.

## When to prefer this

Choose this endpoint when you need granular, per-minute liquidation event data for a specific Hyperliquid perpetual asset, including the wallet addresses involved and on-chain transaction hashes. Prefer it over generic market data endpoints when the specific use case is tracking forced position closures, monitoring cascade liquidation risk, or auditing specific liquidation events on the Hyperliquid DEX.

## Known failure modes

- Invalid or unsupported coin symbol returns an error or empty result
- Missing required coin path parameter causes a 400 or 404 response
- Start/end timestamps out of available data range return empty results
- Payment of 0.111 USDC not fulfilled via x402 protocol results in 402 Payment Required
- Rate limiting or server overload may cause 429 or 503 responses
- Malformed timestamp integers in query params return validation errors

## How this service works

Per-minute Hyperliquid market history: open interest, candles, trades, liquidations, HIP-3, spot and outcome markets. Query any window, pay per request over x402.

## Output

A JSON object containing liquidation event details: the asset coin, execution price, position size, direction (e.g. Close Long), trade ID, transaction hash, side, timestamp in milliseconds, the two involved wallet addresses, mark price at liquidation time, and the specific liquidated user's address.

## 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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "px": "42000.0",
  "sz": "0.5",
  "dir": "Close Long",
  "tid": 859758437920209,
  "coin": "BTC",
  "hash": "0xa2f9738770fb57c6a473043cd486820204b5006d0bfe769846c21eda2fff31b1",
  "side": "A",
  "time": 1700000000123,
  "users": [
   "0xf513d3489017dea4e04c6a11cc62ec360054d7c6",
   "0xa960b2a0fc5f9f53e99df362052e69980cb57fe4"
  ],
  "markPx": "41995.0",
  "method": "market",
  "liquidatedUser": "0xa960b2a0fc5f9f53e99df362052e69980cb57fe4"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperextend-liquidations-history-9ba8df59/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)