YUD-west/NegadeX-Trading-Simulator

A full-stack stock trading simulation platform that replicates real market behavior, enabling users to trade virtual Ethiopian stocks, manage portfolios, and analyze market trends using real-time simulation, data structures, and algorithmic pricing logic. NegadeX — DSA-Powered Ethiopian Stock Trading Simulator 🌐 Live: negadex.vercel.app A production-grade, full-stack stock trading simulator built around real **data structures and algorithms** — not just CRUD. NegadeX models the **Ethiopian market** end-to-end: 32 major Ethiopian listings (Commercial Bank of Ethiopia, Ethiopian Airlines, Ethio Telecom, Tele-Birr, Safaricom Ethiopia, Awash Bank, Bank of Abyssinia, Oromia Bank, Siinqee Bank, Dashen Bank, Ethiopian Insurance Corp., GERD Hydropower, BGI/Habesha breweries, MIDROC, Yirgacheffe Coffee Union and more) priced in **Ethiopian Birr (ETB)**, a heap-based order matching engine, a random-walk market simulator with NBE-flavoured macro events, hash-map portfolios with stack/queue trade history, binary-search price lookups, JWT auth, an admin console, and a polished glassmorphism UI streaming over WebSockets. > Frontend: **React + Vite + Tailwind + TradingView Lightweight Charts + Framer Motion + Zustand** > Backend: **Node.js + Express + MongoDB + Mongoose + Socket.IO + JWT** > Deploy: **Vercel** (frontend) + **Render** (backend) — auto-deploy on push to `main` ### Try it now - **App:** negadex.vercel.app - **Demo account:** register any email, you start with **1,000,000 Br** of virtual capital - **Markets:** the simulator is ticking 24/7 — open Dashboard or Market to see live prices > ⏳ First load can take 30–60 s if the free-tier backend is asleep (Render cold-start). After that everything is instant. --- ## Table of Contents 1. Highlights 2. Screenshots 3. Architecture 4. DSA Implementation Guide 5. Project Structure 6. Setup — Local Development 7. Environment Variables 8. API Reference 9. WebSocket Events 10. Deployment 11. Security 12. Performance --- ## Highlights - **Real Order-Matching Engine** — Max-heap of bids vs. min-heap of asks, price–time priority, partial fills, market & limit orders, O(log n) per match. - **Realistic Market Simulator** — Geometric Brownian …