The Money Maker 💸

High-Frequency Crypto Arbitrage & Liquidity Engine

📖 Overview

The Money Maker is an institutional-grade microservices system designed to detect and exploit triangular arbitrage opportunities across top-tier crypto exchanges (Binance, Bybit). It leverages a localized Golang Engine for millisecond-latency detection and a Python AI Layer for volatility risk filtering.

Key Features

• ⚡ Ultra-Low Latency: Golang + Goroutines handle concurrent WebSocket streams.
• 🤖 AI-Driven Safety: Scikit-Learn Isolation Forest filters out "too good to be true" anomalies.
• 💎 Premium UI: Glassmorphism dashboard with framer-motion animations and live recharts.
• 🛡️ No Transfer Risk: Detects loops within a single exchange (e.g., USDT -> BTC -> ETH -> USDT).

---

🏗️ Architecture

graph TD
    subgraph "External Exchanges"
        A[Binance WS] -->|Ticks| B(Golang Engine)
        C[Bybit WS] -->|Ticks| B
    end

    subgraph "Core System"
        B -->|Normalized Prices| D{Redis Pub/Sub}
        B -->|Arb Signal| D

        D -->|Safe Path?| E[Python AI Layer]
        E -->|Check Volatility| F[Scikit-Learn]
        E -->|Log Trade| G[(MongoDB)]

        H[React Frontend] -->|Poll Status| E
    end

Loading

🚀 One-Command Deployment

The entire system is containerized. To launch the fleet:

docker-compose up --build -d

Access Points

• Dashboard: http://localhost
• API Gateway: http://localhost:8000/docs
• MongoDB: mongodb://localhost:27017

---

💡 Profit Logic

Triangular Arbitrage

The engine looks for inefficiencies where the direct exchange rate differs from the cross-rate. Formula: Rate = (1 / Price_A_B) * Price_B_C * Price_C_A

If Rate > 1.002 (0.2% fee buffer):

1. Signal Generated: Go Engine pushes to potential_arb.
2. AI Validation: Python layer checks if the profit spike is an anomaly (e.g., flash crash or bad data).
3. Execution: If safe, the trade is logged as "EXECUTED".

Slippage & Fees

• Fees: 0.1% per leg => 0.3% total cost.
• Threshold: We only trigger on >0.5% net profit potential to cover slippage.

---

📂 Project Structure

MoneyMaker/
├── engine/          # Golang Core (WebSockets, Arb Logic)
├── ai_layer/        # Python AI (FastAPI, Scikit-Learn)
├── frontend/        # React Dashboard (Vite + Tailwind)
└── docker-compose.yml

🔒 Security

• API Isolation: API Gateway is decoupled from the Execution Engine.
• Environment config: Secrets managed via Docker environment variables.

---

how to run

1. turn on

docker compose up -d

2. turn off

docker compose down

---

Built by awanmh