Skip to main content
GET
Perps - Token Overview
  • Returns a token-level perpetual market snapshot for one Hyperliquid market.
  • Use this endpoint for current market structure such as price, open interest, position count, and liquidation context.
  • This is a summarized market view, not a row-by-row position ledger.
  • Join with open-positions or liquidation-map endpoints when you need participant-level or price-bucket detail.
  • This endpoint consumes 5 CU per request.
  • Show a perp market summary card with price, open interest, and positioning context.
  • Compare one market’s current structure before and after large moves or liquidation waves.
  • Power derivatives research pages that summarize crowding, exposure, and recent market state.
  • Provide a quick market-health view before loading heavier position-level data.
  • Pass the target Hyperliquid perp token identifier.
  • Read this overview first to decide whether you need position inventory or liquidation clustering next.
  • Follow with Perps Token Open Positions for wallet-level exposure or Perps Token Liquidation Map for liquidation concentration.
  • Use this endpoint for the fast summary layer in dashboards, then lazy-load heavier detail endpoints on demand.
  • Keep a clear distinction between current snapshot fields and time-series or execution data from other surfaces.
  • Pair it with wallet-side perp endpoints when you need both market state and participant attribution.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-perp
enum<string>
default:hyperliquid

Specify the perpetuals exchange. Currently supports hyperliquid.

Available options:
hyperliquid

Query Parameters

token
string
required

The symbol of a coin/token (e.g: BTC, SOL, ETH).

Response

JSON object containing overview information of a token

success
boolean
required

Whether the request succeeded.

data
object
required