> For the complete documentation index, see [llms.txt](https://docs.dapplooker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dapplooker.com/products/api-endpoints/trading-intelligence/perp-intelligence.md).

# Perp Intelligence

### Real-Time Perpetual Market Data Across Leading DEXs

Track execution-grade perpetual market intelligence across multiple decentralized exchanges through one unified endpoint.

Supported venues include: Hyperliquid, Nado, Paradex, Pacifica, Avantis, Lighter, Aster, GRVT, Variational and Extended.

More venues added continuously.

***

### Supported Markets

* Crypto Perpetuals
* Tokenized Equities / RWA Perps
* Commodities Perps
* Index Markets
* Venue-Specific Synthetic Markets

***

## Endpoint

```bash
GET https://api.dapplooker.com/v1/perp-intelligence
```

***

## Why Use This Endpoint

Use one API to access real-time perp market data such as:

* Mark Price
* Mid Price
* Funding Rate
* Open Interest
* Orderbook Liquidity
* Spread Metrics
* Technical Indicators
* Multi-timeframe Momentum Signals

Ideal for:

* Trading bots
* AI agents
* Quant systems
* Smart routing engines
* Arbitrage systems
* Market dashboards

***

## Query Parameters

| Parameter     | Type   | Required | Description                                                                           |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------------- |
| api\_key      | string | Yes      | Your unique DappLooker API key used for authentication. Optional if querying via x402 |
| dex           | string | Yes      | Venue to query                                                                        |
| token\_ticker | string | Yes      | Token symbol (BTC, ETH, SOL etc.)                                                     |

***

## Supported DEX Values

```
hyperliquid
nado
paradex
pacifica
avantis
lighter
aster
grvt
variational
extended
```

***

## Example Requests

### Hyperliquid BTC

```bash
curl 'https://api.dapplooker.com/v1/perp-intelligence?api_key=YOUR_KEY&dex=hyperliquid&token_ticker=BTC'
```

### Nado ETH

```bash
curl 'https://api.dapplooker.com/v1/perp-intelligence?api_key=YOUR_KEY&dex=nado&token_ticker=ETH'
```

### Paradex SOL

```bash
curl 'https://api.dapplooker.com/v1/perp-intelligence?api_key=YOUR_KEY&dex=paradex&token_ticker=SOL'
```

### Avantis BTC

```bash
curl 'https://api.dapplooker.com/v1/perp-intelligence?api_key=YOUR_KEY&dex=avantis&token_ticker=BTC'
```

***

## Example Response

(JSON schema remains unchanged)

```json
{
  "success": true,
  "data": {
    "dex": "hyperliquid",
    "symbol": "BTC/USDC:USDC",
    "base": "BTC",
    "quote": "USDC",

    "mark_price": 70328,
    "mid_price": 70325.5,
    "price_change_24h": 2439,
    "price_change_percent_24h": 3.59,

    "bid_ask_spread": 1,
    "bid_ask_spread_percentage_mark": 0.0014,

    "bid_liquidity_0_25_percentage": 1862227.18,
    "ask_liquidity_0_25_percentage": 9716191.94,
    "total_liquidity_0_25_percentage": 11578419.12,
    "order_book_imbalance_percentage": -0.6783,

    "open_interest": {
      "usd_value": 1709979166.55,
      "change_percentage_1h": -0.11,
      "change_percentage_6h": -2.86,
      "change_percentage_24h": -3.31
    },

    "funding_rate": {
      "current_value": 0.0000087,
      "next": 0.0000040,
      "trajectory": [
        0.0000041,
        0.0000019,
        -0.0000024,
        -0.0000005
      ]
    },

    "obv": {
      "1h": 34936.35,
      "4h": 18660.49,
      "1d": 116453.76
    },

    "rsi": {
      "15m": 47.04,
      "1h": 53.79,
      "4h": 60.41
    },

    "atr": {
      "15m": 172.93,
      "1h": 453.29,
      "4h": 1212.29,
      "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.29,
        "signal_line": -90.32,
        "histogram": -6.96
      },
      "1h": {
        "macd_line": 477.76,
        "signal_line": 667.85,
        "histogram": -190.09
      },
      "4h": {
        "macd_line": -199.68,
        "signal_line": -518.18,
        "histogram": 318.50
      }
    },

    "vwap": {
      "1m": 70590.04,
      "5m": 70587.80,
      "15m": 70294.62,
      "1h": 71164.54,
      "4h": 71120.82,
      "1d": 71104.42
    },

    "ema": {
      "20_distance_percentage": 0.02,
      "200_distance_percentage": -0.06
    },

    "bollinger": {
      "band_width": 0.0345,
      "upper_band": 71788.57,
      "lower_band": 69351.13,
      "middle_band": 70569.85
    }
  }
}
```

***

## Response Schema

Response fields remain identical across all supported DEXs.

This allows builders to integrate once and switch venues without changing downstream parsing logic.

### Core Market Fields

| Field                       | Type   | Description                                    |
| --------------------------- | ------ | ---------------------------------------------- |
| symbol                      | string | Trading pair symbol (e.g. BTC/USDC:USDC)       |
| base                        | string | Base asset (e.g. BTC)                          |
| quote                       | string | Quote asset (e.g. USDC)                        |
| mark\_price                 | number | Fair value price used for funding/liquidations |
| mid\_price                  | number | Midpoint between best bid and ask              |
| price\_change\_24h          | number | Absolute 24h price move                        |
| price\_change\_percent\_24h | number | Percentage 24h price move                      |

### Liquidity & Orderbook

| Field                               | Type   | Description                         |
| ----------------------------------- | ------ | ----------------------------------- |
| bid\_ask\_spread                    | number | Difference between best bid and ask |
| bid\_ask\_spread\_percentage\_mark  | number | Spread as % of mark price           |
| bid\_liquidity\_0\_25\_percentage   | number | Bid liquidity within ±0.25%         |
| ask\_liquidity\_0\_25\_percentage   | number | Ask liquidity within ±0.25%         |
| total\_liquidity\_0\_25\_percentage | number | Combined liquidity within ±0.25%    |
| order\_book\_imbalance\_percentage  | number | Bid vs ask liquidity imbalance      |

### Open Interest

| Field                                  | Type   | Description             |
| -------------------------------------- | ------ | ----------------------- |
| open\_interest.usd\_value              | number | Total USD open interest |
| open\_interest.change\_percentage\_1h  | number | 1h OI change            |
| open\_interest.change\_percentage\_6h  | number | 6h OI change            |
| open\_interest.change\_percentage\_24h | number | 24h OI change           |

### Funding Rates

| Field                        | Type   | Description                   |
| ---------------------------- | ------ | ----------------------------- |
| funding\_rate.current\_value | number | Current funding rate          |
| funding\_rate.next           | number | Projected next funding        |
| funding\_rate.trajectory     | array  | Upcoming funding trend values |

### Momentum & Technical Indicators

| Field                         | Type   | Description                    |
| ----------------------------- | ------ | ------------------------------ |
| obv.1h / 4h / 1d              | number | On-balance volume by timeframe |
| rsi.15m / 1h / 4h             | number | RSI by timeframe               |
| atr.15m / 1h / 4h             | number | Average True Range             |
| atr.percentage\_\*            | number | ATR as % of price              |
| adx.1h / 4h                   | number | Trend strength indicator       |
| macd\_line\_slope.\*          | object | MACD line, signal, histogram   |
| ema.20\_distance\_percentage  | number | Distance from EMA(20)          |
| ema.200\_distance\_percentage | number | Distance from EMA(200)         |

### Price Structure

| Field                             | Type   | Description              |
| --------------------------------- | ------ | ------------------------ |
| swing.high\_4h                    | number | Highest price in last 4h |
| swing.low\_4h                     | number | Lowest price in last 4h  |
| vwap.1m / 5m / 15m / 1h / 4h / 1d | number | VWAP across intervals    |

### Bollinger Bands

| Field                  | Type   | Description         |
| ---------------------- | ------ | ------------------- |
| bollinger.band\_width  | number | Width between bands |
| bollinger.upper\_band  | number | Upper band level    |
| bollinger.lower\_band  | number | Lower band level    |
| bollinger.middle\_band | number | Mid band level      |

### Integration Note

Schema remains standardized across all supported DEXs via:

```
/v1/perp-intelligence?dex=<venue>&token_ticker=<symbol>
```