# 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 | No       | API authentication key            |
| 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>
```


---

# 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/products/api-endpoints/trading-intelligence/perp-intelligence.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.