Hyperliquid perpetual exchange data endpoints, plus API documentation and monitoring.

Read-only preview

You're browsing the public OpenAPI spec. Sign in to send live requests with your team's API key.

Quickstart

Preview Hyperliquid fills through the market activity feed. Start with BTC fills, then swap in any supported coin, DEX, or user address from the endpoint catalog below.

Guide

Website

No API key on this team yet — sample shows <YOUR_JWT> placeholder.

1curl 'https://api.pinax.network/v1/hyperliquid/markets/activity?coin=BTC&limit=10&page=1' \
2  -H 'Authorization: Bearer <YOUR_JWT>' \
3  -H 'Accept: application/json'

Hyperliquid Markets

Market Lookup

FREEPREVIEW

Returns the latest snapshot per market: last trade price, 24h change versus the prior-day close, 24h volume (split by side), trade and unique-user counts, and the most recent open interest and funding rate observed at the last funding snapshot.

Filters compose additively. Pass coin, dex, base_token, and/or quote_token to narrow the scope. A mismatched combination (e.g. coin=cash:TSLA&dex=xyz) returns empty. Omit all for a full listing sorted by 24h volume.

base_token and quote_token are discovery filters across spot and perp markets: ?base_token=HYPE returns every market with HYPE on the base side. Use the coin from the result as the identifier on the rest of the /v1/hyperliquid/* endpoints.

GET

https://api.pinax.network/v1/hyperliquid/markets

Optional parameters

Name	Type	Description
coin query	string	Hyperliquid coin id. Perps: `BTC`. Spot: `@N` (`@107`). Builder DEXs: `xyz:SILVER`. Outcome coins (`#N`) are rejected — use `/v1/hyperliquid/outcomes/`. Single value or array of values (separate multiple values with `,`) *Plan restricted. e.g. BTC
dex query	Enum · 9	DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (`xyz`, `cash`, …). Outcome markets are served separately under `/v1/hyperliquid/outcomes/`. Single value or array of values (separate multiple values with `,`) *Plan restricted. perpsspotxyzcashkmhynaflxvntlpara
base_token query	string	Token symbol (e.g. `HYPE`, `USDC`, `BTC`). Use to discover markets with this token on a given side via `/v1/hyperliquid/markets?base_token=...` or `?quote_token=...`. Single value or array of values* (separate multiple values with `,`) *Plan restricted.
quote_token query	string	Token symbol (e.g. `HYPE`, `USDC`, `BTC`). Use to discover markets with this token on a given side via `/v1/hyperliquid/markets?base_token=...` or `?quote_token=...`. Single value or array of values* (separate multiple values with `,`) *Plan restricted.
limit query	integer	Number of items* returned in a single request. *Plan restricted.
page query	integer	Page number to fetch. Empty `data` array signifies end of results.

Response

200 OK

{
  "data": [
    {
      "coin": "BTC",
      "market_name": "BTC",
      "dex": "perps",
      "base_token": "BTC",
      "quote_token": "USDC",
      "price": 75944,
      "price_24h": 76765,
      "price_24h_change": -0.010695,
      "volume_24h": 2322418448.58,
      "buy_volume_24h": 1106113114.59,
      "sell_volume_24h": 1216305333.99,
      "trades_24h": 454294,
      "unique_users_24h": 4581,
      "open_interest": 27608.56,
      "funding_rate": 0.0000037749,
      "funding_snapshot_time": "2026-04-28 15:00:00"
    },
    {
      "coin": "@107",
      "market_name": "HYPE/USDC",
      "dex": "spot",
      "base_token": "HYPE",
      "quote_token": "USDC",
      "price": 22.41,
      "price_24h": 22.85,
      "price_24h_change": -0.01926,
      "volume_24h": 18452113.47,
      "buy_volume_24h": 9071010.97,
      "sell_volume_24h": 9381102.5,
      "trades_24h": 28412,
      "unique_users_24h": 1267,
      "open_interest": null,
      "funding_rate": null,
      "funding_snapshot_time": null
    }
  ]
}