Skip to content

About

High-throughput 5,000+ US equities quantitative market scanner. Real-time screening for Premarket Movers, Gap Up/Down, Relative Volume (RVOL), Consolidation Breakouts, and Momentum ranking with automated Telegram alerts.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

5 Commits

Folders and files

Repository files navigation

๐Ÿ” OpenMarketScanner โ€” High-Throughput 5,000+ US Equities Market Scanner

Python 3.10+ FastAPI Async Throughput Alerts License: MIT

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.


๐Ÿ’ผ Need Custom Quantitative Systems, Trading Bots, or Scanners?

I build high-frequency algorithmic execution engines, custom market scanners, and automated broker integrations for hedge funds, prop trading desks, and private syndicates.


๐Ÿ—๏ธ System Architecture

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
Loading

โšก Key Capabilities

  1. ๐Ÿš€ 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.
  2. ๐Ÿ“Š Institutional Relative Volume (RVOL)

    • Compares real-time volume against normal time-of-day expectations, identifying true institutional accumulation/distribution rather than standard closing spikes.
  3. ๐ŸŒ… 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).
  4. ๐Ÿ’ฅ Structural 20-Day Breakout Engine

    • Detects clean price breakouts above 20-day highs or breakdown below 20-day lows confirmed by volume expansion.
  5. ๐Ÿงฎ 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.
  6. ๐Ÿ“ฑ Automated Telegram & Discord Alert Cards

    • Dispatches clean HTML formatting cards with ticker symbols, direct TradingView chart links, RVOL conviction, and trigger catalysts.

๐Ÿ–ฅ๏ธ Terminal CLI Output Preview

โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”ณโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”“
โ”ƒ 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

๐Ÿš€ Quickstart

1. Installation

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.txt

2. Environment Setup

Copy example environment variables:

cp .env.example .env

Edit .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

3. Run Interactive Terminal Scanner

# 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 20

4. Run FastAPI REST & WebSocket Server

python main.py

Open http://127.0.0.1:8000/docs to view the interactive OpenAPI / Swagger interface.


๐Ÿ“ก REST API & WebSocket Specifications

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.

๐Ÿ“„ License

Distributed under the MIT License. See LICENSE for details.


๐ŸŒŸ Maintained by Jahanzaib

About

High-throughput 5,000+ US equities quantitative market scanner. Real-time screening for Premarket Movers, Gap Up/Down, Relative Volume (RVOL), Consolidation Breakouts, and Momentum ranking with automated Telegram alerts.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages