# Hyperextend Raw Market Trades (BTC)

> Hyperextend Raw Market Trades (BTC) 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 raw market trade records for a given asset over a specified time window, merging live hot-tier data with S3-archived history, mirroring Hyperliquid's WsTrade format including buyer/seller addresses and trade hashes.

## Facts

- Endpoint: GET https://api.hyperextend.xyz/v1/trades/BTC
- 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-raw-market-trades-btc-db77be99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k67H21P3Qs6IRQkoviNmf

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-raw-market-trades-btc-db77be99
```

Example prompt: Pull all raw BTC trades on Hyperliquid from the last 6 hours, including the buyer and seller wallet addresses and trade hashes.

## When to prefer this

Use this endpoint when you need raw, tick-level trade data for a specific Hyperliquid asset including full counterparty wallet addresses and trade hashes. Prefer this over OHLCV candle endpoints when you need individual trade granularity rather than aggregated price bars. Best for on-chain trade auditing, wallet-level analysis, or reconstructing exact order flow over a time window.

## Known failure modes

- Invalid or unsupported coin symbol returns an error or empty result
- start/end timestamps outside the available archive range may return partial data
- Requesting more than 24 asset-hours in a single call exceeds the limit and may be rejected
- Uncached archive hours incur additional cost and may increase latency
- Payment failure or insufficient USDC balance prevents call execution
- Missing required path parameter (coin) causes a 400-level error

## How this service works

Raw market trades over a time window — the live hot tier (~24h) plus S3 read-through for older history (archive from 2025-05-25), merged. Each row mirrors HL's WsTrade verbatim, including the buyer/seller addresses (`users`) and the trade `hash`. Priced per asset-hour ($0.015 base, $0.03 HIP-3/HIP-4) plus $0.05 per uncached archive hour pulled (warms the cache); ≤24 asset-hours/request.

## Output

A list of trade rows in Hyperliquid WsTrade format, each containing the asset, trade price, size, timestamp, buyer address, seller address, and trade hash. Data is merged from the live hot tier and S3 archive for the requested time window.

## 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/hyperextend-raw-market-trades-btc-db77be99/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)