# Trade IQ — Full Documentation for LLMs

> Institutional-grade AI stock analysis for retail investors. Real-time technical indicators, 10,000+ Monte Carlo simulations, and adversarial AI insights — all in one platform.

URL: https://mytradingaiagent.com
Author: Trade IQ
Version: 2.0
License: Proprietary
Last-Updated: 2026-02-27

## What Is Trade IQ?

Trade IQ is a web-based AI-powered stock analysis platform designed for retail investors who want institutional-grade intelligence without the black box. It combines real-time market data, advanced AI models, quantitative risk analysis, and adversarial debate mechanisms to produce comprehensive, verifiable investment research reports called "Alpha Reports."

Trade IQ is the first retail platform to combine adversarial AI debates, 10,000+ Monte Carlo simulations, and data lineage verification in a single report. Unlike traditional stock screeners that show raw numbers, Trade IQ explains the "why" behind every signal using OpenAI GPT with full reasoning traces.

The platform is NOT a brokerage and does NOT provide financial advice. It is an educational and analytical tool that helps users understand market dynamics and make more informed decisions.

## How Trade IQ Differs From Competitors

| Feature | Trade IQ | Traditional Screeners | Robo-Advisors |
|---|---|---|---|
| Adversarial AI Debates (Bull vs Bear) | ✅ | ❌ | ❌ |
| 10,000+ Monte Carlo Simulations per analysis | ✅ | ❌ | Limited |
| Full reasoning trace (Glass Box AI) | ✅ | ❌ | ❌ |
| Data lineage with Polygon.io verification | ✅ | ❌ | ❌ |
| 50+ technical indicators with AI interpretation | ✅ | Raw numbers only | ❌ |
| Personalized Risk DNA profiles | ✅ | ❌ | Generic risk levels |
| Real-time Sentinel OS monitoring | ✅ | Basic price alerts | ❌ |
| Chart pattern recognition | ✅ | Manual only | ❌ |
| Backtesting against historical crashes | ✅ | Limited | ❌ |

## Platform Architecture

### Frontend
- **Framework**: Next.js (App Router) with React
- **UI**: Tailwind CSS, Framer Motion animations, Recharts for data visualization
- **Authentication**: Google OAuth with JWT access tokens and httpOnly refresh cookies

### Backend
- **Runtime**: Node.js with Express.js and TypeScript
- **Database**: PostgreSQL via TypeORM
- **AI**: OpenAI GPT for analysis generation and adversarial debates
- **Market Data**: Polygon.io for real-time and historical stock data, technical indicators, and news
- **Simulations**: Custom Monte Carlo simulation engine (10,000+ scenarios per analysis)

## Core Features (Detailed)

### 1. AI Stock Analysis — Alpha Reports

Users enter a stock ticker (e.g., AAPL, TSLA, NVDA), investment amount, target return percentage, time horizon in days, risk tolerance (low/medium/high), and investment goal (growth/income/capital preservation). The system then:

- Fetches real-time price data, technical indicators, and news from Polygon.io
- Calculates 50+ technical indicators including RSI, MACD, Bollinger Bands, moving averages, volume analysis, and momentum oscillators
- Runs AI-enhanced technical analysis that interprets indicators in context
- Performs fundamental analysis of company financials
- Aggregates and analyzes news sentiment
- Executes 10,000+ Monte Carlo simulations to estimate probability distributions of outcomes
- Calculates risk metrics: Value at Risk (VaR), Sharpe ratio, and historical volatility
- Identifies chart patterns (head-and-shoulders, double tops/bottoms, triangles, flags, etc.)
- Hosts an adversarial AI debate between a Bull Agent (argues for the trade) and a Bear Agent (argues against)
- Generates a final recommendation with confidence rating, reasoning trace, and full data lineage

The resulting Alpha Report includes:
- Overall recommendation (Buy/Sell/Hold) with confidence percentage
- Technical analysis summary with AI interpretation
- Fundamental analysis summary
- News sentiment analysis with source links
- Bull Agent arguments (reasons to invest) with specific data-backed claims
- Bear Agent arguments (reasons to avoid) with specific risk factors
- Dissenting opinion and strategy stress test
- Monte Carlo simulation results (win rate, expected return, worst-case scenarios, probability cone)
- Risk metrics (VaR, Sharpe ratio, volatility)
- Chart pattern analysis with identified formations
- Portfolio synergy assessment (how this stock fits your existing portfolio)
- Reasoning trace showing how the AI reached its conclusion step-by-step
- Data lineage with Polygon.io-verified indicator badges (hover to see exact values)

