---

title: Hyperliquid MCP Server & Trading Dashboard emoji: 📊 colorFrom: blue colorTo: green sdk: docker pinned: false

🚀 Hyperliquid MCP Server & Trading Dashboard

A production-ready Model Context Protocol (MCP) server with an interactive Gradio dashboard providing real-time trading data from Hyperliquid - the leading decentralized perpetual exchange.

🌐 Live Demo

URL: https://huggingface.co/spaces/rzvn/hyperliquid-mcp-server

🎯 Features

✅ MCP Server

• 8 Trading Tools with RESTful API
• Model Context Protocol compliance
• Real-time data from Hyperliquid

✅ Interactive Dashboard

• 5 Interactive Tabs with live data
• Real-time charts and visualizations
• User-friendly interface for all tools

📊 Available Trading Tools

1. Market Prices 📈

Get real-time prices for 200+ trading pairs

• Live price feed
• Top 20 by value
• Interactive data table

2. Recent Trades 💱

View recent trading activity

• Customizable trade count (1-1000)
• Real-time trade history
• Symbol-based filtering

3. Candlestick Charts 📊

Interactive price charts

• Multiple timeframes (1m, 5m, 1h, 4h, 1d)
• Customizable candle count
• Professional charting with Plotly

4. Order Book 📋

Live order book visualization

• Bid/ask depth charts
• Real-time updates
• Symbol-based lookup

5. Funding Rates 💰

Perpetual contract funding rates

• All markets overview
• Individual symbol focus
• Historical rate tracking

🔧 API Usage

MCP Endpoints

• Health Check: GET /health
• List Tools: POST /mcp/tools
• Execute Tool: POST /mcp/call

Example API Calls

Get All Market Prices

curl -X POST https://rzvn-hyperliquid-mcp-server.hf.space/mcp/call \
  -H "Content-Type: application/json" \
  -d '{"name": "get_all_mids", "arguments": {}}'

Get Recent BTC Trades

curl -X POST https://rzvn-hyperliquid-mcp-server.hf.space/mcp/call \
  -H "Content-Type: application/json" \
  -d '{"name": "get_recent_trades", "arguments": {"coin": "BTC", "n": 50}}'

🖥️ Interactive Dashboard Usage

Dashboard Tabs

📈 Market Prices Tab

• Click “Get All Market Prices” to load live data
• View top 20 cryptocurrencies by price
• Interactive sorting and filtering

💱 Recent Trades Tab

• Enter coin symbol (e.g., “BTC”, “ETH”)
• Adjust number of trades with slider
• View detailed trade history table

📊 Candlestick Charts Tab

• Enter coin symbol
• Select timeframe (1m to 1d)
• Adjust number of candles
• Interactive zoom and pan

📋 Order Book Tab

• Enter coin symbol
• View live bid/ask depth
• Visual order book representation

💰 Funding Rates Tab

• Optional coin symbol input
• View all funding rates or specific symbol
• Real-time rate updates

🛠️ Development

Local Setup

# Clone the repository
git clone https://huggingface.co/spaces/rzvn/hyperliquid-mcp-server
cd hyperliquid-mcp-server