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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dapplooker.com/data-apis-for-ai/api-endpoints/hyperliquid-perp-trade-token-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.