🚀 ApexQuant

---

✨ Features

• Data Layer: Yahoo Finance historical quotes, optional NewsAPI headlines (fallback mocks available).
• AI Layer: NVIDIA chat/sentiment endpoint ready (falls back to rule-based scoring), indicator-to-text insight generator, risk detection for volume/RSI.
• Application Layer: Dark analytics UI with a stunning landing page, comprehensive market dashboard, stock analysis search, portfolio analyzer, and an interactive AI chat panel.

🛠 Tech Stack

Backend

• Libraries: yahoo-finance2, technicalindicators, axios, dotenv

Frontend

• Libraries: Next.js 14 (App Router), React Query, Chart.js (react-chartjs-2), Framer Motion, Zustand-ready

---

🚀 Run Locally

1. Backend (API)

cd backend
cp .env.example .env   # add NVIDIA/News API keys if available
npm install
npm run dev            # starts on http://localhost:4000

2. Frontend (Dashboard)

cd frontend
cp .env.local.example .env.local  # adjust API base if the backend port changes
npm install
npm run dev            # starts on http://localhost:3000

Note:

• NVIDIA_API_KEY is optional; without it, sentiment uses a light rule-based scorer.
• The UI is tuned for a “monitoring dashboard” look: dark glass cards, minimal gradients, responsive grid.

---

📡 API Endpoints

• GET /api/market/:ticker — Prices, indicators (SMA20/50, RSI14, volume spike), sentiment, insight, risk flags, headlines.
• POST /api/portfolio/analyze — Provide holdings array { ticker, weight, sector?, beta? } to receive diversification metrics and notes.
• POST /api/chat — Send a question + ticker to get a grounded answer combined with indicators and a sentiment snapshot.

---

📜 License

This project is licensed under the Apache License 2.0.

What you get with Apache License 2.0:

• Commercial Use: You can use the software for commercial purposes.
• Modification: You are free to modify the source code.
• Distribution: You can distribute the original or modified software.
• Patent Use: It provides an express grant of patent rights from contributors.
• Private Use: You can use and modify the software privately.

For more details, see the full Apache License 2.0.