Perpetual

The perpetual Market API provides comprehensive access to spot trading data from Hyperliquid, including market data, statistics, and auction information. All endpoints are protected by rate limiting and include comprehensive error handling.

Rate Limit Considerations

• Market Data: 1 request per 10 seconds recommended

• Global Stats: 1 request per minute recommended

• Bulk Operations: Use pagination to avoid rate limits

Market data

GET https://liquidterminal.up.railway.app/market/perp

Retrieves paginated perpetual market data with filtering and sorting capabilities.

Query parameters

Parameter	Type	Required	Default	Description
sortBy	string	No	volume	Sort criteria: volume, openInterest, change24h
sortOrder	string	No	desc	Sort order: asc, desc
limit	number	No	20	Number of items per page (1-1000)
page	number	No	1	Page number (starts from 1)
token	string	No	-	Filter by token name
pair	string	No	-	Filter by pair name

Response

200

{
  "success": true,
  "message": "Perp market data retrieved successfully",
  "data": [
    {
      "index": 0,
      "name": "BTC",
      "logo": "https://app.hyperliquid.xyz/coins/BTC.svg",
      "price": 45000.50,
      "change24h": 2.5,
      "volume": 1500000000,
      "openInterest": 2500000000,
      "funding": 0.0001,
      "maxLeverage": 100,
      "onlyIsolated": false
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8,
    "hasNext": true,
    "hasPrevious": false
  },
  "metadata": {
    "totalVolume": 5000000000
  }
}

Global Statistics

GET https://liquidterminal.up.railway.app/market/perp/globalstats

Retrieves global perpetual market statistics including total volume, open interest, and vault TVL.

Response

200

{
  "totalOpenInterest": 50000000000,
  "totalVolume24h": 15000000000,
  "totalPairs": 50,
  "hlpTvl": 2500000000
}