Provides RESTful API endpoints accessible via curl for programmatic access to Hyperliquid trading data
Provides containerized deployment of the Hyperliquid MCP server with Docker, enabling consistent runtime environments
Implements an interactive trading dashboard with Gradio for visualizing and interacting with Hyperliquid trading data
Uses Plotly for professional interactive charting of market data, including candlestick charts and order book visualization
Built with Python, supporting local development and customization of the Hyperliquid MCP server
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
Get Recent BTC Trades
🖥️ 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
Access Points
- Gradio Dashboard: http://localhost:7860
- MCP API: http://localhost:3001
Docker Build
🔗 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
This server cannot be installed
A Model Context Protocol server providing comprehensive tools to access real-time market data, trading information, user positions, and analytics for the Hyperliquid perpetual futures exchange.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server implementation that enables AI assistants to interact with the Paradex perpetual futures trading platform, allowing for retrieving market data, managing trading accounts, placing orders, and monitoring positions.Last updated -287PythonMIT License
- AsecurityAlicenseAqualityAn MCP server implementation that integrates with Hyperliquid exchange, providing access to crypto market data including mid prices, historical candles, and L2 order books.Last updated -367727TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol server that wraps the Hyperliquid SDK, enabling AI assistants to interact with the Hyperliquid cryptocurrency exchange for retrieving market data, executing trades, and managing positions.Last updated -JavaScriptMIT License
- -security-license-qualityA comprehensive MCP server that provides a complete wrapper around the Hyperliquid SDK, enabling AI assistants to interact with both spot and futures markets for retrieving data, executing trades, and managing positions.Last updated -JavaScriptMIT License