Skip to content

About

Institutional-grade real-time momentum screener, catalyst news wire & running tape for active day traders with TradingView, Alpaca borrow locates & Telegram alerts.

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

NewsAlerts β€” Momentum Screener, Tape & News Terminal

NewsAlerts Institutional Trading Terminal Banner

NewsAlerts Logo
Institutional-grade, real-time US small-cap momentum screener, high-of-day tape, and news intelligence terminal.

CI Status Secret Scanning Latest SemVer Release GitHub Wiki Documentation Supported Platforms Package Verification Gate


🎯 The Problem & Why NewsAlerts

Active momentum day trading requires spotting low-float runners the split second volume arrives. Existing platforms make this harder than it should be:

  • Interactive Brokers (TWS & IBKR Desktop): Notoriously bloated, complex, and cumbersome to configure for fast intraday momentum screening.
  • TradingView: While offering powerful charts, its news feeds often lag anywhere from several to 15 minutes behind the tapeβ€”rendering headlines completely stale and useless for active intraday decision makingβ€”and it completely lacks native inbound audio bells and immediate alert dispatching when tickers enter criteria.

NewsAlerts bridges this gap with a focused, zero-bloat institutional trading terminal designed for pure execution speed:

  • ⚑ Zero-Latency Inbound Alerts & Dual Topbar Toggles: Instant audio chimes (with interactive volume control & dedicated in-app audio bell) alongside independent Telegram push notifications with a dedicated 1-click topbar toggle (Telegram paper plane + bell) to silence mobile phone alerts when operating directly at your desk.
  • 🌊 Running Momentum Tape: Warrior-Trading style High of Day (HOD) and Squeeze Breakout prints with 4-day local disk persistence for weekend and off-hours trade review.
  • 🎯 Interactive Strategy Builder & Tape Quick-Filter: Construct customized momentum rules (+ Add Strategy) with trigger selectors, float ranges, and surge velocities in Settings, with instant one-click toggles right from the tape header (Strategies 11/13).
  • πŸ“‹ TradingView Cloud Watchlist Sync & 1-Click Quick-Add: Real-time cloud watchlist selector bar docked directly above news headlines, paired with 1-click quick-add (+) buttons next to tickers in the Screener, Tape, and News header. Features 3-second green/red flickering feedback and instant cloud sync directly into your TradingView Desktop app.
  • πŸ“° Zero-Lag Catalyst Confirmation (Beat the 15-Min Delay): Unlike retail charting platforms where news lags by 5 to 15 minutes, NewsAlerts pulls fresh headlines the second they cross the wire (Benzinga, GlobeNewswire, PR Newswire), enabling immediate verification of whether a runner is moving on real PR or sym-play noise.
  • πŸ“‘ BamSEC Real-Time SEC Filings & Dilution Radar: Directly integrated EDGAR intelligence surfacing critical SEC filings the moment they drop. Spot shelf registrations (F-3, S-3), toxic dilution offerings (424B), and insider stakes (Form 4) before entering a runner. Features dual drawer and sub-tab modes with 1-click external BamSEC hub launching.
  • πŸ” Custom US Equity Search & Watchlist Chips: Inspect real-time quotes, float, borrow locates, and Benzinga headlines for any US equity ticker on demand, pinned as interactive quick-access chips.
  • πŸ’Ύ Configuration Backup & Strategy Sync: Full disaster recovery export/import (.json) for screeners, sound configs, and strategies, with independent strategy preset sharing and safe factory reset.
  • πŸ“ˆ One-Click TradingView Chart Launching: Dedicated chart icon button docked directly in the news headline banner header (#news-chart). Clicking it instantly opens the live interactive TradingView chart for the active ticker in your default browserβ€”eliminating manual symbol typing during high-velocity breakouts.
  • 🩳 Real-Time Borrow Locates: Live HTB (Hard to Borrow), ETB (Easy to Borrow), and NO BORROW badges right on the tape and screener to identify short squeeze potential instantly.
  • πŸͺΆ Dual Distribution & Sub-300ms Instant Startup: Native Edge WebView2 execution with both a standalone portable binary (dist/NewsAlerts.exe) and a pre-extracted application installer targeting %LOCALAPPDATA%\Programs\NewsAlerts delivering sub-300ms instant terminal launch with zero Electron/Node.js overhead.

πŸ–₯️ Terminal Features Showcase

NewsAlerts Real-Time Momentum Terminal
Live institutional terminal capture (v2.12.0): Real-time screener with 1-click watchlist quick-add, high-of-day momentum tape, TradingView cloud watchlist selector, dual in-app audio & Telegram alert toggles, interactive topbar 🚫 Banned / Closing-Only filter, catalyst news wire, and BamSEC SEC filings intelligence.

Terminal Capability & Strategic Edge Live Institutional Interface Capture (Native Resolution)

⚑ Real-Time Momentum Screener

Sub-second low-float scanner built for intraday velocity

  • Live Inbound Badges: Instant visual NEW badge the exact second a ticker enters criteria.
  • Dynamic Momentum Filtering: Real-time scan criteria on Float, Price, % Change, and Relative Volume.
  • Live Shortability Indicators: Broker-grade NO BORROW, HTB, and ETB badges on every row.
Real-Time Momentum Screener

🌊 High-of-Day (HOD) & Squeeze Tape

Warrior-Trading style real-time momentum prints

  • High-Velocity Prints: Real-time prints streaming new high-of-day momentum triggers and velocity surges.
  • Broad Coverage: Monitors both low-float runners and high-float momentum squeezes (e.g. SMCI, NVDA, TSLA).
  • Relative Volume Velocity: Live 5-minute relative volume surges (e.g. +4000%) alongside daily rates.
  • 4-Day Local Persistence: Automatic local disk caching for off-hours and weekend trade reviews.
Running Momentum Tape

🎯 Tape Strategies Quick-Filter Menu

Instant floating strategy popout directly on the tape

  • Header Popout Toggles: Click Strategies 11/13 on the tape header to toggle strategies on the fly without leaving the tape.
  • Color-Coded Bullet Indicators: Direct visual correlation with tape print highlight families (mint, sand, violet, cyan).
  • Select / Unselect All: Instant master toggle to enable or disable all strategy streams with one click.
Tape Strategies Quick-Filter Menu

🚫 Broker Closing-Only & Banned Stock Filter

1-click blacklist to eliminate un-tradeable broker stocks

  • Topbar Interactive Filter Pill: Toggle [🚫 Banned: ON / OFF] on the top header to instantly hide blacklisted stocks across Screener and Tape.
  • 1-Click Blacklist Buttons: Click 🚫 directly beside tickers in Screener rows, Tape cards, and News header.
  • Dedicated Settings Manager: Interactive chips with βœ• removal, manual + Add Symbol input bar, and clear all.
  • Alert Suppression: Automatic suppression of audio chimes and Telegram alerts for banned tickers.
Banned Stocks Filter Settings

βš™οΈ Interactive Strategy Builder

Custom trading strategy engine with live rule editing

  • Add Custom Strategies: Click + Add Strategy to define custom float bounds, relative volume, price, and velocity windows.
  • Multiple Trigger Types: Choose between New HOD, 52w Breakout, or Up X% in N min surges.
  • Family Classification: Tag strategies as Low Float, Med Float, Large Cap, Squeeze, or Custom.
  • Inline Preset Sync: Instant πŸ’Ύ Export and πŸ“‚ Import buttons right in the strategies table.
Interactive Strategy Builder

πŸ’Ύ Backup & Strategy Sync Center

Full terminal disaster recovery and strategy distribution

  • Full Application Backup: Export complete terminal state (screeners, sound alerts, hotkeys, tape universe) into portable JSON.
  • Tape Strategies Only Sync: Share tactical strategy configurations independently with trading partners.
  • Factory Reset Safeguard: One-click restore back to factory defaults while securely preserving secret keys.
Configuration Backup and Sync

πŸ“° Instant Catalyst Confirmation

Zero-lag Benzinga & PR news wire with on-demand US symbol search

  • Custom US Symbol Search: Inspect real-time quotes, float, borrow locates, and Benzinga headlines for any US equity (AMEX, NASDAQ, NYSE).
  • Interactive Watchlist Chips: Pinned quick-access chips for rapid one-click ticker switching.
  • Eliminate the 15-Minute Lag: Retail charts lag by 5–15 min; NewsAlerts surfaces wire PRs the moment they cross.
  • One-Click Chart Popout: Dedicated chart icon button opens the live TradingView chart in your browser.
  • Custom Time Horizon: Filter news stories from the last 1 hour to 7 days with a single click.
Catalyst News Wire

πŸ“‘ BamSEC Real-Time SEC Filings & Dilution Radar

Zero-latency SEC EDGAR filing intelligence & dilution risk radar

  • Real-Time SEC Filings: Spot shelf registrations (F-3, S-3), dilution offerings (424B), insider stakes (Form 3/4), and material events (8-K/6-K).
  • Dual Display Modes (Drawer vs Sub-Tabs): Toggle between collapsible accordion drawer and full-height sub-tabs via ⊞ Layout or Settings.
  • Category Filter Pills: Instant filtering across All, News (8-K/6-K), Offerings & Dilution, Ownership & Insiders, and Financials.
  • Color-Coded Badges: Institutional badges highlighting dilution risk (rose/red), material PR (green), and ownership (purple).
  • 1-Click External BamSEC Hub: Direct browser launch button to inspect full filing documents and financial tables on BamSEC.
  • Togglable Opt-Out: Fully enabled out-of-the-box, or toggle off in Settings to completely remove from DOM and suppress background network queries.
BamSEC Real-Time SEC Filings

🩳 Institutional Short Borrow Locates

Real-time broker-grade locate availability and short squeeze detection

  • Alpaca Market Integration: Direct broker locate feeds for real-time borrow availability.
  • Color-Coded Status: Instant ETB (Easy), HTB (Hard), and NO BORROW badges.
  • Short Squeeze Edge: Identify short-squeeze candidates instantly before volume cascades.
Short Borrow Settings

πŸ“² Instant Telegram Push Alerts

Sub-second mobile & desktop DM delivery when momentum triggers fire

  • Live Push Alerts: Instant Telegram direct notifications with strategy triggers and volume surges.
  • Comprehensive Ticker Stats: Symbol, Price, % Change, Volume, Float, and Borrow status in every alert.
  • One-Click Chart Linking: Instant direct link to TradingView chart for rapid execution.
Telegram Push Notifications

πŸ“‹ TradingView Watchlist Sync & Quick-Add

Seamless cloud watchlist synchronization & 1-click symbol adding

  • Dynamic Watchlist Bar: Integrated selector bar docked directly above the News pane with list dropdown and on-demand sync (πŸ”„).
  • 1-Click Quick-Add (+) Buttons: Embedded next to tickers in Screener rows, Tape prints, and News header.
  • 3-Second Visual Flickering Feedback: Silent green flickering glow (βœ“) on add/existing symbol; red flickering glow (βœ•) with toast alert on failure.
  • Institutional Formatting: Automatic exchange qualification (e.g. NCPL β†’ NASDAQ:NCPL) before cloud push.
TradingView Watchlist Sync

⚑ Quick Start & Universal Makefile Workflow

NewsAlerts includes a Universal Cross-Platform Makefile providing identical developer and build commands across Windows, macOS, and Linux:

make env                             # Auto-detect OS & prepare virtualenv (.venv) with dependencies
# Platform-specific env targets:     # make env-win | make env-linux | make env-mac
make run                             # Launch desktop application
make build                           # Compile standalone executable / distribution package
make test                            # Run full automated unit test suite
make verify                          # Run Deterministic Package Verification Gate
make check                           # Audit for credential leaks
make clean                           # Remove build artifacts and caches
make worktree-list                   # List active git worktrees
make worktree-new BRANCH=feat/<name> # Create new isolated git worktree
make issue-list                      # List open issues (Issue-First Protocol)
make issue-view ISSUE=<number>       # Inspect specific issue details
make help                            # Display usage guide and detected platform

Windows Prerequisite for make:

Windows does not include GNU make by default. Install it in seconds:

winget install ezwinports.make
# Or via Chocolatey: choco install make -y

Zero-install alternative: You can also run .\make.bat <target> or .\build.ps1 -Task <target> in Windows PowerShell / CMD without installing any extra software.


πŸ“– Operational Procedures & Documentation Index

All technical procedures are documented in detail within the docs/ directory. Below is an executive summary of each procedure with direct links:

πŸš€ 1. Installation & Launch Procedure β€” docs/INSTALLATION.md

Universal make workflow, standalone binaries, and OS-specific setup:

  • Universal Developer CLI (make): Primary cross-platform interface for building, testing, verifying, and running NewsAlerts.
  • Windows x64: Zero-install portable standalone executable (dist\NewsAlerts.exe) with bundled custom icon, or source launch via make run / .\build.ps1 -Task run.
  • macOS (Apple Silicon arm64): Native Cocoa/WebKit window via make run / ./run.sh or automated system-wide installer ./install.sh.
  • Linux x86_64: WebKit2GTK runtime setup, automated ./install.sh, and desktop application launcher (assets/NewsAlerts.desktop). β†’ Read the complete Installation Guide

βš™οΈ 2. Configuration & Credentials Procedure β€” docs/CONFIGURATION.md

Configuration guidelines for live market data feeds, borrow locates, and alert notifications:

  • In-App Settings UI: Configure feeds, audio volume, and Telegram directly within the UI via the topbar gear icon.
  • TradingView Real-Time Data: Enter session cookies (sessionid, sessionid_sign) for sub-second unthrottled screener updates.
  • Alpaca Short Borrow Locates: Connect Alpaca API keys (key_id, secret_key) for live HTB, ETB, and NO BORROW badges.
  • Telegram Bot Notifications: Dispatch instant push alerts for newly discovered breakout symbols.
  • Isolated keys.toml Storage: Optional manual credential management strictly preserved in user APP_DIR (never in git). β†’ Read the complete Configuration Guide

πŸ“‚ 3. Directory Layouts & Persistence Procedure β€” docs/DIRECTORIES.md

Cross-platform directory specifications, rolling tape persistence, and worktree layouts:

  • User Application Roots (APP_DIR): Windows (%APPDATA%\NewsAlerts\), macOS (~/Library/Application Support/NewsAlerts/), Linux (~/.config/NewsAlerts/).
  • 4-Day Rolling Tape Persistence: tape_history.json retains up to 5,000 historical momentum prints for off-hours and weekend analysis.
  • Task-Isolated Git Worktrees (.worktrees/): Dedicated ignored directory hosting parallel feature branches without touching main. β†’ Read the complete Directory Layout Specification

πŸ“¦ 4. Release Governance & Versioning Procedure β€” docs/RELEASES.md

Release engineering policy, SemVer 2.0.0 compliance, and multi-OS artifact bundles:

  • Semantic Versioning 2.0.0: Strict MAJOR.MINOR.PATCH progression governed by app/version.py.
  • Multi-OS Release Bundles: Automated generation of NewsAlerts-Windows-x64.zip, NewsAlerts-macOS-arm64.tar.gz, and NewsAlerts-Linux-x64.tar.gz.
  • Release Changelog Catalog: Archived release documentation cataloged under docs/releases/. β†’ Read the complete Release Governance Guide

🀝 5. Development & Git Worktree Workflow β€” CONTRIBUTING.md

Guidelines for human developers and open source contributions:

  • Isolated Worktree Model: Never dirty main. Spawn dedicated feature worktrees via make worktree-new BRANCH=feat/<name>.
  • Conventional Commits: Enforced commit structure: type(scope): description.
  • Pull Request & Code Ownership: Mandatory PR template with automated bot validation and explicit code ownership via .github/CODEOWNERS. β†’ Read the complete Contributing Guide

πŸ€– 6. AI Agent Operating Protocol β€” AGENTS.md

Authoritative rules of engagement for automated AI coding agents (Antigravity, Claude, Copilot):

  • Absolute Security: Strict zero-leak rule for keys, secrets, tokens, or credentials.
  • Git Worktree Mandatory Rule: Root checkout on main is immutable; all modifications must occur in .worktrees/.
  • Local Verification Gate: Mandatory Python syntax compilation, unit tests, and build check before submitting PRs. β†’ Read the complete AI Agent Operating Guidelines

πŸ“š 7. Interactive GitHub Wiki & Documentation β€” GitHub Wiki

Official deep-dive manuals, strategy guides, and system architecture:

  • Terminal Manual & Navigation: Screener filtering, running tape persistence, and one-click TradingView chart popout.
  • Multi-Strategy Rules Engine: Strategy parameters for Low Float Momo, Squeeze 52wk Breakout, and 5%/10% surges.
  • Short Locates & Broker Integration: Real-time Alpaca API locate mappings and short squeeze analytics. β†’ Explore the complete NewsAlerts GitHub Wiki

πŸ›‘οΈ Package Verification & Fail-Safe Rollback Policy

NewsAlerts enforces a deterministic Package Verification Gate to ensure that broken, unverified, or incomplete binaries are never merged or distributed:

[ Build Artifacts ] ──> [ scripts/verify-packages.py ] 
                               β”‚
            β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
            β–Ό                                     β–Ό
     [ PASS (Code 0) ]                    [ FAIL (Code 1) ]
            β”‚                                     β”‚
    β€’ PR Check Green                       β€’ PR Aborted & Blocked
    β€’ Publish GitHub Release               β€’ DO NOT Publish Release
    β€’ Distribute Multi-OS Bundles          β€’ Delete Remote Git Tag
                                           β€’ Revert 'main' to Last Good Commit
                                           β€’ Auto-Open Critical GitHub Issue

1. In-PR Verification Gate

  • Every Pull Request triggers multi-OS builds across Windows, macOS, and Linux.
  • The package verifier audits archive structure, PE headers, executable sizes (>5MB), required launch scripts, and scans for secret file leakage.
  • If any check fails, the PR check turns red and merging is blocked.

2. Post-Merge / Release Fail-Safe Rollback

If package verification fails during a release run on main:

  1. Release Blocked: The package is not published to GitHub Releases or package registries.
  2. Git Tag Deleted: The remote tag (e.g. v2.4.1) is deleted via git push --delete origin <tag>.
  3. Automated Branch Rollback: The main branch is automatically reverted to the last known good commit (git revert HEAD).
  4. Critical Incident Issue: An automated GitHub issue is opened with full logs, commit SHA, and assigned to @mlgitdev.

πŸ“„ License

This project is proprietary and maintained by @mlgitdev. All rights reserved.

About

Institutional-grade real-time momentum screener, catalyst news wire & running tape for active day traders with TradingView, Alpaca borrow locates & Telegram alerts.

Topics

Resources

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages