Team: Vector Minds | Hackathon: OpenPools 2026
Freelancers working globally lose 3–8% of their earnings due to unfavorable exchange rates, hidden platform fees, and currency conversion charges. There is no centralized tool to help them choose the optimal invoicing currency based on real-time market data.
FreelanceX is an AI-powered currency intelligence platform that helps freelancers maximize their global earnings by:
- 🔍 Finding the best currency to invoice in using real-time arbitration analysis
- 📊 Providing live exchange rate analytics with historical trends & AI predictions
- 🧮 Simulating net earnings across 100+ currencies after platform fees
- 🧾 Generating smart invoices that calculate the exact bill amount to meet your desired payout
- ⚡ Offering a typing speed performance tracker for freelancer skill verification
- Live arbitration feed with real-time API data
- Global currency heatmap (stability & volatility by region)
- Live market depth (USD/INR liquidity & orderbook visualization)
- Dashboard cards with portfolio overview
- Live activity feed — real-time arbitration execution routing
- Multi-currency conversion across 120+ currencies
- Quick amount presets & currency swap
- Real-time exchange rates from Open Exchange Rates API
- AI-ranked currencies by effective USD after platform fees
- Spread percentages & gross vs. net comparison
- Visual ranking with flag indicators
- Input your desired payout → get the exact invoice amount
- Factor in platform fees, spreads, and conversion costs
- Anti-fee engine to eliminate hidden charges
- Historical exchange rate charts (24h / 7d / 30d)
- AI predictive trend alerts
- Currency risk radar (volatility scores)
- Profit prediction engine
- Model earnings across 10+ currency scenarios
- Worst-case & best-case projections
- Platform fee routing breakdown (smart contract visualization)
- Typing speed (WPM) & accuracy tests
- Skill verification for premium client tiers
- Built-in AI chatbot powered by Gemini
- Answers currency-related questions in real-time
- Local sign-up & login system
- Human verification check
- Profile management with avatar support
| Layer | Technology |
|---|---|
| Frontend | React 18, Vite 5, JSX |
| Styling | TailwindCSS 3.4, Custom CSS (94K+ lines) |
| Animations | Framer Motion 12, CSS Animations |
| 3D Graphics | Three.js (React Three Fiber + Drei) |
| Charts | Recharts 3.8 |
| Icons | Lucide React |
| API | Open Exchange Rates API (real-time) |
| Backend | Node.js, Express 5 |
| Database | MongoDB (Mongoose 9) |
| Auth | JWT, bcryptjs |
| AI | Google Gemini API |
freelance-marketplace/
├── public/ # Static assets
├── src/
│ ├── components/
│ │ ├── AIAssistant.jsx # AI chatbot
│ │ ├── ArbitrationSuggestions.jsx # Best currency ranking
│ │ ├── Background3D.jsx # 3D animated background
│ │ ├── CurrencyArbitrator.jsx # Arbitration engine
│ │ ├── CurrencyConverter.jsx # Multi-currency converter
│ │ ├── CurrencyHeatmap.jsx # Global heatmap
│ │ ├── DashboardCards.jsx # Stats cards
│ │ ├── EarningsChart.jsx # Rate charts
│ │ ├── EarningsSimulator.jsx # Scenario modeler
│ │ ├── LiveActivityFeed.jsx # Real-time feed
│ │ ├── LiveMarketDepth.jsx # Market depth
│ │ ├── LoginPage.jsx # Auth system
│ │ ├── Navbar.jsx # Navigation + ticker
│ │ ├── PerformanceStats.jsx # Typing test
│ │ ├── PlatformFeeBreakdown.jsx # Fee routing
│ │ ├── PredictiveTrend.jsx # AI predictions
│ │ ├── ProfileModal.jsx # User profile
│ │ ├── ProfitPrediction.jsx # Profit engine
│ │ ├── RiskIndicator.jsx # Risk radar
│ │ ├── SmartInvoiceGenerator.jsx # Invoice tool
│ │ └── TypingTest.jsx # WPM test
│ ├── hooks/
│ │ └── useExchangeRates.js # Live exchange rate engine
│ ├── App.jsx # Main app
│ ├── App.css
│ ├── index.css # Design system (94K+)
│ └── main.jsx
├── server/
│ ├── server.js # Express API server
│ └── models/
│ └── User.js # User model
├── index.html
├── package.json
├── vite.config.mjs
├── tailwind.config.js
├── vercel.json
└── README.md
- Node.js v18+
- npm v9+
# Clone the repository
git clone https://github.com/abdulhaque2005/vector-minds.git
cd vector-minds
# Install frontend dependencies
npm install
# Start development server
npm run devThe app will be available at http://localhost:5173
The frontend works standalone with live exchange rate APIs. To run the backend:
cd server
npm install
node server.jsNote: Backend requires MongoDB connection. Set
MONGO_URIin.env.
Deployed on Vercel: FreelanceX Live
| Dashboard | Converter | Analytics |
|---|---|---|
| Live arbitration feed, heatmap, market depth | 120+ currency conversion | Historical trends & AI predictions |
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ User Input │────▶│ Exchange Rate │────▶│ Arbitration │
│ (Invoice Amt) │ │ API (Live) │ │ Engine │
└─────────────────┘ └──────────────────┘ └────────┬────────┘
│
┌──────────────────┐ │
│ Smart Invoice │◀─────────────┤
│ Generator │ │
└──────────────────┘ ┌────────▼────────┐
│ Best Currency │
│ Recommendation │
└─────────────────┘
- Fetches live exchange rates from Open Exchange Rates API
- Applies spread & fee calculations for each currency
- Ranks currencies by effective USD equivalent
- Simulates worst-case / best-case scenarios
- Generates smart invoices with anti-fee calculations
| Member | Role |
|---|---|
| Abdul Haque | Full Stack Developer & Team Lead |
This project is built for the OpenPools 2026 Hackathon.
Built with ❤️ by Vector Minds
Empowering freelancers to earn more, everywhere. 🌍