How anshika-singh002/faux-trading-arena works
Faux Trading is a virtual-money trading simulator with a Next.js client and modular FastAPI backend. The principal workflow is a user exploring simulated market data, placing server-validated trades, and viewing portfolio results; strategies, backtests, AI insights, learning, and rankings are additional product capabilities. Backend source excerpts establish several calls and persistence paths; other domains and frontend pages are represented from README and the source index, so their internal wiring is not asserted.
Main entry points: main.py API application · router.py Authentication · service.py Trade execution · database.py Database layer
Components 27
Trading interface
- Trading pages
frontend/src/app/(app) - Sign-in pages
frontend/src/app/(auth) - Learning modules
frontend/src/app/(app)/learn/page.tsx
Identity and accounts
- Authentication
backend/app/modules/auth/router.py - User service
backend/app/modules/users/service.py - User accounts
backend/app/models/user.py
Market and trading
- Market data
backend/app/modules/market_data/router.py - Trading API
backend/app/modules/trading/router.py - Trade execution
backend/app/modules/trading/service.py - Orders
backend/app/models/order.py - Positions
backend/app/models/position.py - Portfolio
backend/app/modules/portfolio/router.py - Trade history
backend/app/models/transaction.py
Strategy and insights
- Strategy builder
backend/app/modules/strategies/router.py - Backtesting
backend/app/modules/backtesting/router.py - AI insights API
backend/app/modules/ai/router.py - AI service
backend/app/modules/ai/service.py - ML predictions
backend/app/modules/ai/ml_service.py - Leaderboard
backend/app/modules/leaderboard/router.py - Notifications
backend/app/modules/notifications/router.py
Backend foundation
- API application
backend/app/main.py - Database layer
backend/app/core/database.py - Token security
backend/app/core/security.py - Configuration
backend/app/core/config.py
Other components
- Trader
- Market provider
- PostgreSQL
Connections 31
- Trader → Sign-in pages: signs in
README.md - Sign-in pages → Authentication: authenticates
README.md - Trader → Trading pages: uses
README.md - API application → Authentication: mounts
backend/app/main.py - API application → Market data: mounts
backend/app/main.py - API application → Trading API: mounts
backend/app/main.py - API application → Portfolio: mounts
backend/app/main.py - API application → Strategy builder: mounts
backend/app/main.py - API application → Backtesting: mounts
backend/app/main.py - API application → AI insights API: mounts
backend/app/main.py - API application → Leaderboard: mounts
backend/app/main.py - API application → Notifications: mounts
backend/app/main.py - API application → User accounts: mounts
backend/app/main.py - API application → Database layer: initializes
backend/app/main.py - Authentication → User service: calls
backend/app/modules/auth/router.py - Authentication → Token security: uses tokens
backend/app/modules/auth/router.py - Authentication → User accounts: creates user
backend/app/modules/auth/router.py - Token security → User service: loads user
backend/app/core/security.py - Trading API → Trade execution: delegates
backend/app/modules/trading/router.py - Trade execution → Orders: records order
backend/app/modules/trading/service.py - Trade execution → Positions: updates position
backend/app/modules/trading/service.py - Trade execution → Trade history: records fill
backend/app/modules/trading/service.py - Portfolio → Positions: reads
backend/app/modules/portfolio/router.py - Portfolio → Market data: uses prices
backend/app/modules/portfolio/router.py - Backtesting → Database layer: persists results
backend/app/modules/backtesting/router.py - AI insights API → AI service: uses
backend/app/modules/ai/router.py - AI service → ML predictions: selects prediction
backend/app/modules/ai/service.py - Market data → Market provider: may replace simulation
backend/app/modules/market_data/router.py - Database layer → PostgreSQL: stores records
backend/app/core/database.py - Database layer → Configuration: reads settings
backend/app/core/database.py - Trading pages → Learning modules: offers learning
README.md