Spot

The spot 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

Spot Market Data

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

Retrieves paginated spot market data with filtering and sorting capabilities.

Headers

Name	Value
Content-Type	application/json

Query Parameters

Parameter	Type	Required	Default	Description
sortBy	string	No	volume	Sort criteria: volume, marketCap, 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": "Market data retrieved successfully",
  "data": [
    {
      "name": "BTC",
      "logo": "https://app.hyperliquid.xyz/coins/BTC_USDC.svg",
      "price": 45000.50,
      "marketCap": 900000000000,
      "volume": 1500000000,
      "change24h": 2.5,
      "liquidity": 44950.25,
      "supply": 20000000,
      "marketIndex": 1,
      "tokenId": "btc-token-id"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 150,
    "totalPages": 15,
    "hasNext": true,
    "hasPrev": false
  }
}

Tokens Without Pairs

GET https://liquidterminal.up.railway.app/market/spot/token-without-pairs

Retrieves a list of tokens that don't have active trading pairs.

Response

200

{
  "success": true,
  "message": "Tokens without pairs retrieved successfully",
  "data": [
    "TOKEN1",
    "TOKEN2",
    "TOKEN3"
  ]
}

Global Statistics

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

Retrieves global spot market statistics including total volume, market cap, and pair counts.

Response

200

{
  "totalVolume24h": 5000000000,
  "totalMarketCap": 100000000000,
  "totalPairs": 150,
  "totalSpotUSDC": 25000000000,
  "totalHIP2": 1000000000
}

Auction data

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

Retrieves comprehensive auction data including USDC and HYPE auctions.

Query parameters

Parameter	Type	Required	Default	Description
status	string	No	-	Filter by status: active, completed, upcoming
token	string	No	-	Filter by token name

Response

200

{
  "success": true,
  "message": "Auction data retrieved successfully",
  "data": {
    "usdcAuctions": [
      {
        "token": "BTC",
        "startPrice": 45000,
        "currentPrice": 46000,
        "endPrice": 47000,
        "startTime": "2024-01-01T00:00:00Z",
        "endTime": "2024-01-02T00:00:00Z",
        "status": "active",
        "totalBids": 150,
        "totalUsdcSpent": 5000000
      }
    ],
    "hypeAuctions": [
      {
        "token": "ETH",
        "startPrice": 3000,
        "currentPrice": 3100,
        "endPrice": 3200,
        "startTime": "2024-01-01T00:00:00Z",
        "endTime": "2024-01-02T00:00:00Z",
        "status": "active",
        "totalBids": 75,
        "totalHypeSpent": 1000000
      }
    ],
    "totalUsdcSpent": 5000000,
    "totalHypeSpent": 1000000
  }
}