# Perp Data

> Ask Claude, ChatGPT, Grok or another agent for perpetual futures market data from Hyperliquid through Trade Echo MCP.

Source: https://tradeecho.com/docs/mcp/perp-data (updated 2026-11-14)

Trade Echo MCP now includes **perp data**: market data for perpetual futures on Hyperliquid, the venue Liquid trades on. Ask your assistant for quotes, funding, open interest, the order book, candles and market scans, for crypto perps and for stock perps such as `xyz:NVDA`.

> **Info: Data only**
>
> Perp data is for **paid members** and is **data only**. The perp tools cannot place orders, move funds or connect a wallet. They read market data and nothing else.

## What the six tools return

| Tool | What it returns |
|------|-----------------|
| `get_perp_quotes` | Quotes for up to 20 perps in one call: mark, mid, oracle, the gap between mark and oracle, 24-hour change, hourly and annualized funding, open interest, 24-hour volume, impact prices, max leverage and market status. |
| `get_perp_markets` | A list or search of the perp markets served, with symbol, market group, max leverage, status, mark price and 24-hour volume, largest volume first. |
| `get_perp_book` | The live order book for one perp: best bid and ask, spread in basis points, dollar depth over the top 5 and 10 levels, and up to 20 levels a side. |
| `get_perp_candles` | OHLCV candles for one perp (1m, 5m, 15m, 1h, 4h or 1d), plus ATR(14), ATR as a percent of price, range and the window VWAP, computed over closed bars. |
| `get_perp_funding` | Funding for one perp: the current hourly and annualized rate, the average over the window, hourly history, and the predicted next rate for crypto perps. Positive funding means longs pay shorts. |
| `scan_perps` | A ranked scan of the perp markets by 24-hour volume, funding (highest or most negative), 24-hour move (up or down) or open interest. It skips delisted and thin markets. |

Every quote row carries its **quote time**, its **age in seconds** and whether it is **live or delayed**, so your assistant can tell you how fresh a number is.

## Symbols

- **Crypto perps** use the bare symbol: `BTC`, `ETH`, `SOL`.
- **Stock perps** and other non-crypto markets use a market prefix: `xyz:NVDA`, `xyz:TSLA`. A stock perp is its own market with its own price. It is not the listed stock, and it can move while the stock market is closed, because these markets run around the clock.

## Who can use it

Paid members, on any connected client: Claude, ChatGPT, Grok, Meta AI, Cursor and the others on [Connect your client](https://tradeecho.com/docs/mcp/connect-clients). Perp data appears in the tool list on [Agent Connections](https://app.tradeecho.com/agent-connections) as **Perps Market Data**, a tool you pick on its own. It is not part of an access profile. Connections that already have **Futures Echo Map** reach the perp tools without reconnecting. If a connection without Futures Echo Map does not show them, pick **Perps Market Data** for it on Agent Connections.

Each call costs credits like the other tools. Credits per tool are in the [MCP tool reference](https://tradeecho.com/mcp/tools).

## Example prompts

```text
Using Trade Echo MCP, what is BTC funding on Hyperliquid right now? Is it positive or negative, and what is the 24-hour average?
```

```text
Pull quotes for BTC, ETH and SOL perps. Which has the highest open interest, and how far is mark from oracle on each?
```

```text
Scan the perp markets for the most negative funding with at least $5M of 24-hour volume.
```

```text
Show the order book for xyz:NVDA. What is the spread in basis points and how much depth sits in the top 10 levels?
```

```text
Get 1-hour candles for BTC perp over the last 100 bars. What is the ATR as a percent of price?
```

```text
Compare the xyz:NVDA perp with NVDA dealer levels from Trade Echo. Where is the perp trading relative to the call wall and the gamma flip?
```

## What it does not do

- It does not place orders, close positions or move funds. Perp data has no trading tools.
- It does not connect a wallet or ask for keys.
- It is not a recommendation. Use it the way you use the other intel tools: as research.

Perps and other leveraged products involve substantial risk, including the loss of your full amount. Not financial advice. Plans: https://tradeecho.com/pricing
