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.

Website

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

cURL

1curl 'https://token-api.service.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 spot-discovery filters: ?base_token=HYPE returns every spot pair where HYPE sits on the base side (HYPE/USDC, HYPE/USDT0, …). Use the coin from the result as the identifier on the rest of the /v1/hyperliquid/* endpoints.

GET

https://token-api.service.pinax.network/v1/hyperliquid/markets

Optional parameters

Name	Type	Description
coin query	string	Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`). e.g. BTC
dex query	string	DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set.
base_token query	string	Spot token symbol (e.g. `HYPE`, `USDC`). Use to discover all spot pairs with this token on a given side via `/v1/hyperliquid/markets?base_token=...` or `?quote_token=...`.
quote_token query	string	Spot token symbol (e.g. `HYPE`, `USDC`). Use to discover all spot pairs with this token on a given side via `/v1/hyperliquid/markets?base_token=...` or `?quote_token=...`.
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",
      "price": 75944,
      "price_24h": 76765,
      "price_24h_change": -0.010695,
      "volume_24h": 2322418448.58,
      "buy_volume_24h": 1216305333.99,
      "ask_volume_24h": 1106113114.59,
      "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",
      "price": 22.41,
      "price_24h": 22.85,
      "price_24h_change": -0.01926,
      "volume_24h": 18452113.47,
      "buy_volume_24h": 9381102.5,
      "ask_volume_24h": 9071010.97,
      "trades_24h": 28412,
      "unique_users_24h": 1267,
      "open_interest": null,
      "funding_rate": null,
      "funding_snapshot_time": null
    }
  ]
}