Hyperliquid AI Trading Dashboard

Ein professionelles, vollständig integriertes Dashboard für die Verwaltung und Überwachung eines autonomen KI-gestützten Trading-Systems auf Hyperliquid und anderen Börsen.

🎯 Features

Dashboard & Monitoring

• Live-Performance-Metriken: P&L, Sharpe Ratio, Max Drawdown, Active Agents
• P&L-Trend-Chart: 30-Tage-Visualisierung mit Recharts
• Risk-Adjusted Returns: Grafische Darstellung der risikoadjustierten Renditen
• Dark Mode mit Neon-Akzenten: Professionelles Finanz-Design (Cyan/Purple Glow)

Strategie-Management

• CRUD-Operationen: Erstellen, bearbeiten, löschen, aktivieren/deaktivieren von Strategien
• Backtest-Trigger: Starten Sie Backtests direkt aus der UI
• Backtest-Ergebnisse: Detaillierte Metriken und LLM-Analyse
• Strategie-Vorschläge: KI-generierte Verbesserungsvorschläge basierend auf Backtest-Daten

Agenten-Steuerung

• Agent-Status-Überwachung: Strategy Dev, Backtesting, Execution, Self-Improvement
• Start/Stop/Pause-Buttons: Volle Kontrolle über Agent-Lifecycle
• Agent-Logs: Echtzeit-Logs mit LLM-Zusammenfassung
• Performance-Tracking: Erfolgsquote und Fehlerrate pro Agent

Trade-Management

• Trade-Historie: Tabellarische Ansicht aller Trades mit Filterung
• Offene Positionen: Echtzeit-Überwachung aller aktiven Positionen
• Trade-Details: Einstiegspreis, aktueller Preis, P&L, Hebel, Stop-Loss, Take-Profit
• Filter & Sortierung: Nach Status, Strategie, Symbol, Datum

MCP-Provider-Verwaltung

• Hyperliquid Integration: Vollständige Unterstützung für Hyperliquid Perpetuals
• Alpaca Support: Vorbereitet für Alpaca MCP-Server
• Multi-Exchange: Erweiterbar für weitere Börsen
• Provider-Status: Verbindungsstatus und Fehlerbehandlung
• API-Key-Management: Sichere, verschlüsselte Speicherung

Externe Datenquellen

• Alpha Vantage: Historische Marktdaten und technische Indikatoren
• Finnhub: Unternehmensnachrichten und Wirtschaftsindikatoren
• Daten-Caching: 5-Minuten-Cache für optimale Performance
• Automatische Datenaktualisierung: Hintergrund-Refresh

LLM-Integration

• Backtest-Analyse: Automatische Analyse von Backtest-Ergebnissen
• Strategie-Verbesserungen: KI-generierte Verbesserungsvorschläge
• Log-Zusammenfassung: Natürlichsprachliche Zusammenfassung von Agent-Logs
• Prompt-Editor: Bearbeiten Sie LLM-Prompts direkt in der App

Owner-Benachrichtigungen

• Liquidationsgefahr: Alert wenn Margin Ratio unter Schwellenwert fällt
• Agentenfehler: Benachrichtigung bei Agent-Abstürzen
• Strategie-Deployment: Bestätigung bei erfolgreichem Deployment
• Ungewöhnliche P&L: Alert bei außergewöhnlichen Gewinnen/Verlusten
• Hohe Drawdowns: Warning bei Max Drawdown Überschreitung
• Verbindungsverlust: Alert bei Exchange-Verbindungsverlust
• Backtest-Abschluss: Benachrichtigung wenn Backtest fertig ist

Sicherheit

• JWT-Authentifizierung: Sichere Session-Management
• Manus OAuth: Integrierte Benutzerauthentifizierung
• API-Key-Verschlüsselung: AES-256 für alle sensiblen Daten
• HTTPS: Verschlüsselte Kommunikation
• Role-Based Access Control: Admin/User Rollen

🏗️ Architektur

Frontend (React 19 + Vite + TailwindCSS 4)
├── Dashboard (Performance-Metriken)
├── Strategies (CRUD + Backtesting)
├── Agents (Status + Control)
├── Trades (History + Positions)
└── Providers (Configuration)

Backend (Express + tRPC)
├── Authentication (JWT + Manus OAuth)
├── Database (MySQL/TiDB + Drizzle ORM)
├── MCP Provider Layer (Hyperliquid, Alpaca, etc.)
├── LLM Integration (Backtest Analysis)
├── WebSocket (Real-time Updates)
├── Owner Notifications (Critical Alerts)
└── Data Sources (Alpha Vantage, Finnhub)

Database (11 Tables)
├── users
├── strategies
├── agents
├── trades
├── backtestResults
├── mcpProviders
├── apiKeys
├── prompts
├── skills
├── performanceMetrics
└── notifications

🚀 Quick Start

1. Voraussetzungen

• Node.js 22.13.0+
• Docker (für MCP-Server)
• Hyperliquid API-Keys
• (Optional) Alpha Vantage & Finnhub API-Keys

2. Installation

# Repository klonen
git clone https://github.com/StockPro-AI/Hyperliquid_AAI-Agents.git
cd hyperliquid-trading-dashboard

# Dependencies installieren
pnpm install

# Environment-Variablen setzen
cp .env.example .env.local
# Bearbeiten Sie .env.local mit Ihren Credentials

3. Hyperliquid MCP-Server starten

