Axodus Dashboard

Axodus is a comprehensive cryptocurrency trading platform that integrates with Hummingbot API for automated trading strategies. The platform provides portfolio management, real-time market data, trading operations, backtesting, and controller management in a unified interface.

Features

Core Features

• Wallet Integration: Connect MetaMask or WalletConnect to view crypto assets and portfolio
• Hummingbot Integration: Complete API integration for bot management and trading
• Real-Time Updates: MQTT/WebSocket integration for live data streaming
• Portfolio Management: Multi-exchange portfolio tracking and analysis
• Market Data: Real-time prices, order books, and market depth
• Trading Operations: Spot trading, market making, and token swaps

Advanced Features (Phase 4)

• Backtesting System: Test trading strategies with historical data
  • Comprehensive metrics (Sharpe ratio, drawdown, win rate, profit factor)
  • Capital curve visualization
  • Trade analysis and performance reports
• Controller Management: CRUD interface for trading controllers
  • Pre-configured templates (PMM, Grid, DCA, Directional, Arbitrage)
  • Parameter validation and configuration
  • Real-time status monitoring
• Strategy Development: Complete workflow from creation to deployment

Additional Capabilities

• Multi-Device Support: Fully responsive design for all devices
• Interactive Dashboard: Real-time charts, tooltips, and dynamic visualizations
• Transaction History: Detailed transaction tracking across exchanges

Installation

Follow these steps to run the Axodus app locally:

1. Clone the Repository

git clone https://github.com/mzfshark/axodus.git
cd axodus

2. Install Dependencies

Ensure you have Node.js and npm installed. Then, run the following command to install project dependencies:

npm install

3. Start the Development Server

Start the development server to see the app in action:

npm start

By default, the app should be available at http://localhost:3000.

Technologies Used

Frontend

• React 19.1.0: Modern JavaScript library for building user interfaces
• Vite 6.2.0: Next-generation frontend build tool
• Recharts 2.15.3: Composable charting library for data visualization
• Axios 1.8.4: Promise-based HTTP client for API requests
• MQTT.js: WebSocket client for real-time data streaming

Wallet Integration

• MetaMask: Browser extension for Ethereum-based assets
• WalletConnect: Protocol for mobile wallet connections
• ethers.js / web3.js: Blockchain interaction libraries

State Management

• React Context API: Global state management
• Custom Hooks: Reusable logic for bots, trading, and real-time updates

Real-Time System

• EMQX Broker: MQTT message broker (WebSocket port 8083)
• MQTTClient: Singleton client with pub/sub pattern
• RealtimeContext: React context for real-time data distribution

Backend Integration

• Hummingbot API: FastAPI-based trading bot management
• PostgreSQL 16: Relational database for bot configurations
• MongoDB: Document database for market data
• Gateway: Node.js gateway for DEX trading

Available Routes

Main Routes

• / - Landing page
• /connect - Wallet connection
• /dashboard - Main dashboard
• /portfolio - Portfolio overview
• /settings - User settings
• /transactions - Transaction history

Trading Operations

• /trading/bots - Bot management
• /trading/portfolio - Trading portfolio view
• /trading/trade - Spot trading panel
• /trading/market - Market data and order books
• /trading/swap - Token swap interface

Advanced Features (Phase 4)

• /backtesting - Strategy backtesting interface
• /controllers - Controller management

Wallet Integration

MetaMask

Browser extension for managing Ethereum-based assets and interacting with decentralized applications.

WalletConnect

Open-source protocol connecting decentralized applications to mobile wallets for secure authentication.

Project Structure

/src
  /components                  # React components
    /common                    # Shared components (MetricCard, ConnectionStatus)
    /backtesting               # Backtesting UI components
    /controllers               # Controller management components
    /bots                      # Bot management components
    /trading                   # Trading operation components
    /realtime                  # Real-time data components
  /pages                       # Page components
    /backtesting               # Backtesting interface
    /controllers               # Controller management
    /trading                   # Trading operations
      /bots                    # Bot management page
      /portfolio               # Portfolio overview
      /trade                   # Trading panel
      /market                  # Market data
      /swap                    # Token swap
  /services                    # API and service layer
    /api                       # API clients
      hummingbotClient.js      # Main API client
      backtestingService.js    # Backtesting operations
      controllerService.js     # Controller management
    /websocket                 # WebSocket services
      mqttClient.js            # MQTT singleton client
  /context                     # React Context providers
    BotContext.jsx             # Bot state management
    RealtimeContext.jsx        # Real-time data distribution
  /hooks                       # Custom React hooks
  /utils                       # Utility functions
  /assets                      # Static assets
  /styles                      # Global CSS
  App.jsx                      # Main app component
  routes.jsx                   # Route definitions
  main.jsx                     # Entry point

Contributing

We welcome contributions to improve Axodus! If you'd like to contribute, please fork the repository, make your changes, and submit a pull request.

Steps to Contribute:

1. Fork the repository
2. Create a new branch for your feature or fix
3. Commit your changes
4. Push your changes to your fork
5. Open a pull request

Please ensure your code follows the project's code style and that all tests pass.

Documentation

Phase Documentation

• Phase 3: Real-Time Updates - MQTT integration and WebSocket system
• Phase 4: Advanced Features - Backtesting and controller management

Related Projects

• Hummingbot API - Backend API documentation
• Gateway - DEX trading gateway
• MCP Hummingbot - Model Context Protocol server

External Resources

• Hummingbot Official Docs
• EMQX Documentation
• React Documentation

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Axodus - Empowering investors with data-driven decisions.
For more information, visit Axodus Finance.