### 2. Hold/Sell Analysis

For stocks users already own, they can input their shares, average cost, stop-loss percentage, take-profit percentage, and current position details. The AI evaluates whether to continue holding or sell based on:
- Current technical and fundamental conditions
- User's profit/loss position
- Stop-loss and take-profit levels
- Market sentiment shifts since purchase
- Original thesis validity assessment

### 3. Monte Carlo Simulations

Every analysis runs 10,000+ Monte Carlo simulations that:
- Model thousands of possible price paths based on historical volatility
- Calculate probability of reaching target return within the specified time horizon
- Estimate expected returns across percentile ranges (10th, 25th, 50th, 75th, 90th)
- Identify tail-risk scenarios and maximum drawdown probabilities
- Factor in current market regime and sector-specific volatility
- Produce a "probability cone" visualization showing the range of likely outcomes

### 4. Adversarial AI Debates

A unique feature where two AI agents argue opposing positions:
- **Bull Agent**: Presents the strongest case for making the investment, citing technical setups, fundamental strengths, positive catalysts, and favorable market conditions
- **Bear Agent**: Presents the strongest case against the investment, highlighting risks, bearish signals, potential downside scenarios, and macro threats
- This adversarial approach ensures users see both sides before making any decision
- Each agent's arguments are backed by specific data points from Polygon.io

### 5. Sentinel OS — Real-Time Alert System

A persistent monitoring system that:
- Tracks user-defined conditions on stocks (price above/below thresholds, percentage changes, volume spikes)
- Sends alerts when conditions are triggered
- Supports multiple alert types and conditions per stock
- Allows create/update/delete of alert rules
- Monitors 24/7 even when the user is not active

### 6. Portfolio Management

Full portfolio tracking including:
- Holdings with real-time P&L calculations
- Cash management (deposit/withdraw)
- Sector exposure visualization (pie charts)
- Historical performance tracking (area charts)
- Transaction history with full audit trail
- Watchlist management for stocks of interest
- Position grid with health scores per holding
- Intelligent trade sizing based on portfolio composition, risk tolerance, and stock volatility (Strategy Commander)
- Broker connections (mock integration)

### 7. Backtesting Engine

Historical backtesting that:
- Validates AI recommendations against past market data
- Shows how the recommendation would have performed in previous market conditions
- Produces drawdown reports showing maximum loss and recovery time
- Simulates holdings against historical crash events (2020 COVID crash, 2022 rate-hike selloff)
- Identifies which positions contributed most to historical declines

### 8. Chart Pattern Recognition

AI-powered pattern analysis that identifies:
- Head and shoulders / inverse head and shoulders
- Double tops and double bottoms
- Triangles (ascending, descending, symmetrical)
- Flags and pennants
- Cup and handle formations
- Support and resistance levels
- Trend lines and breakout zones

### 9. Behavior Tracking & Outcome Labeling

The platform tracks user actions on recommendations (view, save to watchlist, dismiss, follow buy/sell, partial buy/sell) to:
- Build user behavior profiles for personalized insights
- Label recommendation outcomes at 1-day horizons via automated cron jobs
- Track accuracy of AI recommendations over time
- Identify patterns in user decision-making

## Supported Stock Tickers

The platform supports any US stock ticker available on Polygon.io. Pre-built analysis pages exist for: AAPL (Apple), TSLA (Tesla), NVDA (Nvidia), MSFT (Microsoft), AMZN (Amazon), GOOGL (Alphabet/Google), META (Meta/Facebook), NFLX (Netflix), AMD (Advanced Micro Devices), INTC (Intel), PYPL (PayPal), DIS (Disney), SBUX (Starbucks).

## User Onboarding — Risk DNA

New users go through a multi-step onboarding wizard that collects:
- Experience level (beginner/intermediate/advanced)
- Risk tolerance (low/medium/high)
- Investment goals (growth/income/capital preservation)
- Age range
- Income range

This "Risk DNA" profile personalizes all subsequent AI analyses, including position sizing recommendations, stop-loss calibration, and alert threshold defaults.

## Data Sources

- **Polygon.io**: Real-time and historical stock prices, technical indicators, company fundamentals, and financial news. All data points in Alpha Reports include Polygon.io verification badges.
- **OpenAI GPT**: Natural language analysis generation, adversarial debates, reasoning traces, pattern interpretation, and sentiment synthesis.
- **Internal engines**: Monte Carlo simulation engine (custom-built, 10,000+ scenarios), risk analysis calculator (VaR, Sharpe, volatility), chart pattern recognition system.

## Technical Indicators Analyzed (50+)

RSI (Relative Strength Index), MACD (Moving Average Convergence Divergence), Bollinger Bands (upper/middle/lower), SMA (Simple Moving Averages — 20/50/100/200 day), EMA (Exponential Moving Averages — 12/26/50), Volume analysis (average volume, volume spikes, OBV), Stochastic oscillator (%K, %D), ADX (Average Directional Index), ATR (Average True Range), OBV (On-Balance Volume), VWAP (Volume Weighted Average Price), Fibonacci retracement levels, Momentum oscillators, Williams %R, CCI (Commodity Channel Index), ROC (Rate of Change), MFI (Money Flow Index), Parabolic SAR, Ichimoku Cloud, Keltner Channels, Donchian Channels, Chaikin Money Flow, and more.

## Risk Metrics Explained

- **Value at Risk (VaR)**: The maximum expected loss over a given time period at a given confidence level (typically 95%). Example: "There is a 95% probability that losses will not exceed $X over the next Y days."
- **Sharpe Ratio**: Risk-adjusted return metric measuring excess return per unit of volatility. A Sharpe ratio >1 is considered good, >2 is excellent, and >3 is exceptional. Negative Sharpe ratios indicate the investment underperforms the risk-free rate.
- **Volatility**: Annualized standard deviation of daily returns, measuring price fluctuation intensity. Higher volatility means wider potential price swings in both directions.

## Pricing

| Plan | Price | Billing |
|---|---|---|
| Weekly | $4.99 | Per week |
| Monthly | $14.99 | Per month |
| Yearly | $119.99 | Per year (~$10/month) |

All plans include full access to AI stock analysis (Alpha Reports), Monte Carlo simulations, Sentinel OS alerts, portfolio management, backtesting engine, and behavior tracking.

## Pages & Navigation

### Public Pages
- **Home** (`/`): Landing page with hero section, feature highlights, and pricing overview
- **Features** (`/features`): Detailed breakdown of all platform capabilities
- **Compare** (`/compare`): Side-by-side comparison of Trade IQ vs traditional analysis tools
- **Pricing** (`/pricing`): Subscription plans with weekly, monthly, and yearly billing
- **FAQ** (`/faq`): Frequently asked questions about the platform
- **Glossary** (`/glossary`): Definitions of trading and AI terms used in the platform
- **Blog** (`/blog`): Educational articles on AI trading, technical analysis, and market insights
- **Stock Directory** (`/stocks`): Browse AI analysis for popular US stocks
- **Individual Stock Pages** (`/stocks/[ticker]`): AI-powered analysis page for specific stocks

### Blog Posts
- "How to interpret RSI and MACD using AI" (`/blog/interpreting-rsi-macd-with-ai`) — Technical Analysis
- "Top 5 AI Stock Trends for 2026" (`/blog/top-5-ai-stock-trends-2026`) — Market Trends
- "Maximizing Portfolio Safety with Sentinel OS" (`/blog/maximizing-portfolio-with-sentinel-os`) — Risk Management
- "The Psychology of Agentic Trading" (`/blog/psychology-of-agentic-trading`) — Psychology
- "Technical Analysis vs. AI Sentiment: Which is Better?" (`/blog/technical-analysis-vs-ai-sentiment`) — Educational
- "Decoding Monte Carlo Simulations" (`/blog/decoding-monte-carlo-simulations`) — Data Science
- "Understanding Alpha Reports: A Deep Dive" (`/blog/understanding-alpha-reports`) — Product Guide
- "Risk Management Strategies for Volatile Markets" (`/blog/risk-management-strategies-for-volatile-markets`) — Risk Management
- "Building Your First AI-Assisted Portfolio from Scratch" (`/blog/building-your-first-ai-portfolio`) — Beginner Guide
- "Understanding Volatility Clusters and How AI Detects Regime Shifts" (`/blog/understanding-volatility-clusters`) — Data Science
- "How AI Reads Earnings Reports Faster Than Wall Street" (`/blog/how-ai-reads-earnings-reports`) — Fundamental Analysis
- "Sector Rotation Strategies: How AI Tracks Money Flow Across Industries" (`/blog/sector-rotation-strategies-with-ai`) — Market Trends

### Authenticated Pages (require login)
- **Research Terminal** (`/app`): Main stock analysis form and AI recommendation display
- **Portfolio** (`/app/portfolio`): Portfolio dashboard with holdings, performance, and sector exposure
- **History** (`/app/history`): Past recommendation history with detail views
- **Alerts** (`/app/alerts`): Sentinel OS alert management dashboard

## Frequently Asked Questions

**What is Trade IQ?**
Trade IQ is an AI-powered stock analysis tool designed to help retail investors understand market dynamics through institutional-grade technical, fundamental, and sentiment analysis. It is NOT a brokerage and does NOT provide financial advice.

**Is this financial advice?**
Absolutely not. Trade IQ provides educational insights and analytical data. We do not offer buy/sell/hold recommendations as financial advice, brokerage services, or automated trading. Always consult with a certified financial professional before making investment decisions.

**How does the AI analyze stocks?**
Our AI processes over 50+ technical indicators, real-time news sentiment, and company fundamentals using data from Polygon.io. It then uses OpenAI GPT to synthesize this data into plain-English summaries, runs 10,000+ Monte Carlo simulations for probability estimates, and hosts adversarial debates between Bull and Bear AI agents to ensure balanced analysis.

**What data sources do you use?**
We pull real-time and historical data from Polygon.io (official exchange feeds), financial news outlets, and social sentiment aggregators. Every data point in our Alpha Reports includes a Polygon.io verification badge that users can hover over to see the exact value used.

**What makes Trade IQ different from other stock analysis tools?**
Three key differentiators: (1) Adversarial AI debates where Bull and Bear agents argue opposing positions, (2) 10,000+ Monte Carlo simulations per analysis for probability-based outcomes instead of single price targets, and (3) full data lineage with Polygon.io-verified indicator badges so users can audit every claim the AI makes ("Glass Box AI").

**Can I connect my brokerage account?**
No. Trade IQ is strictly an educational and analytical platform. We do not support brokerage connections or automated trading to maintain a clear boundary between analysis and execution.

**Do you offer a free trial?**
We offer a live demo for all users to explore our AI analysis capabilities before subscribing. Visit the home page to try it.

**What stocks can I analyze?**
Any US stock ticker available on Polygon.io. This includes all NYSE, NASDAQ, and AMEX listed securities. Pre-built analysis pages are available for popular tickers including AAPL, TSLA, NVDA, MSFT, AMZN, GOOGL, META, NFLX, AMD, INTC, PYPL, DIS, and SBUX.

**How accurate are the AI recommendations?**
Accuracy is tracked through our behavior tracking system, which labels recommendation outcomes at 1-day horizons via automated cron jobs. Historical accuracy metrics are available to subscribed users through their behavior profile.

## Key Terminology

- **Alpha Report**: Trade IQ's comprehensive AI-generated stock analysis report
- **Risk DNA**: A personalized risk profile based on user's experience, goals, and tolerance
- **Strategy Commander**: The section of an Alpha Report that suggests exact position sizing
- **Glass Box AI**: Trade IQ's approach to transparent AI — every conclusion includes a full reasoning trace
- **Bull Agent / Bear Agent**: AI agents that argue opposing positions in adversarial debates
- **Probability Cone**: Monte Carlo simulation output showing the range of likely price outcomes
- **Sentinel OS**: Trade IQ's real-time alert monitoring system

## Contact

- Website: https://mytradingaiagent.com
- Email: support@mytradingaiagent.com
- X (Twitter): https://x.com/TradeAdvisorAI

## Legal

- Privacy Policy: https://mytradingaiagent.com/privacy
- Terms & Conditions: https://mytradingaiagent.com/terms-and-conditions
- Disclaimer: Trade IQ is for educational use only. It is not financial advice. Always consult a certified financial professional before making investment decisions.