vcp-screener

Screen S&P 500 stocks for Minervini Volatility Contraction Pattern setups by running a three-phase pipeline: pre-filtering, trend-template gating, and VCP scoring with RS integration to identify Stage 2 uptrends forming tight bases. Outputs include JSON and Markdown reports.

A VCP screener identifies Volatility Contraction Patterns by applying a trend-template gate to verify Stage 2 uptrends, then scoring contraction metrics and relative strength data. It ranks candidates by pivot proximity to highlight stocks forming tight bases before potential breakouts.

Find Stage 2 uptrends by applying a trend-template gate as the second phase of the VCP screening pipeline. This filters pre-screened S&P 500 stocks against Minervini trend criteria, ensuring only stocks in confirmed uptrends forming tight bases pass through to VCP scoring.

Customize the VCP screener with a user-provided stock list instead of the default S&P 500 universe. Adjust thresholds for trend score, lookback periods, and breakout scanning to refine tight base detection, generating tailored JSON and Markdown reports.

The VCP screener requires the FMP API to fetch historical price data for S&P 500 stocks. You need a valid FMP API key configured in your environment to execute the pre-filter, trend-template gate, and VCP scoring phases.

The Volatility Contraction Pattern scan generates detailed JSON results and Markdown reports. These outputs include ranked top VCP candidates, specific VCP metrics, relative strength data, and sector distribution analysis for review.