SYSTEM SPECIFICATIONEdgeIQ Serverless Stack

Technical Architecture & System Flow

Designed & Engineered by Raj Puthawala

View Source Code

End-to-End System Topology

Interactive Diagram
Client UI LayerNext.js 14 React UI
Framer Motion & Recharts
JSON / HTTPS
Serverless API Router24 Specialized Endpoints
Upstash Redis Rate Limit
Strict Zod Schema
Data & AI ProvidersFinnhub Quotes & News
Groq / Llama 3.3 70B
FinBERT Sentiment NLP

EDGEIQ MICROSERVICE ROUTING MATRIX:

├── Finnhub API ───────> Quotes, News, Fundamentals, Insiders, Earnings, Options, Calendar

├── HuggingFace FinBERT ──> News Sentiment Classification (Bullish / Bearish / Neutral / Unavailable)

├── Groq / Llama 3.3 70B ─> Qualitative Research, Market Bias, Autopsy, Pre-Trade, Observations

└── Next.js Route Layer ─> Upstash Sliding Window Limit + Zod Input & Output Validation

1. Financial Data Pipeline

Connects to Finnhub APIs via serverless proxy handlers to fetch real quotes, company profiles, balance sheet metrics, insider Form 4 transactions, earnings surprise histories, and option chain snapshot distributions.

12 Dedicated Market Endpoint Handlers
Deterministic calculation module for P&L and R:R ratios

2. FinBERT Financial NLP Engine

Processes raw financial news headlines through HuggingFace's ProsusAI/finbert sentiment model. Returns probability distributions across Bullish, Bearish, and Neutral classifications with explicit fallback protection.

Strict "Unavailable" status state on NLP timeouts
Never silently converts failed calls to neutral

3. Groq Llama 3.3 70B AI Engine

Powers AI Stock Research Briefs, Trade Autopsies, Pre-Trade Risk Scorecards, Market Bias Summaries, and Market Observations. Operates with strict neutral research assistant persona prompts and untrusted data boundary delimiters.

Zod schema validation on model outputs
Exponential backoff retries & 15s abort timeout

4. Rate Limiting & Security Layer

Implements Upstash Redis sliding-window rate limiting (10 requests / 1 min per IP) with local in-memory fallback. Ensures API keys are strictly server-side and never exposed to the client bundle.

Status 429 Rate Limiting on all 12 AI endpoints
Status 400 Zod request validation enforcement