# Hyperliquid Perp Trade Token Data

### Supported Markets

* Perps
* HIP-3
* TradFi
* HIP-4 (coming soon)

### **Endpoint**

<mark style="color:yellow;">**GET**</mark> <mark style="color:orange;">`https://api.dapplooker.com/v1/hl-perp-trade`</mark>

> #### 💡 Pro **Tips**&#x20;
>
> * 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.
> * This endpoint is **x402 payment–enabled**, opening access for all users — simply **pay and use** without needing an API key.

### **Authentication**

This endpoint supports **two authentication methods**:

<table data-header-hidden><thead><tr><th width="254.30078125"></th><th></th></tr></thead><tbody><tr><td><strong>Method</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>API Key</strong></td><td>Provide your Loky API key using the <mark style="color:orange;"><code>api_key</code></mark> parameter for authenticated access.</td></tr><tr><td><strong>x402 Payment Protocol</strong></td><td>If <mark style="color:orange;"><code>api_key</code></mark> is not provided, the request automatically uses the <a href="https://x402.gitbook.io/x402">x402 protocol</a> for on-chain payment verification.</td></tr></tbody></table>

For seamless integration, user can follow the [**x402 Quickstart Guide for Buyers**](https://x402.gitbook.io/x402/getting-started/quickstart-for-buyers).

### **Query Parameters**

<table data-header-hidden><thead><tr><th width="153.40625"></th><th width="108.828125"></th><th width="153.64453125"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td><strong>Type</strong></td><td><strong>Mandatory</strong></td><td><strong>Description</strong></td></tr><tr><td><mark style="color:orange;"><code>api_key</code></mark></td><td>string</td><td>No</td><td>Your unique API key used for authentication</td></tr><tr><td><mark style="color:orange;"><code>token_ticker</code></mark></td><td>string</td><td>Yes</td><td>Ticker symbol of the token (e.g., <code>ETH</code>)</td></tr></tbody></table>

### Example **Request**

{% code overflow="wrap" %}

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

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

{% endcode %}

### Example **Response**

<details>

<summary>Default Response Example</summary>

```json
{
  "success": true,
  "data": {
    "symbol": "BTC/USDC:USDC",
    "base": "BTC",
    "quote": "USDC",
    "mark_price": 70328,
    "mid_price": 70325.5,
    "price_change_24h": 2439,
    "price_change_percent_24h": 3.5950120866,
    "bid_ask_spread": 1,
    "bid_ask_spread_percentage_mark": 0.00142378142107624,
    "bid_liquidity_0_25_percentage": 1862227.18118,
    "ask_liquidity_0_25_percentage": 9716191.94333,
    "total_liquidity_0_25_percentage": 11578419.12451,
    "order_book_imbalance_percentage": -0.678257686632019,
    "open_interest": {
      "usd_value": 1709979166.54672,
      "change_percentage_1h": -0.11,
      "change_percentage_6h": -2.86,
      "change_percentage_24h": -3.31
    },
    "funding_rate": {
      "current_value": 0.0000087159,
      "next": 0.0000040497,
      "trajectory": [0.0000040513, 0.000001898, -0.0000024235, -5.253e-7]
    },
    "obv": {
      "1h": 34936.34983,
      "4h": 18660.49365,
      "1d": 116453.76217
    },
    "rsi": {
      "15m": 47.0366886171,
      "1h": 53.786407767,
      "4h": 60.4108172011
    },
    "atr": {
      "15m": 172.9285714286,
      "1h": 453.2857142857,
      "4h": 1212.2857142857,
      "percentage_15m": 0.25,
      "percentage_1h": 0.64,
      "percentage_4h": 1.72
    },
    "swing": {
      "high_4h": 71785,
      "low_4h": 67889
    },
    "adx": {
      "1h": 25.72,
      "4h": 25.74
    },
    "macd_line_slope": {
      "15m": {
        "macd_line": -97.2873190311657,
        "signal_line": -90.3227141327218,
        "histogram": -6.96460489844391
      },
      "1h": {
        "macd_line": 477.763211444515,
        "signal_line": 667.848932616475,
        "histogram": -190.08572117196
      },
      "4h": {
        "macd_line": -199.678254977684,
        "signal_line": -518.182434118152,
        "histogram": 318.504179140469
      }
    },
    "vwap": {
      "1m": 70590.042245,
      "5m": 70587.795698,
      "15m": 70294.623302,
      "1h": 71164.542594,
      "4h": 71120.817607,
      "1d": 71104.416399
    },
    "ema": {
      "20_distance_percentage": 0.02,
      "200_distance_percentage": -0.06
    },
    "bollinger": {
      "band_width": 0.034539,
      "upper_band": 71788.570688,
      "lower_band": 69351.129312,
      "middle_band": 70569.85
    }
  }
}
```

</details>

<details>

<summary>HIP-3 Response Example</summary>

```json
{
  "success": true,
  "data": [
    {
      "CASH-AMZN": {
        "symbol": "CASH-AMZN/USDT0:USDT0",
        "base": "CASH-AMZN",
        "quote": "USDT0",
        "mark_price": 208.508,
        "mid_price": 208.535,
        "price_change_24h": 4.75,
        "price_change_percent_24h": 2.3303733503,
        "bid_ask_spread": 0.01,
        "bid_ask_spread_percentage_mark": 0.00479420859601165,
        "bid_liquidity_0_25_percentage": 637181.64105,
        "ask_liquidity_0_25_percentage": 695523.56659,
        "total_liquidity_0_25_percentage": 1332705.20764,
        "order_book_imbalance_percentage": -0.043088556583517,
        "open_interest": {
          "usd_value": 1037374.422808,
          "change_percentage_1h": null,
          "change_percentage_6h": null,
          "change_percentage_24h": null
        },
        "funding_rate": {
          "current_value": 0.0000043287,
          "next": null,
          "trajectory": [0.00000625, 0.00000625, 0.00000625, 0.00000625]
        },
        "obv": {
          "1h": -7285.333,
          "4h": -26890.126,
          "1d": -76120.512
        },
        "rsi": {
          "15m": 41.6267942584,
          "1h": 23.4323432343,
          "4h": 54.8481308411
        },
        "atr": {
          "15m": 0.2428571429,
          "1h": 0.8907142857,
          "4h": 2.0164285714,
          "percentage_15m": 0.12,
          "percentage_1h": 0.43,
          "percentage_4h": 0.97
        },
        "swing": {
          "high_4h": 212.82,
          "low_4h": 202.09
        },
        "adx": {
          "1h": 35.19,
          "4h": 25.81
        },
        "macd_line_slope": {
          "15m": {
            "macd_line": -0.437361125975826,
            "signal_line": -0.518556036858035,
            "histogram": 0.0811949108822087
          },
          "1h": {
            "macd_line": 0.80705507487221,
            "signal_line": 1.25504867317206,
            "histogram": -0.447993598299849
          },
          "4h": {
            "macd_line": -0.273805613396405,
            "signal_line": -0.874248637054625,
            "histogram": 0.60044302365822
          }
        },
        "vwap": {
          "1m": 208.910613,
          "5m": 208.907851,
          "15m": 210.100601,
          "1h": 210.1088,
          "4h": 209.98901,
          "1d": 210.017544
        },
        "ema": {
          "20_distance_percentage": -0.12,
          "200_distance_percentage": 0.05
        },
        "bollinger": {
          "band_width": 0.049849,
          "upper_band": 214.580718,
          "lower_band": 204.144282,
          "middle_band": 209.3625
        }
      }
    }
    {...}
  ]
}
```

</details>

### **Response Fields Explanation**

* <mark style="color:orange;">`symbol`</mark> (string): Trading pair symbol for the perpetual contract (e.g., ETH/USDC:USDC).
* <mark style="color:orange;">`base`</mark> (string): The base token of the trading pair (e.g., ETH).
* <mark style="color:orange;">`quote`</mark> (string): The quote token of the trading pair (e.g., USDC).
* <mark style="color:orange;">`mark_price`</mark> (number): The latest fair value price used for liquidation and funding calculations.
* <mark style="color:orange;">`mid_price`</mark> (number): The mid-point between the current highest bid and lowest ask.
* <mark style="color:orange;">`price_change_24h`</mark> (number): Absolute price change over the last 24 hours.
* <mark style="color:orange;">`price_change_percent_24h`</mark> (number): Percentage price change over the last 24 hours.
* <mark style="color:orange;">`bid_ask_spread`</mark> (number): The difference between the highest bid and lowest ask.
* <mark style="color:orange;">`bid_ask_spread_percentage_mark`</mark> (number): Spread as a percentage of the mark price.
* <mark style="color:orange;">`bid_liquidity_0_25_percentage`</mark> (number): Total bid-side liquidity within ±0.25% of mark price.
* <mark style="color:orange;">`ask_liquidity_0_25_percentage`</mark> (number): Total ask-side liquidity within ±0.25% of mark price.
* <mark style="color:orange;">`total_liquidity_0_25_percentage`</mark> (number): Combined bid + ask liquidity within ±0.25% of mark price.
* <mark style="color:orange;">`order_book_imbalance_percentage`</mark> (number): Imbalance ratio between bid and ask liquidity.
* <mark style="color:orange;">`open_interest`</mark> (object): Current open positions in the contract.
  * <mark style="color:orange;">usd\_value</mark> (number): Total USD value of open interest.
  * <mark style="color:orange;">change\_percentage\_1h / 6h / 24h</mark> (number): Percentage change in open interest over time.
* <mark style="color:orange;">`funding_rate`</mark> (object): Funding rate details for perpetuals.
  * <mark style="color:orange;">current\_value</mark> (number): Current funding rate.
  * <mark style="color:orange;">next</mark> (number): Projected next funding rate.
  * <mark style="color:orange;">trajectory</mark> (array): Forecast of upcoming funding rate values.
* <mark style="color:orange;">`obv`</mark> (object): On-balance volume values for 14 days.
  * <mark style="color:orange;">15m / 1h / 4h</mark> (number): OBV readings across multiple timeframes.
* <mark style="color:orange;">`rsi`</mark> (object): Relative Strength Index values.
  * <mark style="color:orange;">15m / 1h / 4h</mark> (number): RSI readings across multiple timeframes.
* <mark style="color:orange;">`atr`</mark> (object): Average True Range (volatility indicator).
  * <mark style="color:orange;">15m / 1h / 4h</mark> (number): ATR values for different timeframes.
  * <mark style="color:orange;">percentage\_15m / 1h / 4h</mark> (number): ATR expressed as percentage of price.
* <mark style="color:orange;">`swing`</mark> (object): Recent price swing points.
  * <mark style="color:orange;">high\_4h</mark> (number): Highest price in last 4 hours.
  * <mark style="color:orange;">low\_4h</mark> (number): Lowest price in last 4 hours.
* <mark style="color:orange;">`adx`</mark> (object): Average Directional Index values for trend strength.
  * <mark style="color:orange;">1h / 4h</mark> (number): ADX readings across timeframes.
* <mark style="color:orange;">`macd_line_slope`</mark> (object): MACD trend indicator data.
  * <mark style="color:orange;">15m / 1h / 4h</mark> (object): Includes `macd_line`, `signal_line`, and `histogram`.
* <mark style="color:orange;">`vwap`</mark> (object): Volume-Weighted Average Price across intervals (1m, 5m, 15m, 1h, 4h, 1d).
* <mark style="color:orange;">`ema`</mark> (object): Exponential Moving Average distances.
  * <mark style="color:orange;">20\_distance\_percentage / 200\_distance\_percentage</mark> (number): Price distance from EMA(20) and EMA(200).
* <mark style="color:orange;">`bollinger`</mark> (object): Bollinger Bands data.
  * <mark style="color:orange;">band\_width</mark> (number): Width between upper and lower bands.
  * <mark style="color:orange;">upper\_band / lower\_band / middle\_band</mark> (number): Bollinger Band levels.