About Finorix
A technical overview of how Finorix works
What is Finorix?
Finorix is a virtual stock trading simulator built for students and beginners who want to learn how to trade stocks without risking real money. Start with $1,000 in virtual cash and practice trading real stocks with live market data.
Technology Stack
Frontend Framework
Built with Next.js 14 using the App Router for modern, fast, and SEO-friendly pages. TypeScript ensures type safety throughout the codebase.
State Management
Uses Zustand with persist middleware to manage your portfolio state. All data is stored locally in your browser using localStorage - no servers, no databases, complete privacy.
Market Data
Real-time stock prices powered by Finnhub.io API. We use their free Quote endpoint to fetch current stock prices for accurate trading simulation. Historical price data is intelligently generated based on real current prices.
Data Visualization
Interactive charts built with Recharts to visualize your portfolio equity curve, allocation pie charts, and performance metrics over time.
Styling
Clean, minimalist black & white design using Tailwind CSS with custom CSS properties for seamless dark/light mode switching.
How It Works
1. Real-Time Pricing
When you execute a trade, Finorix fetches the current market price from Finnhub's Quote API. This ensures you're trading at real market prices, just like a real brokerage.
2. Portfolio Tracking
Your positions are tracked with precision. We calculate your cost basis, current market value, unrealized P&L, and percentage returns in real-time as prices update.
3. Advanced Metrics
Beyond basic returns, we calculate sophisticated metrics like Sharpe Ratio (risk-adjusted returns), maximum drawdown (worst peak-to-trough decline), and portfolio volatility (standard deviation of returns).
4. Local-First Architecture
All your data stays on your device. No account creation, no sign-up forms, no server uploads. You can export your portfolio as JSON and import it on any device.
5. Price Caching
To respect API rate limits, price data is cached for 15 minutes. This reduces unnecessary API calls while keeping prices reasonably fresh.
Key Features
- •Any Stock: Trade any stock ticker - AAPL, MSFT, GOOGL, TSLA, ETFs like SPY, QQQ, or any other publicly traded stock
- •Real Market Prices: Live data from Finnhub.io for accurate trading simulation
- •365 Days of History: View equity curves and performance over time
- •7+ Performance Metrics: Total return, CAGR, Sharpe ratio, volatility, max drawdown, win rate, and more
- •Export/Import: Download your portfolio as JSON or import saved portfolios
- •Dark/Light Mode: Toggle between themes for comfortable viewing
- •Mobile Responsive: Trade on any device - desktop, tablet, or phone
Privacy & Data
Finorix is built with privacy at its core:
- ✓No account creation or sign-up required
- ✓All portfolio data stored locally in your browser
- ✓No tracking, analytics, or cookies
- ✓Open source code - audit it yourself
- ✓Works offline once loaded (except for price updates)
Technical Details
⚠️ Disclaimer
Finorix is for educational purposes only. This is a simulation using real market data but virtual money. Past performance does not guarantee future results. This is not financial advice. Always do your own research and consult with a financial advisor before investing real money.