# Docker-Container starten
docker run -d \
  --name hyperliquid-mcp \
  -p 8080:8080 \
  -e HYPERLIQUID_API_KEY=your_api_key \
  -e HYPERLIQUID_API_SECRET=your_api_secret \
  stockpro-ai/hyperliquid-mcp-server:latest

4. Dashboard starten

# Development-Server
pnpm dev

# Production-Build
pnpm build
pnpm start

5. Im Browser öffnen

http://localhost:3000

📋 Datenbankschema

strategies

- id (PK)
- userId (FK)
- name
- description
- code
- parameters (JSON)
- isActive
- createdAt
- updatedAt

agents

- id (PK)
- userId (FK)
- name (Strategy Dev, Backtesting, Execution, Self-Improvement)
- type
- status (running, stopped, paused, error)
- lastHeartbeat
- createdAt
- updatedAt

trades

- id (PK)
- userId (FK)
- strategyId (FK)
- symbol
- side (buy/sell)
- quantity
- entryPrice
- exitPrice
- status (open, closed, liquidated)
- pnl
- createdAt
- closedAt

backtestResults

- id (PK)
- strategyId (FK)
- totalReturn
- sharpeRatio
- maxDrawdown
- winRate
- trades
- startDate
- endDate
- createdAt

mcpProviders

- id (PK)
- userId (FK)
- name (Hyperliquid, Alpaca, etc.)
- type
- endpoint
- isActive
- createdAt
- updatedAt

apiKeys

- id (PK)
- providerId (FK)
- keyName
- encryptedValue
- createdAt

🔌 MCP-Server Integration

Siehe MCP_INTEGRATION_GUIDE.md für detaillierte Anweisungen.

Unterstützte Provider

Provider	Status	Features
Hyperliquid	✅ Vollständig	Market Data, Portfolio, Trade Execution, Orders
Alpaca	🔄 In Entwicklung	Stocks & Options Trading
Binance	📋 Geplant	Spot & Futures
Kraken	📋 Geplant	Crypto Trading
Coinbase	📋 Geplant	Crypto Trading

📊 Externe Datenquellen

Alpha Vantage

• Historische Marktdaten (1min bis Daily)
• Technische Indikatoren
• Unternehmensprofile

Finnhub

• Unternehmensnachrichten
• Wirtschaftsindikatoren
• Earnings Calendar

🧪 Testing

# Vitest ausführen
pnpm test

# Mit Coverage
pnpm test --coverage

# Watch Mode
pnpm test --watch

📝 Umgebungsvariablen

# Database
DATABASE_URL=mysql://user:password@localhost:3306/trading_db

# Authentication
JWT_SECRET=your_jwt_secret
OAUTH_SERVER_URL=https://api.manus.im
VITE_OAUTH_PORTAL_URL=https://portal.manus.im

# MCP Servers
HYPERLIQUID_MCP_ENDPOINT=ws://localhost:8080
ALPACA_MCP_ENDPOINT=ws://localhost:8081

# Data Sources
ALPHA_VANTAGE_API_KEY=your_api_key
FINNHUB_API_KEY=your_api_key

# Encryption
ENCRYPTION_KEY=your_encryption_key

# LLM
VITE_FRONTEND_FORGE_API_KEY=your_key
BUILT_IN_FORGE_API_KEY=your_key

🔐 Sicherheit

• API-Keys: Alle Keys werden mit AES-256 verschlüsselt
• Authentifizierung: JWT + Manus OAuth
• HTTPS: Erzwungen in Production
• Rate Limiting: Implementiert auf allen API-Endpunkten
• Input Validation: Zod-Validierung auf allen Eingaben

📈 Performance

• Frontend: Vite-Bundling, Code-Splitting, Lazy Loading
• Backend: tRPC mit Caching, Database Query Optimization
• Database: Indexed Queries, Connection Pooling
• WebSocket: Optimierte Message Broadcasting

🐛 Troubleshooting

"Connection refused" zu Hyperliquid MCP

# Überprüfen Sie, ob der Container läuft
docker ps | grep hyperliquid-mcp

# Logs anschauen
docker logs hyperliquid-mcp

"Invalid API Key" Fehler

1. Überprüfen Sie die Keys im Dashboard
2. Stellen Sie sicher, dass die Keys korrekt kopiert wurden
3. Testen Sie die Keys mit der Hyperliquid CLI

WebSocket-Verbindungsfehler

1. Überprüfen Sie die Firewall-Einstellungen
2. Stellen Sie sicher, dass der Port 8080 offen ist
3. Überprüfen Sie die CORS-Konfiguration

📚 Dokumentation

• MCP Integration Guide
• Hyperliquid MCP Server
• Manus Dokumentation
• tRPC Dokumentation

🤝 Contributing

Beiträge sind willkommen! Bitte erstellen Sie einen Pull Request mit:

• Klarer Beschreibung der Änderungen
• Tests für neue Features
• Updated Dokumentation

📄 Lizenz

MIT License - siehe LICENSE Datei

🙏 Danksagungen

• Hyperliquid für die API
• Manus für die Infrastruktur
• Alpha Vantage & Finnhub für Marktdaten

📞 Support

Für Fragen und Support:

1. Öffnen Sie ein Issue auf GitHub
2. Kontaktieren Sie den Support über Manus
3. Lesen Sie die Dokumentation

---

Viel Erfolg beim autonomen Trading! 🚀