A comprehensive, real-time crypto & paper-trading simulation platform with futures leverage, 1v1 blitz duels, social feeds, and live Binance streaming.
Built with Flutter, Riverpod, and Firebase for high-performance mobile and web deployment.
| Dashboard | Markets | Futures Pro | Community |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
| Portfolio | Interactive Charts | 1v1 Blitz Duel | Rewards & Quests |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
- Sub-Second Live Streaming: Real-time ticker feeds, 24h stats, and live order books via resilient Binance WebSocket and REST fallbacks.
- Interactive Pro Charts: Candlestick and line charts (1D, 1W, 1M, 1Y, 5Y) with volume indicators, pinch-to-zoom, and crosshair inspections.
- Futures Pro & Leverage: Practice futures trading with up to 20x leverage, liquidation estimation, stop-loss / take-profit calculations, and isolated margin models.
- Spot Trading & Order Book: Deep order book visualization with bid/ask depth spread and instant order execution simulation.
- 1v1 Blitz Duels: Challenge other traders in rapid real-time paper trading battles to climb seasonal ranks.
- Global Tournaments: Compete in timed championships with dynamic prize pools and transparent rules.
- Trader Community Feed: Share market insights, create posts, tip traders in virtual currency, and vote on community analysis.
- Leaderboards & User Profiles: Global rankings with an interactive podium, XP progression, and badge achievements.
- Algorithmic Signal Engine: Actionable momentum, breakout, and RSI signals to help traders learn entry/exit timing.
- Responsive Web Terminal: Professional multi-pane desktop trading station (
/web) with synchronized chart, order book, and portfolio panels. - Offline & Network Resilience: Automatic host fallbacks, non-blocking startup initialization, local data caching, and synthetic candle generation for seamless operation under unstable network conditions.
- Multi-Currency System: Instant real-time toggle between USD and INR base currency reporting.
graph TD
App[Flutter UI / Mobile & Web] --> Providers[Riverpod 3 Notifiers]
Providers --> MarketData[MarketProvider & OrderBookProvider]
Providers --> UserState[UserNotifier & AuthState]
Providers --> Social[CommunityProvider]
MarketData --> BinanceWS[Binance WebSocket Stream]
MarketData --> BinanceREST[Binance REST API + Failover]
UserState --> Firestore[Cloud Firestore Real-time Sync]
UserState --> LocalStorage[SharedPreferences & Offline Cache]
Social --> Firestore
- Frontend / Framework: Flutter (Material 3 Dark Theme with OLED optimization)
- State Architecture: Flutter Riverpod 3 (immutable state models, synchronous initializers, auto-dispose guards)
- Backend & Cloud: Firebase Authentication, Cloud Firestore, Firebase Storage
- Market Feed: Binance Public WebSocket (
wss://stream.binance.com) with HTTP polling backup - Charts: Syncfusion Flutter Charts, FL Chart, and TradingView WebView integration
- Packaging: Android App Bundle (AAB), APK, macOS, and responsive Progressive Web App (PWA)
lib/
βββ core/ # Core configuration, themes, & utility engines
β βββ app_theme.dart # OLED black design system & typography
β βββ currency_formatters.dart # Dynamic multi-currency formatting (USD/INR)
β βββ signal_engine.dart # Technical analysis & trading signal detection
β βββ topup_offer_manager.dart # Native promotional capital sheet
β βββ update_manager.dart # Version verification & in-app update prompts
βββ data/ # State layer & domain models
β βββ models.dart # UserState, Position, Holding, & Stock models
β βββ market_provider.dart # Resilient Binance price & candle stream
β βββ user_provider.dart # Portfolio balance, positions, & Firestore sync
β βββ order_book_provider.dart # Live bid/ask order book state
βββ features/ # Modular feature screens & widgets
βββ blitz/ # Real-time 1v1 trading duels
βββ community/ # Social posts, tipping, comments, & trader profiles
βββ dashboard/ # Main portfolio overview & quick stats
βββ futures/ # Pro futures leverage terminal & position cards
βββ leaderboard/ # Global rankings & 3-podium showcase
βββ market/ # Market watchlists & spot trading sheet
βββ signals/ # Algorithmic market signals dashboard
βββ stock_detail/ # Detailed candlestick chart & asset statistics
βββ tournaments/ # Trading championship events
βββ web/ # Desktop / Web multi-panel terminal
- Flutter SDK:
>= 3.4.0 < 4.0.0 - Dart SDK: Compatible with Flutter version
- Java: OpenJDK 17 (for Android builds)
- Firebase Project: Configured with Firestore & Firebase Authentication
-
Clone the repository:
git clone https://github.com/clawalone/Paper-Trading---Crypto.git cd Paper-Trading---Crypto -
Install project dependencies:
flutter pub get
-
Configure Firebase:
- Place your
google-services.jsoninsideandroid/app/. - Place
GoogleService-Info.plistinsideios/Runner/(if targeting iOS). - Alternatively, configure via FlutterFire CLI:
flutterfire configure
- Place your
-
Run the application:
# Run on connected mobile device or emulator flutter run # Run responsive web terminal flutter run -d chrome
-
Execute Unit & Resilience Tests:
flutter test
flutter build appbundle --releaseThe output bundle will be located at build/app/outputs/bundle/release/app-release.aab.
flutter build web --releaseContributions, feedback, and feature suggestions are welcome!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.








