HyperLiquid

Perp Exchange

Production-grade HyperLiquid data — markets, OHLC, open interest, liquidations, prediction-market outcomes, vaults and per-user activity — through a single HTTP API.

Power perps trading agents, copy-trading apps, leaderboards and risk dashboards with on-chain HyperCore data enriched with HyperLiquid orderbook metadata. Part of Pinax API.

  • ✓Read-only REST endpoints covering markets, OHLC, OI, activity, liquidations, HIP-4 outcomes, users, positions, vaults and platform aggregates
  • ✓Native HyperCore events enriched with perpetual orderbook + funding metadata
Get API access📊 See more Stats! →HyperLiquid Website →

What you get with the Perp Exchange API

20 REST endpoints

DEXes, markets, OHLC, OI, activity, liquidations, outcomes, users, positions, vaults, platform

HyperCore native

Trades, funding, splits, redemptions, liquidations — at the tx level

Per-user PNL

Realized + unrealized P&L, leverage, margin, position health

Sub-minute refresh

Aggregated leaderboards and platform stats updated continuously

// 11 · Sample responses

How teams use it

Three patterns we see most often. Each uses a small subset of the endpoints — you can mix them as needed.

01 · BACKTEST

Replay perpetual OHLC

Replay historical bar-by-bar price action per market and stress-test perp strategies against real funding and liquidity events.

Sample response200 OK
[
  {
    "timestamp": "2026-05-07 14:00:00",
    "open": 68412.5,
    "high": 68702.1,
    "low": 68198,
    "close": 68631.4,
    "volume": 142308442.18,
    "trades": 38214,
    "buys": 21118,
    "sells": 17096,
    "unique_takers": 4218,
    "funding_rate": 0.0000091,
    "open_interest": 684120341.55,
    "market": {
      "dex": "hyperliquid",
      "symbol": "BTC-PERP",
      "asset_id": 0,
      "max_leverage": 50,
      "closed": false
    }
  }
]

02 · COPY TRADING

Stream user activity

Watch top traders from the user leaderboard and mirror entries, exits and liquidation events with block-level timing.

Sample response200 OK
[
  {
    "event_type": "trade",
    "timestamp": "2026-05-07 14:38:11",
    "block_num": 85014327,
    "tx_hash": "0xf190865afd395e2f4b8f2e5f8ceb2c05a86d94a73ea411e8a8a3fc649924c420",
    "user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
    "side": "long",
    "action": "open",
    "size": 28.1,
    "price": 68412.5,
    "notional": 1922391.25,
    "leverage": 25,
    "fee": 576.72,
    "liquidation": false,
    "market": {
      "dex": "hyperliquid",
      "symbol": "BTC-PERP",
      "asset_id": 0
    }
  }
]

03 · PORTFOLIO

Per-user positions & P&L

Build wallet dashboards and risk monitors that show what a user holds across every HyperLiquid market — with cost basis, leverage and liquidation price.

Sample response200 OK
[
  {
    "user": "0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a",
    "market": {
      "dex": "hyperliquid",
      "symbol": "HYPE-PERP"
    },
    "side": "long",
    "size": 412000,
    "entry_price": 1.812,
    "mark_price": 2.184,
    "liq_price": 1.486,
    "leverage": 10,
    "margin_mode": "isolated",
    "margin_used": 74654.4,
    "unrealized_pnl": 153264,
    "realized_pnl": -21184.5,
    "funding_paid": -1284.18,
    "position_value": 899808,
    "updated_at": "2026-05-07 14:39:02"
  }
]

REST endpoints

See official docs: https://app.pinax.network/docs/perp-exchanges

DEXes

1 endpoint
GET/v1/hyperliquid/dexesList supported HyperLiquid + HyperCore perp dexes with backfill range and 24h notional.

Markets

6 endpoints
GET/v1/hyperliquid/marketsMarket lookup by symbol, asset_id, or dex. Discovery mode with sort / filter.
FREE
GET/v1/hyperliquid/markets/ohlcOHLCV + funding per market. Mark price in USD, USDC for volume and fees.
GET/v1/hyperliquid/markets/oiOpen-interest time-series with long/short split per market.
GET/v1/hyperliquid/markets/activityTrades, opens, closes and funding settlements in chronological order.
GET/v1/hyperliquid/markets/liquidationsLiquidation events with side, leverage, mark price and notional.
GET/v1/hyperliquid/markets/liquidations/ohlcBucketed liquidation OHLC — long-side and short-side notional aggregated per interval.

Outcomes (Prediction Markets)

6 endpoints
GET/v1/hyperliquid/outcomesHIP-4 outcome markets with metadata and 24h rollup. Each trades as two side coins (Yes/No or custom labels).
GET/v1/hyperliquid/outcomes/ohlcOHLCV candles per outcome leg. Query by coin or outcome_id with a yes/no side selector.
GET/v1/hyperliquid/outcomes/tradesChronological fill feed for outcome markets — price, size, side and trade direction.
GET/v1/hyperliquid/outcomes/usersPer-user trading aggregates per outcome, with both side legs collapsed into one row.
GET/v1/hyperliquid/outcomes/users/activityComposition-event feed for outcome positions — settlements, splits and merges per leg.
GET/v1/hyperliquid/outcomes/users/positionsCurrent open share balance per outcome leg, derived from the full fill history.

Users

3 endpoints
GET/v1/hyperliquid/usersUser discovery and lookup with volume / PNL / leverage / liquidation counts.
GET/v1/hyperliquid/users/positionsOpen positions with entry, mark, liq price and isolated/cross margin breakdown.
GET/v1/hyperliquid/users/activityPer-user trade, funding and liquidation feed across every market.

Vaults

2 endpoints
GET/v1/hyperliquid/vaultsHLP and community vaults with TVL, 24h PNL, leader address and follower count.
GET/v1/hyperliquid/vaults/depositorsDepositor leaderboard per vault with cost basis, equity and realized PNL.

Platform

1 endpoint
GET/v1/hyperliquid/platformPlatform-wide volume, open interest, fees, funding and liquidation aggregates.

How it works

Same pattern as the rest of the Pinax API — issue an API key, hit the endpoint, parse the JSON.

1

Request API credentials from Pinax

2

Pick the endpoint for your use case

3

Call it from your app, notebook, or MCP client

4

Ship your strategy, dashboard, or agent

Frequently Asked Questions

Same data, one endpoint.

Markets, OHLC, OI, liquidations, users, vaults — all under /v1/hyperliquid/*. Free tier starts at 100 req/s.

Get API key →Read the docsHyperLiquid Website →

Join Our Newsletter

Signup today to learn about our beta programs for your chain.