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, OBV, ATR, MACD, VWAP) help with quick technical analysis and spotting momentum shifts.

  • 14-day OBV is great for gauging recent buy/sell pressure and confirming trend strength.

  • 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": 4497.9,
    "mid_price": 4497.85,
    "price_change_24h": -124.2,
    "price_change_percent_24h": -2.6872065601,
    "bid_ask_spread": 0.1,
    "bid_ask_spread_percentage_mark": 0.00222325974344391,
    "bid_liquidity_0_25_percentage": 14878337.51224,
    "ask_liquidity_0_25_percentage": 15286966.75474,
    "total_liquidity_0_25_percentage": 30165304.26698,
    "order_book_imbalance_percentage": -0.0133297449983543,
    "open_interest": {
      "usd_value": 3728304320.92932,
      "change_percentage_1h": -1.04,
      "change_percentage_6h": 0.47,
      "change_percentage_24h": 5.69
    },
    "funding_rate": {
      "current_value": 0.0000125,
      "next": 0.0000125,
      "trajectory": [0.0000125, 0.0000125, 0.0000125, 0.0000125]
    },
    "obv": {
      "1h": 128905.9304,
      "4h": 314119.7738,
      "1d": 1080978.0376
    },
    "rsi": {
      "15m": 42.9760665973,
      "1h": 21.9929542023,
      "4h": 43.2866316404
    },
    "atr": {
      "15m": 14.3785714286,
      "1h": 26.7285714286,
      "4h": 65.0857142857,
      "percentage_15m": 0.32,
      "percentage_1h": 0.59,
      "percentage_4h": 1.45
    },
    "swing": {
      "high_4h": 4637.5,
      "low_4h": 4489.5
    },
    "adx": {
      "1h": 23.15,
      "4h": 14.84
    },
    "macd_line_slope": {
      "15m": {
        "macd_line": -5.4088805216943,
        "signal_line": -3.99002320317883,
        "histogram": -1.41885731851547
      },
      "1h": {
        "macd_line": -22.4973640944672,
        "signal_line": -16.8357496872249,
        "histogram": -5.6616144072423
      },
      "4h": {
        "macd_line": -18.4810722690236,
        "signal_line": -21.3642324144121,
        "histogram": 2.88316014538858
      }
    },
    "vwap": {
      "1m": 4543.471238,
      "5m": 4543.312768,
      "15m": 4542.940152,
      "1h": 4543.463474,
      "4h": 4527.074638,
      "1d": 4453.423779
    },
    "ema": {
      "20_distance_percentage": -0.98,
      "200_distance_percentage": -0.37
    },
    "bollinger": {
      "band_width": 3.3236,
      "upper_band": 4628.972568,
      "lower_band": 4477.637432,
      "middle_band": 4553.305
    }
  }
}

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.

  • obv (object): On-balance volume values for 14 days.

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

  • 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.

Last updated

Was this helpful?