How to Use Programmable Stock Screener for Better Investment Decisions [Tutorial]

How to Use Programmable Stock Screener for Better Investment Decisions [Tutorial]

A programmable stock screener lets you define your investment criteria once, save them, and run the same systematic screen every week without rebuilding it from scratch. That repeatability is what separates a genuine research process from ad hoc browsing. Instead of searching for "good stocks," you specify exactly what good means to you: P/E below 18, ROIC above 15%, dividend yield above 2.5%, and five consecutive years of dividend growth. Then you run that screen weekly and review only the names that clear every bar.

This tutorial shows you how to build, save, and iterate on a programmable screen using ValueMarkers. By the end, you will have a systematic workflow that generates a fresh shortlist every week with no duplicated setup effort.

Key Takeaways

• Programmable screeners save filter logic so you can run the same criteria weekly without manual reconstruction.
• Systematic screening removes anchoring bias: you evaluate stocks against objective criteria, not against names you already know.
• ROIC is the most useful single quality indicator in a programmable screen. AAPL at 45.1% and MSFT at 35.2% set the upper range; 12% is a reasonable floor for quality filtering.
• Dividend yield combined with consecutive years of dividend growth catches the compounders that Graham-style deep value filters miss.
• The VMCI Score, combining Value (35%), Quality (30%), Integrity (15%), Growth (12%), and Risk (8%), works as a final sorting mechanism after your custom filters run.
• Our screener supports saved filter sets so your programmable workflow runs in under 5 minutes each week.

What Makes a Screener "Programmable"

A basic screener lets you set filters manually each time. A programmable screener adds three capabilities:

1. Save filter sets. Your criteria are stored and can be recalled with one click.
2. Combine multiple logic conditions. AND/OR logic lets you build nuanced filters: "P/E below 20 AND ROIC above 12%" or "dividend yield above 3% OR price-to-book below 1.5."
3. Sort by composite scores. After filtering, rank results by a composite metric like VMCI Score to prioritize your research.

The ValueMarkers screener supports all three. You can build a filter set in 10 minutes, save it under a name like "Value Quality Core," and recall it every Monday morning for your weekly review.

Step 1: Choose Your Screening Philosophy

Before building any filter, decide which investment philosophy your screen serves. The two most common frameworks are:

Value-first: You screen for cheap stocks and then check quality. P/E below historical average, P/B below industry median, free cash flow yield above 4%. Then you apply quality filters to remove the value traps.

Quality-first: You screen for excellent businesses and then check valuation. ROIC above 15%, ROE above 20%, 5+ years of earnings growth. Then you apply valuation filters to find entry points.

The quality-first approach produces fewer false positives. Cheap stocks with bad ROIC are value traps 60-70% of the time. High-ROIC stocks that are temporarily expensive rarely turn out to be disasters.

This tutorial builds a quality-first programmable screen.

Step 2: Define Your ROIC Floor

In the ValueMarkers screener, set ROIC as your first filter. Choose "above 15%" as your minimum.

Why 15%? At a typical cost of capital near 8-9%, a 15% ROIC means the business creates value at roughly 1.7x its financing costs. That gap is wide enough to persist through economic cycles. Companies with ROIC above 15% consistently over 5 years usually have a durable competitive advantage.

Compare the reference points:

Anything above the S&P 500 median (9.8%) is above average. Anything above 15% is genuinely strong. Above 25% is elite. Your floor of 15% keeps the screen focused on businesses with real competitive advantages.

Step 3: Add Dividend Yield and Growth Filters

Dividend data adds a second quality dimension. Companies that have paid and grown dividends for 10+ consecutive years have proven they generate consistent free cash flow. Boards do not raise dividends on businesses with deteriorating fundamentals.

Set these dividend filters:

• Dividend yield: above 2.0%. This screens out growth stocks that pay no dividend while keeping quality compounders.
• Consecutive years of dividend growth: above 10. Ten years of growth through at least one recession is meaningful evidence.

Coca-Cola (KO) has grown its dividend for 62 consecutive years. JNJ has grown dividends for 63 consecutive years. These are not coincidences. They reflect businesses with pricing power, stable demand, and management teams that prioritize shareholder returns.

If you want to include non-dividend-paying growth stocks in a separate screen, save a second filter set called "Quality Growth" with ROIC above 20%, 5-year EPS growth above 12%, and P/E below 35.

Step 4: Build the Valuation Check

After quality and dividend filters run, add one valuation condition: P/E below the 10-year historical median for each stock.

Do not use a fixed P/E number across all sectors. A P/E of 15 is expensive for a utility and cheap for a software company. Relative valuation is more meaningful than absolute valuation.

The ValueMarkers screener shows the 10-year P/E median for each stock alongside the current P/E. When the current P/E is 15% or more below the 10-year median, the stock is trading at a relative discount.

This single relative valuation filter catches more genuine opportunities than a fixed cutoff because it accounts for sector differences and company-specific pricing history.

Step 5: Save the Filter Set and Name It

With your three filter layers set (ROIC above 15%, dividend yield above 2% with 10+ year growth history, current P/E below 10-year median), save the screen.

Name it something specific: "Quality Dividend Value Q1 2026." The specific name matters because you will iterate on this screen over time and want to distinguish versions.

The saved screen becomes your weekly starting point. Monday morning: open screener, recall "Quality Dividend Value Q1 2026," click run, and review the output in 5-10 minutes.

Step 6: Sort Results by VMCI Score

After filters run, sort the results by VMCI Score descending. The VMCI ranks from 0-100 across five pillars:

• Value (35%): How attractively priced is the stock relative to intrinsic value?
• Quality (30%): How strong are the underlying business fundamentals?
• Integrity (15%): Does management allocate capital responsibly without accounting manipulation?
• Growth (12%): Is the business growing earnings and revenue?
• Risk (8%): How resilient is the balance sheet and business model?

A stock that clears your custom ROIC, dividend, and valuation filters AND scores above 75 on VMCI is a strong research candidate. A stock that clears your filters but scores 55 on VMCI has a specific weakness worth investigating before you commit capital.

The combination of your custom filters plus VMCI sorting cuts the research shortlist to the 5-10 names most worth your time each week.

Step 7: Iterate the Screen Based on Results

A programmable screen is not static. After running it for 4-8 weeks, review its output:

• Are you seeing too many names (above 30)? Tighten one filter. Raise the ROIC floor to 18% or require 15 years of dividend growth instead of 10.
• Are you seeing too few names (below 5)? Loosen one filter. Drop the dividend yield minimum to 1.5% or widen the P/E relative discount to 10% below median.
• Are the names it surfaces in sectors you cannot analyze confidently? Add a sector exclusion filter.

Save each version with a date in the name. "Quality Dividend Value Q2 2026" can have the tightened ROIC floor while preserving your original screen for comparison.

Common Mistakes in Programmable Screening

Three patterns consistently produce poor results from programmable screens:

Too many filters. More than six or seven filter conditions shrinks the output to near zero. The markets are not that efficient. If your screen never produces results, you have over-specified it.

Ignoring the quality layer. Screens built entirely on valuation metrics (low P/E, low P/B) consistently surface value traps. Businesses are cheap for a reason 60% of the time. Quality filters separate genuine cheapness from deteriorating businesses.

Not reviewing the output critically. A screen output is a list of candidates, not a list of buys. Review each name for qualitative factors the screener cannot capture: competitive position, management quality, industry structure. Berkshire Hathaway's (BRK.B, P/E 9.8, P/B 1.5) moat is not in its P/E ratio. It is in Buffett's capital allocation record and the diversification of operating subsidiaries.

Further reading: SEC EDGAR · FRED Economic Data

Why custom stock screener Matters

This section anchors the discussion on custom stock screener. The detailed treatment, formula, and worked examples appear in the body of this article above. The points below summarize the most important takeaways for value investors who want to apply custom stock screener in real portfolio decisions. ValueMarkers exposes the underlying data on every covered ticker via the screener and stock profile pages, so the concepts in this article translate directly into actionable filters.

Key inputs for custom stock screener

