🤖 What is NexisQuant?

NexisQuant is like having a tireless assistant that watches the market for you 24/7. It connects your personal "Watchlist" (your Google Sheet) to your brokerage account, automatically placing trades when it spots an opportunity you’ve defined.

🔗 The "Google Sheet" Remote Control

Pro-Tip: You don't need to log in to change what you are watching! Just open your Google Sheet on your phone, type in a new ticker symbol (like "TSLA"), and our system automatically spots it. It acts as a live, remote control for your trading engine.

🛡️ The "Safety Net" (Bracket Liquidator)

Analogy: Think of this as the "safety net" for your trades. If you set a 5% threshold, the system watches the price constantly. If the stock price jumps up 5% (Profit!) or drops 5% (Protection!), the system sells it automatically. You don't have to watch your screen—the system does the work for you.

🛑 The "Kill Switch"

Analogy: This is the "emergency brake" in your car. If you see the market acting strangely and want to stop, just hit the Kill Switch. It instantly tells the engine to stop opening new trades, keeping your remaining balance safe until you are ready to hit "Resume".

📈 Choosing Your Trading Style

You can tell the engine how to "think" by selecting these strategies:

• Mean-Reversion: Buying a stock when it’s "on sale" because it dropped too fast and expects to bounce back.
• Trend-Following: Joining a crowd that is already moving in a direction—you ride the wave as long as it lasts.
• Momentum-Breakout: Jumping in when a stock finally breaks through a price barrier, like a door bursting open.
• Statistical-Arbitrage: Finding hidden price differences between two similar stocks.
• VWAP Execution: Trading based on the average price of the day to ensure fair execution.

📊 Overview & Controls

What it is: Your primary command center dashboard tab.

• Core Capabilities: Displays your active system operational status badge, instant Kill Switch toggle button, Strategy Parameters Tuning link, and quick Sign Out access.
• Live Portfolio Status Card: Provides real-time synchronization metrics for your Alpaca brokerage connection, total portfolio value, available buying power, open positions count, and watchlist sync status.
• AI Sentiment Scans: Features the 🧠 Run AI Sentiment Scan button to evaluate fundamental risks across your active portfolio inventory instantly.

⚡ Live Telemetry Stream

What it is: Your sub-second WebSocket data feed.

• Core Capabilities: Connects directly to high-speed Alpaca data streams to monitor your watchlist in real time.
• Visual States: Color-codes tickers instantly (🔴 Action for major price deviations, 🔵 Setup for building opportunities, and ⚪ Monitoring for stable observation).

📡 Algorithmic Discovery

What it is: Your automated market scan discovery engine.

• Core Capabilities: Continuously scans high-probability setups across sectors like Tech Breakouts, Energy Reversals, and Financial Momentum filtered against your chosen quantitative strategies.
• Quick-Action Add: Allows you to instantly click + Add on any discovered ticker to append it straight to your active portfolio watchlist.

📈 Performance Ledger

What it is: Your comprehensive trade history and analytics ledger tab.

• Core Capabilities: Features high-level performance KPI cards (Net System P/L, Win Rate, and Active Positions count).
• Interactive Trade Ledger: Displays a sleek data table with soft-colored status badges (`Holding` vs `Sold`), color-coded profit/loss pills, column sorting, and custom multi-field filtering.

🧠 AI Insights (Cognitive Desk)

What it is: Your multi-model AI post-mortem and risk-management analysis tab.

• Core Capabilities: Runs side-by-side dual evaluations comparing Google Gemini and Anthropic Claude across your unique recent trade executions.
• Institutional Analysis: Translates raw wins and losses into detailed qualitative summaries (alpha generation vs. drawdown/risk containment).

🤖 AI Sentiment Scoring & Pre-Trade Failsafes

What it is: The fundamental safety layer built on top of your quantitative websocket pipeline.

• How it works: Gemini reviews recent real-time news headlines via Alpaca data feeds to score your watchlist assets from 1 to 100.
• Action Status Badges: Tickers display a green TRADE badge if macro health is verified (score 40+), or an emergency red HALT badge if severe structural or fundamental risks are detected (score under 40), blocking risky entries automatically.

