mucch documentation
AI-powered trading agent for perpetuals and futures on Hyperliquid
Introduction
mucch is an intelligent trading bot that combines cutting-edge AI models (GPT-5 or Claude 4.5 Sonnet) with the powerful Hyperliquid perpetual futures trading platform. Built with a focus on safety, transparency, and ease of use, mucch provides real-time market analysis, automated trading signals, and a beautiful terminal dashboard for monitoring your positions.
Key Features
AI-Powered Analysis
Leverages OpenAI GPT-5 or Anthropic Claude 4.5 Sonnet for sophisticated market analysis and trade recommendations based on multiple technical indicators.
Live Terminal Dashboard
Beautiful real-time charts for BTC and ETH using blessed-contrib, complete with account info, PNL tracking, and open positions display.
Smart Risk Management
Configurable risk percentage per trade, maximum position size controls, and conservative AI prompting ensure safe trading practices.
100+ Supported Assets
Trade major cryptocurrencies, trending tokens, DeFi assets, and more on Hyperliquid's perpetual futures platform.
Architecture Overview
mucch is built with a modular architecture that separates concerns and makes the codebase easy to understand and extend:
mucch/ ├── src/ │ ├── cli.ts # Entry point & environment validation │ ├── bot.ts # Main TradingBot class │ ├── dashboard.ts # Terminal UI with blessed │ ├── ai/ │ │ └── strategy.ts # AI analysis & prompts │ └── hyperliquid/ │ ├── trader.ts # Hyperliquid API client │ └── assets.ts # Supported trading pairs └── .env # Configuration
Important Disclaimers
Trading Risk: Trading perpetual futures involves substantial risk of loss. Only trade with funds you can afford to lose. mucch is a tool, not financial advice. Always perform your own research (DYOR) before making trading decisions.
Beta Software: mucch is actively developed and may contain bugs. The AI analysis is not perfect and should be verified before executing trades. Monitor your positions closely.
Next Steps
Ready to get started? Follow our comprehensive guides: