An institutional-grade, high-throughput quantitative market scanner screening 5,000+ US Equities in real-time. Screens Premarket Movers, Gap Up/Down, Relative Volume (RVOL) Surges, Consolidation Breakouts, and calculates a multi-factor Cross-Sectional Momentum Score with automated Telegram alerts and WebSocket live feeds.
I build high-frequency algorithmic execution engines, custom market scanners, and automated broker integrations for hedge funds, prop trading desks, and private syndicates.
- ๐ฌ Telegram: @JanzebBlockdev
- ๐ผ Fiverr Profile: Verified Quantitative Developer (Fiverr)
flowchart TD
subgraph Data_Layer["๐ก Data Ingestion Layer"]
Universe["5,000+ US Equities Universe\n(S&P 500 โข Russell 2000 โข Small/Mid Caps)"]
Feeds["Data Feed Connectors\n(Polygon.io โข FMP โข Synthetic High-Speed Simulator)"]
Universe --> Feeds
end
subgraph Analytics_Core["๐งฎ Quantitative Screening Engine"]
RVOL["Relative Volume Engine (RVOL)\n(Intraday Cumulative vs 30D Time-of-Day)"]
Gap["Premarket Gap Detector\n(Gap Up/Down % โข Float Turnover Quality)"]
Breakout["Consolidation & 20D Breakouts\n(Structural Highs โข Donchian Levels)"]
Score["Multi-Factor Momentum Ranker\n(Price Velocity + RVOL + Float Dynamics)"]
Feeds --> RVOL
Feeds --> Gap
Feeds --> Breakout
RVOL & Gap & Breakout --> Score
end
subgraph Distribution["๐ Real-Time Distribution"]
CLI["Terminal Rich CLI\n(Visual Color Tables โข Throughput Metrics)"]
API["FastAPI REST & WebSocket\n(/api/scan โข /api/presets โข /ws/stream)"]
Alerts["Dispatcher\n(Telegram HTML Cards โข Discord Webhooks)"]
Score --> CLI
Score --> API
Score --> Alerts
end
-
๐ Sub-Second 5,000+ Equities Screening
- Processes the entire US equity universe (S&P 500, Russell 2000, active small-caps) with sub-second latency via an asynchronous parallel batching pipeline.
-
๐ Institutional Relative Volume (RVOL)
- Compares real-time volume against normal time-of-day expectations, identifying true institutional accumulation/distribution rather than standard closing spikes.
-
๐ Premarket Gapper & Float Rotation Detection
- Automatically screens premarket movers gapping
$\pm 3%$ to$+35%$ before the 9:30 AM EST opening bell. Categorizes candidates by float velocity (A+ Runners vs Chop).
- Automatically screens premarket movers gapping
-
๐ฅ Structural 20-Day Breakout Engine
- Detects clean price breakouts above 20-day highs or breakdown below 20-day lows confirmed by volume expansion.
-
๐งฎ Multi-Factor Momentum Conviction Score (0-100)
- Synthesizes price velocity (
$35%$ ), volume expansion ($35%$ ), resistance breakout ($20%$ ), and low-float rotational bonus ($10%$ ) into a single ranked metric.
- Synthesizes price velocity (
-
๐ฑ Automated Telegram & Discord Alert Cards
- Dispatches clean HTML formatting cards with ticker symbols, direct TradingView chart links, RVOL conviction, and trigger catalysts.
โโโโโโโโโโณโโโโโโโโโโโโโโณโโโโโโโโโโโณโโโโโโโโโณโโโโโโโโโโโโโณโโโโโโโโณโโโโโโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโโโณโโโโโโโโโโโโโโโโโโโโโ
โ Symbol โ Price โ Gap % โ RVOL โ Volume โ Score โ Trigger โ Quality โ Sector โ
โกโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฉ
โ NVDA โ $144.20 โ +4.80% โ 4.2x โ 58,300,000 โ 88.5 โ 20D_BREAKOUT โ HIGH_MOMENTUM โ Technology โ
โ SMCI โ $38.50 โ +12.40% โ 5.8x โ 14,200,500 โ 86.2 โ GAP_UP_12.4% โ A_PLUS_RUNNER โ Technology โ
โ MSTR โ $245.80 โ +6.20% โ 3.4x โ 6,800,200 โ 79.1 โ 20D_BREAKOUT โ HIGH_MOMENTUM โ Financial Services โ
โ PLTR โ $44.10 โ +3.50% โ 2.8x โ 22,400,000 โ 74.0 โ RVOL_2.8x โ TRADABLE_GAP โ Technology โ
โ TSLA โ $288.40 โ -3.80% โ 2.4x โ 34,100,000 โ 68.2 โ GAP_DOWN_3.8% โ TRADABLE_GAP โ Consumer Cyclical โ
โโโโโโโโโโดโโโโโโโโโโโโโโดโโโโโโโโโโโดโโโโโโโโโดโโโโโโโโโโโโโดโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโ
Screened: 5,000 equities | Matches: 48 | Time: 0.082s | Throughput: 60,975 tickers/sec
git clone https://github.com/jahanzaib-codes/OpenMarketScanner.git
cd OpenMarketScanner
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux / macOS
source .venv/bin/activate
pip install -r requirements.txtCopy example environment variables:
cp .env.example .envEdit .env (optional โ works out-of-the-box in Simulator mode without API keys):
DEFAULT_DATA_PROVIDER=simulator # options: simulator, polygon
MIN_STOCK_PRICE=2.00
MAX_STOCK_PRICE=500.00
MIN_RVOL_THRESHOLD=2.0 # 2.0x normal volume
MIN_GAP_PERCENT=3.0 # Minimum 3% gap
# Real-Time Alerts
ENABLE_TELEGRAM_ALERTS=false
TELEGRAM_BOT_TOKEN=your_token
TELEGRAM_CHAT_ID=your_chat_id# Scan Premarket Gappers
python scanner_cli.py --preset PREMARKET_GAPPERS
# Scan Unusual Volume Surges (RVOL >= 3.0x)
python scanner_cli.py --preset UNUSUAL_RVOL
# Scan 20-Day Resistance Breakouts
python scanner_cli.py --preset MOMENTUM_BREAKOUT --limit 20python main.pyOpen http://127.0.0.1:8000/docs to view the interactive OpenAPI / Swagger interface.
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/health |
Returns health status, screened universe size, and active provider. |
GET |
/api/scan |
Runs custom scan (min_price, max_price, min_rvol, min_gap_pct, preset). |
GET |
/api/presets/{name} |
Fast preset scanner (PREMARKET_GAPPERS, UNUSUAL_RVOL, MOMENTUM_BREAKOUT). |
GET |
/api/universe/stats |
Sector breakdown and market capitalization distributions. |
WS |
/ws/stream |
Continuous real-time WebSocket broadcasting momentum triggers. |
Distributed under the MIT License. See LICENSE for details.
- GitHub: @jahanzaib-codes
- Fiverr: Hire for Quant & Trading Bot Development
- Telegram: @JanzebBlockdev