Skip to main content
GET
Perps - Token List
  • Returns supported perpetual markets on Hyperliquid with ranking-style market metrics.
  • Use list filters and sorting to narrow the market set before drilling into one token.
  • This endpoint is market discovery for perp tokens, not a candle, trade, or wallet-position feed.
  • Values are perp-market fields and should not be mixed directly with spot token analytics without normalization.
  • This endpoint consumes 10 CU per request.
  • Discover supported perp markets before loading deeper token-level analytics.
  • Build ranked derivatives boards for open interest, directional bias, leverage, and participation.
  • Feed market screeners that separate perp market structure from spot market activity.
  • Find candidate markets for liquidation monitoring, position analysis, or trader tracking.
  • Start here when you need the available Hyperliquid perp token universe.
  • Apply supported sorting and filtering params to rank the markets you care about.
  • Take the returned token identifier into Perps Token Overview, Perps Token Open Positions, or Perps Token Liquidation Map.
  • Use this endpoint as the first step in a perp workflow, then drill into one market with the token detail endpoints.
  • Keep spot and perp dashboards separated unless you explicitly label and reconcile the metric definitions.
  • Cache ranked lists briefly and refresh detail endpoints more aggressively for active monitoring flows.

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

time_frame
enum<string>
default:all
Available options:
4h,
1d,
7d,
30d,
all
sort_by
enum<string>
default:open_interest
Available options:
long_io,
short_io,
open_interest
sort_type
enum<string>
default:desc

Specify the sort order.

Available options:
desc,
asc
offset
integer
default:0

Specify the offset for pagination. Filter for records with offset greater than the specified offset value, including those with offset equal to the specified offset.

limit
integer
default:10

Number of items per page.

Required range: 1 <= x <= 20

Response

JSON object containing a list of tokens with certain fields

success
boolean
required

Whether the request succeeded.

data
object[]
required

Perpetual markets ranked by the requested sort metric and time frame.