USStockRadar
Developer & User Guide
Signal scanning, quality scoring, performance tracking, and API reference for the institutional options flow scanner.
USStockRadar monitors institutional options trading activity, scores signal quality, and tracks performance to help you focus on the highest-probability setups.
How It Works
Options flow from institutional sources is parsed in real-time
Gemini AI analyzes sentiment, direction, and market impact
Proprietary system scores each signal 0-100 with tier assignment
2-hour reaction + EOD close checks track win/loss outcomes
Quick Start
- 1Sign up via Telegram Login on the landing page
- 2Start a 48-hour free trial or subscribe to a plan
- 3Access the Dashboard to view real-time signals
- 4Set up your Watchlist for ticker-specific Telegram alerts
- 5Use tier filters (A+, A, B) to focus on high-quality signals
- 6Check the Performance Tracker for win/loss outcomes
Real-time ingestion of institutional options flow with AI analysis, pre-filtering, and deduplication.
Signal Categories
hot_contractPremium institutional flow — tracked for performanceinterval5-minute interval signals — tracked for performanceunusual_options_volumeUnusual options volume activityunusual_stock_volumeStock volume spikesinsider_tradingInsider transaction alertsSource Pre-Filters
All signals are pre-filtered at the source before entering the scoring system:
Deduplication
Duplicate contracts are automatically detected within a 60-minute window. When the same contract appears as both an interval and hot contract signal, the higher-priority hot contract is kept.
Our proprietary scoring system rates every signal from 0-100, assigning quality tiers to help you filter for the highest-probability setups.
| # | Factor |
|---|---|
| 1 | Premium Size |
| 2 | Trade Type |
| 3 | Side Clarity |
| 4 | Sentiment Alignment |
| 5 | DTE Sweet Spot |
| 6 | Moneyness / OTM% |
| 7 | Greeks Risk |
| 8 | IV Environment |
| 9 | Polymarket Alignment |
| 10 | Unusual Activity |
| 11 | Volume Ratio |
| 12 | Bid/Ask Conviction |
| 13 | Category Bonus |
Quality Tiers
Automated win/loss tracking with 2-hour reaction checks and end-of-day close snapshots.
Trade Side → Expected Direction
The trade side (ASK/BID) determines whether the trader is buying or selling, which defines the expected profitable direction.
How Wins Are Determined: Option Type × Trade Side
Win or loss depends on BOTH the option type (CALL/PUT) and the trade side (ASK/BID). The underlying stock price movement is what we track.
Bought AAPL 200C — stock goes up → option value rises → Win
Sold AAPL 200C — stock goes down → option value falls → Win
Bought AAPL 180P — stock goes down → option value rises → Win
Sold AAPL 180P — stock goes up → option value falls → Win
Outcome Thresholds
Snapshot Timeline
2 hours after signal entry to measure initial move
+2hEnd-of-day snapshot at market close (4:05 PM ET)
4:05 PMReal-time price updates during market hours
Real-timeThe dashboard provides real-time signal tables, analytics, and tools beyond the core scanner.
Polymarket
Browse prediction market data for finance, politics, stocks, commodities. Signals are aligned with market consensus for scoring.
AI Chart Analysis
Upload or paste a chart image and get AI-powered technical analysis via Gemini streaming. Supports English and Traditional Chinese.
Earnings Calendar
View upcoming earnings events cached from Alpha Vantage. Configurable day range with auto-refresh every 24 hours.
Watchlist
Track up to 50 tickers with per-ticker Telegram notifications. Get alerted when your tickers appear in the flow.
52-Week Highs & Lows
Track stocks hitting 52-week extremes to identify breakout and breakdown setups.
Daily Summary
Bull/bear breakdowns by signal category, top tickers, and activity trends for the day.
Endpoints for programmatic access to signals, performance data, and watchlist management. All responses return JSON.
Authenticate API requests using an API key. Requires an active Pro subscription.
API Key
Create an API key in Dashboard > Settings > API Access. Keys use the ow_live_ prefix and are limited to 3 per user.
Send as header
Authorization: Bearer ow_live_...All API endpoints require an API key. Include it as a Bearer token in the Authorization header.
Common Error Responses
| Code | Meaning |
|---|---|
401 | Missing or invalid authentication |
403 | Access denied (subscription required) |
404 | Resource not found |
429 | Rate limited — wait for cooldown |
500 | Internal server error |
Connect USStockRadar to AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients for natural language access to signals and analytics.
Prerequisites
- 1.An active Pro or Legacy subscription
- 2.An API key from Dashboard > Settings > API Access
- 3.Node.js 18+ installed on your machine
Claude Desktop Setup
Add this to your Claude Desktop config: (claude_desktop_config.json):
{
"mcpServers": {
"usstockradar": {
"command": "npx",
"args": ["tsx", "/path/to/mcp-server.ts"],
"env": {
"OW_API_KEY": "ow_live_your_key_here",
"OW_API_URL": "https://usstockradar.com"
}
}
}
}Replace ow_live_your_key_here with your API key and update the path to where you saved mcp-server.ts.
Available Tools (8)
Click any tool to see its parameters and response format.
Example Prompts
AI-powered TradingView chart scanner that runs as a Chrome side panel. Batch scan tickers with vision language models for pattern recognition, trade setups, and directional bias.
Overview
The USStockRadar Signal Scanner Chrome extension opens as a side panel inside Chrome. It automates TradingView chart navigation using CDP (Chrome DevTools Protocol), captures each chart screenshot, and sends it to a vision language model for technical analysis. Results include pattern detection, trend direction, support/resistance levels, and trade setups with confidence scores.
Ticker Sources
Custom
Manually enter any ticker symbols. Type individual tickers or paste a comma-separated list for ad-hoc scanning.
Daily Summary
Auto-loads top-mentioned tickers from USStockRadar's daily summary — the stocks where institutional smart money is most active today.
Watchlist
Pulls directly from your saved USStockRadar watchlist. Scan the same tickers you're already tracking for options flow signals.
Winners
Loads today's top performing tickers with a trophy icon. Focus technical analysis on stocks already showing strong momentum.
Signal Direction Filters
After loading tickers from any source, filter them by signal direction before scanning. The count next to each filter shows how many tickers match.
Scan Modes
Pro
Advanced VLM analysis with detailed pattern descriptions, support/resistance levels, entry/exit setups, and confidence scoring. Slower but thorough — best for pre-market analysis of focused watchlists.
Fast
Quick bias readings with pattern detection at higher throughput. Returns bullish/bearish/neutral classification with key patterns. Best for rapid screening of large ticker lists (20+ tickers).
Scan Controls
Start / Resume
Begin scanning from the first ticker or resume a paused scan. The button shows remaining count (e.g. 'Resume (11 left)').
Pause (■ button)
Pause mid-scan at any point. Completed results are preserved and the progress bar shows PAUSED status.
Export Results
Download all completed scan results. Includes bias, confidence, detected patterns, and trade setups for each ticker.
Clear
Reset all results and progress. Clears the summary dashboard and lets you start fresh with new tickers or a different mode.
Scan Summary Dashboard
A live summary dashboard at the bottom of the scanner updates in real-time as each chart is processed. It shows the total analyzed count and a breakdown of results.
Tips for Better AI Analysis
- 1.Use a clean TradingView chart layout with clear candlestick or bar charts for best pattern recognition
- 2.Ensure your TradingView chart is set to a daily timeframe for the most reliable pattern detection
- 3.Use the Daily Summary or Watchlist source to focus on tickers where institutional flow has been detected
- 4.Start with Fast mode to quickly screen a large list, then re-scan interesting tickers in Pro mode for detailed setups
- 5.The date picker lets you analyze historical charts — useful for backtesting patterns you spot