> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xarchive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Hyperliquid historical market data REST API

> Hyperliquid REST API routes: order books, trades and fills with per-trade wallet attribution, candles, funding, OI, liquidations, order lifecycle, and L4.

Pull current and historical market data for Hyperliquid core perpetuals such as `BTC` and `ETH` under `/v1/hyperliquid/*`: order books, trades, candles, funding, open interest, liquidations, order lifecycle, and L4 depth. For an overview of the venue, see [Hyperliquid market data](https://0xarchive.io/hyperliquid).

Core routes take plain perp symbols. A Spot pair (`HYPE-USDC`), a HIP-3 builder symbol (`km:US500`), a HIP-4 outcome side (`#0`), or a Lighter market each has its own namespace, and sending one to a core route reads the wrong market.

## First request

```bash theme={"theme":"github-dark"}
curl "https://api.0xarchive.io/v1/hyperliquid/orderbook/BTC" \
  -H "X-API-Key: $OXARCHIVE_API_KEY"
```

Once this returns a book and `meta.request_id`, add history, funding, open interest, or L4 for the same symbol.

## Route groups

Core routes cover current and historical market state:

* [Order books](/rest-api/order-books): current and historical depth, from native L2 to L4.
* [Trades](/rest-api/trades): fill-level rows with per-trade wallet attribution. The [Hyperliquid Fills Data API](/hyperliquid-fills-data-api) page maps fills questions to the right routes.
* [Candles](/rest-api/candles), [Funding](/rest-api/funding), and [Open interest](/rest-api/open-interest): time series for each perp.
* [Order history](/rest-api/order-history), [Order flow](/rest-api/order-flow), and [Take profits and stop losses](/rest-api/tpsl): order lifecycle.

Exact methods and parameters for every core route are in the [Hyperliquid endpoint reference](/api-reference/hyperliquid).

## Breadth above session VWAP

`/v1/hyperliquid/breadth/above-vwap/current` returns the latest core-perps snapshot and `/v1/hyperliquid/breadth/above-vwap` returns history. Each snapshot measures the percent of eligible core perps above their UTC-session VWAP, not a per-symbol VWAP.

[Market breadth](/rest-api/breadth) covers eligibility, null values, pagination, and history from August 24, 2026, including recomputed pre-launch values. HIP-3 has a separate breadth series; neither series includes Spot or HIP-4.

## Store what makes a pull reproducible

For backtests, store the route, query parameters, time window, cursor, and `request_id` for each page. Check the same window with the `/v1/data-quality/*` routes so downstream users know whether it was complete and fresh enough to trust.

These routes serve market data only. Execution, wallet signing, and venue account actions are outside them.

## Next step

Check that a window is complete before a long pull with [Data quality](/data-quality).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.