# Hyperextend Trades Coverage

> Hyperextend Trades 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-14).

Returns coverage metadata for Hyperliquid trade history on a given coin over a specified time window, including gaps, first/last trade timestamps, and hours with trades.

## Facts

- Endpoint: GET https://api.hyperextend.xyz/v1/trades/coverage
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperextend-trades-coverage-50c411c6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e1qZf_MbxC0e1sJiogIBO

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-trades-coverage-50c411c6
```

Example prompt: Can you check the trade history coverage for BTC on Hyperliquid from timestamp 0 to 3600000 — I want to know if there are any gaps and how many hours actually have trades?

## When to prefer this

Use this endpoint when you need to audit or validate the completeness of Hyperliquid historical trade data for a specific coin before running backtests, analytics, or data pipelines. It is the right choice when you need to discover data gaps, determine the actual span of available trade records, or confirm coverage before querying raw trade data from Hyperextend.

## Known failure modes

- Missing required query parameters (coin, start, end) returns a 400 error
- Invalid coin symbol returns empty or error response
- Payment not included or insufficient returns 402 Payment Required
- Start timestamp after end timestamp may return empty or invalid range
- Coin with no trade history returns zero hours and empty gaps array

## How this service works

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

## Output

Returns a JSON object with the coin and DEX identifier, the requested start/end window, first and last trade timestamps in milliseconds, a list of any data gaps, the number of hours that contain trades, and the number of archived hours examined.

## 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_trade_ms": 3599000,
  "first_trade_ms": 0,
  "hours_with_trades": 1,
  "archived_hours_examined": 1
 }
}
```

## More

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