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.

Related MCP server: MCP Paradex Server

🌐 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

# Install dependencies
pip install -r requirements.txt

# Run locally
python app.py

Access Points

• Gradio Dashboard: http://localhost:7860

• MCP API: http://localhost:3001

Docker Build

docker build -t hyperliquid-mcp .
docker run -p 7860:7860 -p 3001:3001 hyperliquid-mcp

🔗 MCP Integration

This server follows the Model Context Protocol (MCP) standard, making it compatible with:

• Claude Desktop

• Cursor AI

• Any MCP-compatible client

• Custom applications

📈 Data Coverage

• 200+ Trading Pairs: All major cryptocurrencies and altcoins

• Real-time Data: Live prices, trades, and order books

• Historical Data: Candlestick charts with multiple timeframes

• Perpetual Contracts: Funding rates and open interest

• Account Analytics: Portfolio tracking and position management

🎯 Use Cases

For Traders

• Real-time market monitoring

• Technical analysis with charts

• Order book analysis

• Funding rate tracking

For Developers

• MCP server integration

• RESTful API access

• Real-time data feeds

• Trading bot development

For Analysts

• Market research

• Historical data analysis

• Trading strategy backtesting

• Market sentiment analysis

🤝 Contributing

Feel free to open issues or submit pull requests to enhance the server with additional Hyperliquid endpoints or features.

📄 License

MIT License - Feel free to use this server for your own projects and applications.

Built with ❤️ for the Hyperliquid trading community

Last Updated

Tue Jul 15 05:09:24 PM IDT 2025

Force rebuild Tue Jul 15 05:26:32 PM IDT 2025

Force rebuild