# Hyperextend Trades History

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

Returns per-minute trade history (price, size, side, hash, users) for a given Hyperliquid asset over a specified time window

## Facts

- Endpoint: GET https://api.hyperextend.xyz/v1/trades/%7Bcoin%7D
- Price: $0.016/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperextend-trades-history-9de42d9f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4YbZs-I_5bmU-NHLWjKda

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-history-9de42d9f
```

Example prompt: Pull all BTC trades on Hyperliquid from the last hour — I want to see price, size, side (buy/sell), and which wallet addresses were involved.

## When to prefer this

Use this endpoint when you need raw trade-level data (individual fills) for a Hyperliquid perpetual or spot asset, including price, size, direction, and wallet addresses. Prefer this over candle/OHLCV endpoints when you need tick-level granularity or want to analyze individual trade events, not aggregated price bars. Choose this over open interest or funding endpoints when your goal is to examine actual executed trades rather than market state.

## Known failure modes

- Invalid or unsupported coin symbol returns 404 or empty result
- Start/end timestamps out of valid range may return empty array
- Malformed path parameter causes 400 error
- Missing x402 payment header causes 402 Payment Required response
- Very large time windows may return truncated or paginated results
- Network timeout if querying extremely dense trading periods

## 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

Returns an array of trade records for the requested coin, each containing: trade price (px), size (sz), trade ID (tid), coin symbol, transaction hash, side (A or B indicating buyer/seller), timestamp in milliseconds, and an array of two user wallet addresses involved in the trade.

## 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",
  "tid": 859758437920209,
  "coin": "BTC",
  "hash": "0xa2f9738770fb57c6a473043cd486820204b5006d0bfe769846c21eda2fff31b1",
  "side": "A",
  "time": 1700000000123,
  "users": [
   "0xf513d3489017dea4e04c6a11cc62ec360054d7c6",
   "0x1a2e6afa298b1cc50939b4b2b0b430e3c1ef3459"
  ]
 }
}
```

## More

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