See the main discussion of custom stock screener in the sections above for the full treatment, including the inputs, the calculation methodology, the typical sector benchmarks, and the most common pitfalls to avoid. The ValueMarkers screener lets value investors filter the full universe of 100,000+ stocks across 73 exchanges using custom stock screener alongside the rest of the 120-indicator composite, with sector percentiles and historical trends shown on every stock profile.

Sector benchmarks for custom stock screener

See the main discussion of custom stock screener in the sections above for the full treatment, including the inputs, the calculation methodology, the typical sector benchmarks, and the most common pitfalls to avoid. The ValueMarkers screener lets value investors filter the full universe of 100,000+ stocks across 73 exchanges using custom stock screener alongside the rest of the 120-indicator composite, with sector percentiles and historical trends shown on every stock profile.

Related ValueMarkers Resources

• Pe Ratio — Glossary entry for Pe Ratio
• Dividend Yield — Dividend Yield is the metric used to how cheaply a stock trades relative to its fundamentals
• Roic — Glossary entry for Roic
• Best Portfolio Analysis App — related ValueMarkers analysis
• Best Utility Stocks — related ValueMarkers analysis
• Blue Chip Stocks — related ValueMarkers analysis
• Bull And Bear Market — related ValueMarkers analysis
• Dividend Growth Stock Screener — related ValueMarkers analysis

Frequently Asked Questions

what happens if the stock market crashes

In a market crash, your programmable screen becomes your clearest signal. Names that previously failed on valuation (current P/E above 10-year median) will start clearing the valuation filter as prices fall. Run your saved screen weekly during a downturn and you will see quality businesses progressively clearing the bar as they get sold indiscriminately with the market. Companies with ROIC above 15% and strong dividends like JNJ (3.1% yield) or KO (3.0% yield) are typically the most rewarding buys identified this way.

what time does the stock market open

U.S. markets open at 9:30 a.m. Eastern Time on weekdays. For programmable screen use, timing is irrelevant. You build and run screens outside of market hours, set your target prices, and then execute during market hours when the price crosses your level. The systematic nature of programmable screening means you never need to make real-time decisions under pressure.

are stock markets closed today

U.S. stock markets close on 9-10 federal holidays per year. Market closures are ideal days to review and iterate your saved screens. With no price activity to distract you, you can evaluate the current filter logic, update your research on companies that have appeared in recent screen outputs, and prepare your watchlist for the next trading week.

what time does the stock market close

Markets close at 4:00 p.m. Eastern on regular trading days. After-hours sessions continue until 8:00 p.m. but with thin liquidity. If a name from your programmable screen drops to your target buy price during after-hours, wait for the following regular session to execute. The price slippage from poor after-hours liquidity often eliminates a meaningful portion of your margin of safety.

when does the stock market open

The NYSE and Nasdaq open at 9:30 a.m. Eastern, Monday through Friday, excluding federal holidays. Set your programmable screen to run each Sunday evening or Monday morning before the open so your research list is ready for the week. This prevents reactive decision-making based on early-morning price moves.

why is the stock market down today

When the market is down significantly, your programmable screen is the most useful tool available. Sort by VMCI Score and check which of your saved watchlist names have crossed below their valuation floor. A 5% market drop that brings a high-ROIC, strong-dividend business below your target P/E is exactly the signal your systematic screen is designed to surface. Daily market declines are inputs to your process, not reasons to abandon it.

Build your systematic screening workflow with our screener. Save your filter sets, sort by VMCI Score, and run a consistent weekly process that takes under 10 minutes and delivers better research candidates than any ad hoc approach.

Written by Javier Sanz, Founder of ValueMarkers. Last updated April 2026.

Ready to find your next value investment?

ValueMarkers tracks 120+ fundamental indicators across 100,000+ stocks on 73 global exchanges. Run the methodology above in seconds with our stock screener, or see today's top-ranked names on the leaderboard.

Related tools: DCF Calculator · Methodology · Compare ValueMarkers

Disclaimer: This content is for informational and educational purposes only and does not constitute investment advice, a recommendation, or an offer to buy or sell any security. Past performance does not guarantee future results. Consult a licensed financial advisor before making investment decisions.