🛑 AI Circuit Breaker (Pre-Execution Sanity Check)

What it is: The fiduciary safety valve that separates a platform users trust with real money from one they don't.

• How it works: Before every automated order fires, it runs through an LLM-based reviewer that checks it against your stated risk tolerance, account concentration limits, and unusual market conditions (e.g., halts, extreme volatility, low liquidity).
• The Benefit: The AI has the authority to pause and flag the order rather than silently executing a dangerous trade, keeping your capital safe.

⚖️ AI Risk Copilot (Portfolio-Level Sizing)

What it is: Your holistic portfolio balancer and automated Chief Risk Officer.

• How it works: Rather than each strategy deciding trade size in isolation, this AI layer looks at your whole portfolio right before execution.
• Sector Protection: It dynamically adjusts sizing recommendations so no single trade or sector breaks your overall risk budget, preventing dangerous systemic exposure.

📝 AI Trade Narrator (Glass-Box Transparency)

What it is: Trade rationale generation that turns a black-box bot into something you can audit and learn from.

• How it works: Every executed trade gets a one-line, plain-English "why" logged automatically in your Performance Ledger.
• The Benefit: It details exactly which rule fired, what data triggered it, and what the market context was at the exact moment of execution, giving you complete visibility.

🔐 Multi-Factor Authentication (MFA)

What it is: Institutional-grade security to protect your live brokerage connection and capital.

• Why needed: Because your platform executes real financial transactions, MFA ensures that even if your primary password is compromised, bad actors cannot access your engine or funds.
• How it works: Beyond your standard password, MFA requires a secondary, time-sensitive verification code every time you sign in to the portal.
• How to set it up: Scan the secure QR code presented during your initial registration with any standard authenticator app (like Google Authenticator or Authy) to link your mobile device.

🔑 Alpaca Credentials

Alpaca API Key:

• What it is: A digital ID card for your brokerage account.
• Why needed: Securely identifies your account for trade execution and news streaming.
• How to get it: From your Alpaca dashboard, navigate to "Trading" and generate a new key.
• Example: PK12345ABCDE67890FGHI

Alpaca Secret Key:

• What it is: A private password that pairs with your API Key.
• Why needed: Authenticates you as the authorized user for trading.
• How to get it: Shown only once upon key generation; save it immediately.
• Example: aBcD1234EfGh5678IjKl9012MnOp3456QrSt7890

⚙️ Strategy & Watchlist

Target Quantitative Strategies:

• What it is: The "brain" of your engine (e.g., Mean-Reversion).
• Why needed: Tells the system the logic to use when analyzing your watchlist.
• How to get it: Select your preferred model from the dropdown in your Profile.
• Example: Mean-Reversion, Trend-Following

Google Sheet Watchlist URL:

• What it is: The link to your private stock tracker.
• Why needed: Defines the list of stocks the engine actively monitors.
• How to get it: Share your sheet publicly and ensure the link ends in /export?format=csv.
• Example: https://docs.google.com/spreadsheets/d/1abc.../export?format=csv

🛡️ Risk Management

Bracket Liquidator Threshold (%):

• What it is: Your automated safety net for profits or losses.
• Why needed: Protects capital by auto-selling if a stock moves +/- your threshold.
• How to get it: Enter a percentage (e.g., 5) into the input field.
• Example: 5.00

Risk Factor Per Trade (%):

• What it is: The portion of your capital at stake for any single trade.
• Why needed: Ensures strict position sizing to prevent over-exposure.
• How to get it: Enter a conservative percentage (e.g., 1 or 2).
• Example: 2.00

Max Allowed Position Slots (Lots):

• What it is: The limit on how many stocks you can hold at once.
• Why needed: Keeps your portfolio manageable and avoids spreading capital too thin.
• How to get it: Define the maximum number of simultaneous active positions.
• Example: 10

Initial Allocation Base ($):

• What it is: The dollar amount the engine starts with for calculating trades.
• Why needed: Defines your "trading wallet" size for the strategy.
• How to get it: Enter the specific dollar amount available for this node.
• Example: 10000.00