Skip to main content
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. For TWAP execution research, /v1/hyperliquid/twap/{symbol} returns order-status events for one market, and /v1/hyperliquid/twap/user/{user} returns one wallet’s events: size, executed size and notional, duration, and trigger settings. Events include activated, waiting-for-trigger, finished, terminated, stopped, and error states. Check the route’s captured history before treating an empty window as no TWAP activity. Read wallet trading behavior with /v1/hyperliquid/wallets/{address}/profile: order mix, cancel speed, maker share, fees, realized PnL, liquidations, and TWAP and builder usage. Without a coin filter, the profile aggregates every overlapping UTC day in full; with coin, the requested window is exact. This is venue trading behavior, not a general onchain wallet indexer. 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

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: Exact methods and parameters for every core route are in the Hyperliquid endpoint reference.

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

Datasets on the Build plan and above

Four core datasets come with the Build, Pro, Scale and Enterprise plans; a Free key receives 403 forbidden on them:
  • Trade intent: /v1/hyperliquid/trade-intent/{symbol}, why a market’s volume traded and what its winners and losers are doing.
  • USDC flows: /v1/hyperliquid/usdc-flows and /v1/hyperliquid/usdc-flows/volume, every USDC deposit, withdrawal and HyperEVM transfer, exchange-wide.
  • Breadth above the moving average: /v1/hyperliquid/breadth/above-ma and /current, the share of core perps above their n-day moving average.
  • Positioning: /v1/hyperliquid/positioning, every listed perp over a trailing window in one response.

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

Last modified on November 4, 2026