# Hyperextend Liquidations Coverage

> Hyperextend Liquidations Coverage is a paid API for AI agents from api.hyperextend.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns coverage metadata for Hyperliquid per-minute liquidation data — gaps, first/last liquidation timestamps, and hours examined — for a given coin and time window.

## Facts

- Endpoint: GET https://api.hyperextend.xyz/v1/liquidations/coverage
- 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/hyperextend-liquidations-coverage-b2aca137
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yR4j9_LFxieZVb0nGPbGF

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-coverage-b2aca137
```

Example prompt: Check the liquidation data coverage for BTC on Hyperliquid from timestamp 0 to 3600000 — I want to know if there are any gaps and when the first and last liquidations were recorded in that window.

## When to prefer this

Use this endpoint when you need to audit or validate the completeness of Hyperliquid liquidation data before querying details, or when diagnosing gaps in historical liquidation records for a specific coin over a defined time window. Prefer this over raw liquidation queries when data quality or coverage verification is the primary goal.

## Known failure modes

- Missing required query params (coin, start, end) returns 400 error
- Invalid coin symbol returns empty or error response
- Start timestamp greater than end timestamp may return error or empty result
- No liquidation data found for the specified window returns empty gaps and zero hours
- Payment not included or invalid returns 402 Payment Required
- Very large time windows may time out or return partial results

## How this service works

Archive coverage for a coin's liquidations over a window (≤7 days): which archived hours hold liquidations and where the gaps are. Warms the cache for everyone after. Priced floor ($0.001) + $0.05 per archived hour examined.

## Output

A JSON object containing the coin and DEX identifier, the requested start/end window, a list of coverage gaps (if any), the timestamp of the first and last liquidation within the window, the number of archived hours examined, and the number of hours that had at least one liquidation.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "end": 1704153600,
   "coin": "BTC",
   "start": 1704067200
  }
 }
}
```

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin",
      "start",
      "end"
     ],
     "properties": {
      "end": {
       "type": "integer"
      },
      "coin": {
       "type": "string"
      },
      "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": {
  "dex": "main",
  "coin": "BTC",
  "gaps": [],
  "requested": {
   "end": 3600000,
   "start": 0
  },
  "last_liquidation_ms": 3599000,
  "first_liquidation_ms": 0,
  "archived_hours_examined": 1,
  "hours_with_liquidations": 1
 }
}
```

## More

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