# hyperextend

> Gap-free Hyperliquid market history — open interest, OHLCV candles, HIP-3, spot and
> HIP-4 outcome markets — recorded continuously at one-minute resolution and served behind
> x402 micropayments (USDC on Base). Free discovery endpoints let you decide before you pay.

## API

- Base URL: https://api.hyperextend.xyz
- Discover (free, no auth): https://api.hyperextend.xyz/v1/discovery
- Universe: `GET /v1/dexes`, `GET /v1/dexes/{dex}/coins`, `GET /v1/coins/{coin}`, `GET /v1/availability/{coin}`
- Coverage / gap manifests (free): `GET /v1/coverage/{coin}?start=&end=`, `GET /v1/candles/{coin}/coverage?start=&end=`

## Paid data (x402)

- `GET /v1/candles/{coin}/{interval}?start=&end=` — OHLCV candles, priced per row.
- `GET /v1/asset_ctx/{coin}?start=&end=` — open interest / funding / mark / oracle / mid / volumes.
- Flow: request the endpoint → HTTP 402 with an `accepts` array and an `instructions` block →
  sign an EIP-3009 `transferWithAuthorization` over USDC for `accepts[0]`, base64-encode it into
  the `X-PAYMENT` header, and retry the same request → 200. You need USDC on Base, not ETH; the
  facilitator broadcasts and pays gas. The settlement receipt returns in `X-PAYMENT-RESPONSE`.
- Pricing: $0.001 per request + $0.000005 per row. Paginate wider ranges with the `X-Next-Start`
  response header.

## Freshness

- Served up to ~2 days ago. For more recent data query Hyperliquid directly:
  https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint

## Docs

- Agent quickstart: https://hyperextend.xyz/agents
- Full API docs: https://hyperextend.xyz/docs