Skip to content

About

Real-time crypto paper-trading simulation platform featuring Binance live streams, 20x futures leverage, 1v1 blitz duels, interactive charts, and community feeds. Built with Flutter, Riverpod, and Firebase.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Flutter Dart Firebase Riverpod Binance License

AcadrioTrade (Stock Arena) πŸ“ˆ

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.


πŸ“± App Preview

AcadrioTrade Feature Graphic

Dashboard Markets Futures Pro Community
Dashboard Markets Futures Community
Portfolio Interactive Charts 1v1 Blitz Duel Rewards & Quests
Portfolio Charts Blitz Duel Rewards

πŸš€ Key Highlights & Capabilities

⚑ Live Market & Advanced Trading Engine

  • 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.

βš”οΈ Gamification & Social Community

  • 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.

🌐 Cross-Platform & Resilience

  • 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.

πŸ— Architecture & Tech Stack

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
Loading
  • 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)

πŸ“‚ Project Directory Structure

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

πŸ›  Getting Started

Prerequisites

  • 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

Setup Instructions

  1. Clone the repository:

    git clone https://github.com/clawalone/Paper-Trading---Crypto.git
    cd Paper-Trading---Crypto
  2. Install project dependencies:

    flutter pub get
  3. Configure Firebase:

    • Place your google-services.json inside android/app/.
    • Place GoogleService-Info.plist inside ios/Runner/ (if targeting iOS).
    • Alternatively, configure via FlutterFire CLI:
      flutterfire configure
  4. Run the application:

    # Run on connected mobile device or emulator
    flutter run
    
    # Run responsive web terminal
    flutter run -d chrome
  5. Execute Unit & Resilience Tests:

    flutter test

πŸ“¦ Building for Production

Android Release Bundle (.aab):

flutter build appbundle --release

The output bundle will be located at build/app/outputs/bundle/release/app-release.aab.

Web Production Build:

flutter build web --release

🀝 Contributing

Contributions, feedback, and feature suggestions are welcome!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

Distributed under the MIT License. See LICENSE for more information.

Built with ❀️ for crypto traders and financial market enthusiasts.

About

Real-time crypto paper-trading simulation platform featuring Binance live streams, 20x futures leverage, 1v1 blitz duels, interactive charts, and community feeds. Built with Flutter, Riverpod, and Firebase.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages