Hyperliquid Perp Trade Token Data

Provides real-time perpetual contract data for tokens on the Hyperliquid exchange. It returns live market prices, liquidity metrics, funding rates, and technical indicators to assist trading analysis.

Endpoint

GET https://api.dapplooker.com/v1/hl-perp-trade

💡 Pro Tips

• Use this endpoint to track real-time perp market data like price, funding rate, and open interest for any token on Hyperliquid.

• Built-in indicators (RSI, ATR, MACD, VWAP) help with quick technical analysis and spotting momentum shifts.

• Great for comparing perps vs. spot trends to catch early trading signals.

Query Parameters

Parameter name	Type	Mandatory	Description
api_key	string	Yes	Your unique API key used for authentication
token_ticker	string	Yes	Ticker symbol of the token (e.g., ETH)

Sample Request

# With Token Ticker
curl --location 'https://api.dapplooker.com/v1/hl-perp-trade?api_key=<API_KEY>&token_ticker=eth'

Sample Response

{
  "success": true,
  "data": {
    "symbol": "ETH/USDC:USDC",
    "base": "ETH",
    "quote": "USDC",
    "mark_price": 4248,
    "mid_price": 4247.85,
    "price_change_24h": -1.7,
    "price_change_percent_24h": -0.04,
    "bid_ask_spread": 0.1,
    "bid_ask_spread_percentage_mark": 0.002354,
    "bid_liquidity_0_25_percentage": 9833103.63,
    "ask_liquidity_0_25_percentage": 11531371.05,
    "total_liquidity_0_25_percentage": 21364474.68,
    "order_book_imbalance_percentage": -0.079192,
    "open_interest": {
      "usd_value": 3927450445.819202,
      "change_percentage_1h": -0.47,
      "change_percentage_6h": -6,
      "change_percentage_24h": -9.44
    },
    "funding_rate": {
      "current_value": 0.000013,
      "next": 0.000013,
      "trajectory": [
        0.0000024334,
        0.0000115418,
        0.0000125,
        0.0000125
      ]
    },
    "rsi": {
      "15m": 35.817157,
      "1h": 35.708029,
      "4h": 38.262277
    },
    "atr": {
      "15m": 24.635714,
      "1h": 51.235714,
      "4h": 99.528571,
      "percentage_15m": 0.58,
      "percentage_1h": 1.21,
      "percentage_4h": 2.34
    },
    "swing": {
      "high_4h": 4387,
      "low_4h": 4188.5
    },
    "adx": {
      "1h": 18.56,
      "4h": 28.79
    },
    "macd_line_slope": {
      "15m": {
        "macd_line": -27.590738320273886,
        "signal_line": -29.362669004597244,
        "histogram": 1.7719306843233582
      },
      "1h": {
        "macd_line": -40.941392689168424,
        "signal_line": -38.506049652216895,
        "histogram": -2.4353430369515294
      },
      "4h": {
        "macd_line": -89.78967579316395,
        "signal_line": -84.0061280076282,
        "histogram": -5.783547785535745
      }
    },
    "vwap": {
      "1m": 4259.789081,
      "5m": 4260.404762,
      "15m": 4260.553635,
      "1h": 4263.717661,
      "4h": 4405.003628,
      "1d": 4065.607237
    },
    "ema": {
      "20_distance_percentage": -1.38,
      "200_distance_percentage": -2.36
    },
    "bollinger": {
      "band_width": 4.0992,
      "upper_band": 4398.002056,
      "lower_band": 4221.337944,
      "middle_band": 4309.67
    }
  }
}

Response Fields Explanation

• symbol (string): Trading pair symbol for the perpetual contract (e.g., ETH/USDC:USDC).

• base (string): The base token of the trading pair (e.g., ETH).

• quote (string): The quote token of the trading pair (e.g., USDC).

• mark_price (number): The latest fair value price used for liquidation and funding calculations.

• mid_price (number): The mid-point between the current highest bid and lowest ask.

• price_change_24h (number): Absolute price change over the last 24 hours.

• price_change_percent_24h (number): Percentage price change over the last 24 hours.

• bid_ask_spread (number): The difference between the highest bid and lowest ask.

• bid_ask_spread_percentage_mark (number): Spread as a percentage of the mark price.

• bid_liquidity_0_25_percentage (number): Total bid-side liquidity within ±0.25% of mark price.

• ask_liquidity_0_25_percentage (number): Total ask-side liquidity within ±0.25% of mark price.

• total_liquidity_0_25_percentage (number): Combined bid + ask liquidity within ±0.25% of mark price.

• order_book_imbalance_percentage (number): Imbalance ratio between bid and ask liquidity.

• open_interest (object): Current open positions in the contract.

  • usd_value (number): Total USD value of open interest.

  • change_percentage_1h / 6h / 24h (number): Percentage change in open interest over time.

• funding_rate (object): Funding rate details for perpetuals.

  • current_value (number): Current funding rate.

  • next (number): Projected next funding rate.

  • trajectory (array): Forecast of upcoming funding rate values.

• rsi (object): Relative Strength Index values.

  • 15m / 1h / 4h (number): RSI readings across multiple timeframes.

• atr (object): Average True Range (volatility indicator).

  • 15m / 1h / 4h (number): ATR values for different timeframes.

  • percentage_15m / 1h / 4h (number): ATR expressed as percentage of price.

• swing (object): Recent price swing points.

  • high_4h (number): Highest price in last 4 hours.

  • low_4h (number): Lowest price in last 4 hours.

• adx (object): Average Directional Index values for trend strength.

  • 1h / 4h (number): ADX readings across timeframes.

• macd_line_slope (object): MACD trend indicator data.

  • 15m / 1h / 4h (object): Includes macd_line, signal_line, and histogram.

• vwap (object): Volume-Weighted Average Price across intervals (1m, 5m, 15m, 1h, 4h, 1d).

• ema (object): Exponential Moving Average distances.

  • 20_distance_percentage / 200_distance_percentage (number): Price distance from EMA(20) and EMA(200).

• bollinger (object): Bollinger Bands data.

  • band_width (number): Width between upper and lower bands.

  • upper_band / lower_band / middle_band (number): Bollinger Band levels.