LogoLogo
Return to StockChartsCharts & ToolsArticlesChartSchoolYour Dashboard
  • Support Center
  • Finding Your Way Around
    • Intro to StockCharts
    • Navigating the Website
    • Logging In for the First Time
    • Members Dashboard
  • data and ticker symbols
    • Data Availability
      • Markets We Cover
      • Real-Time Data
        • BATS Real-Time Data
      • Extended Hours Data
      • Data Bar Periods
      • Price Data Adjustments
      • Historical Data
        • How Do I Download Data to Excel?
        • StockCharts Historical Sector Data
    • Ticker Symbols
      • Ticker Symbol Conventions
      • How to Find a Ticker Symbol
      • Using the Index Catalog
      • Ratio and Difference Symbols
      • Pseudo-Symbols
      • User-Defined Indexes
  • Charts & Tools
    • SharpCharts
      • SharpCharts Workbench
        • Creating and Viewing SharpCharts
        • Printing and Sharing SharpCharts
        • Editing SharpCharts
          • Using the SharpCharts Interactive Date Slider
          • Charting Market Breadth Indicators
          • SharpCharts Parameter Reference
        • Saving SharpCharts
        • Additional SharpCharts Workbench Tools
          • Viewing ChartLists on the SharpCharts Workbench
          • Viewing Alerts on the SharpCharts Workbench
          • Viewing Options Data on the SharpCharts Workbench
      • ChartStyles & StyleButtons
        • Working with ChartStyles and StyleButtons
        • Using the ChartStyle Library
        • Tool-Specific ChartStyles
      • ChartNotes
        • Annotating SharpCharts with ChartNotes
        • ChartNotes Annotation Tool Reference
          • Line Tools
          • Text Annotation Tools
          • Shape Tools
          • Line Study Tools
      • ChartLists
        • Summary View
        • ChartList View
        • ChartBook View
        • Performance View
        • Correlation View
        • Edit View
        • ChartList Reports
        • ChartPacks
      • Classic SharpCharts Workbench
      • StockCharts Mobile App
    • StockChartsACP
      • Creating ACP Charts
      • Multi-Chart Layouts in StockChartsACP
      • Viewing ACP Charts
      • Printing and Sharing ACP Charts
      • Editing ACP Charts
      • Applying Chart Templates to ACP Charts
      • Annotating ACP Charts
        • StockChartsACP Line Tools
        • StockChartsACP Text Annotation Tools
        • StockChartACP Shape Tools
        • StockChartsACP Line Study Tools
      • Working with Saved ACP Charts
      • StockChartsACP Plug-Ins
        • Chaikin Power Gauge Plug-In
        • GoNoGo Charts Plug-In
        • Larry Williams Stock Trading Starter Pack Plug-In
        • MarketGauge Plug-Ins
        • Simpler Trading Moxie Indicator Plug-In
        • Trading Simplified by Dave Landry
        • Trend Investor Pro Indicator Edge
    • Other Charting Tools
      • P&F Charts
      • GalleryView
      • Seasonality Charts
      • CandleGlance Charts
      • MarketCarpets
      • Interactive PerfCharts
      • RRG Charts
      • Dynamic Yield Curve
    • Research Tools
      • Symbol Summary
      • Options Summary
        • OptionsPlay Explorer
      • OptionsPlay Strategy Center
      • Market Summary
      • Sector Summary
      • Industry Summary
      • Index Members
      • StockCharts Technical Rank (SCTR) Reports
      • Earnings Calendar
      • Cryptocurrency Summary
    • Reports and Galleries
      • The Ticker Cloud
      • Historical Chart Gallery
      • Predefined Scan Results
        • Customizing Predefined Scans
      • Predefined Technical Alerts
      • DecisionPoint Chart Gallery
      • Public ChartLists
        • Becoming a Public ChartList Author
      • SharpCharts Voyeur
  • Scanning & Alerts
    • Technical Scans
      • Scanning for Stocks: The Basics
      • Advanced Scan Workbench
      • Standard Scan Workbench
      • Working With Scan Results
    • Scan Writing Resource Center
      • Planning Scans
      • Writing Scans
      • Scanning Tutorials
        • Scan Workbench Tutorial
        • Scan Results Tutorial 1
        • Scan Results Tutorial 2
        • Writing Scans Tutorial 1
        • Writing Scans Tutorial 2
        • Creating Scan Templates Tutorial
        • Troubleshooting Scans Tutorial 1
        • Troubleshooting Scans Tutorial 2
        • Troubleshooting Scans Tutorial 3
      • Scanning Case Studies
        • Scanning for Crossovers
        • Scanning for "Near Crosses"
        • Scanning for Divergences
        • Scanning for Relative Strength
        • Scanning for Consolidation and Breakouts
        • Scanning for Selling Climaxes
        • Scanning for SCTRs
        • Scanning Ichimoku Clouds
        • Scanning for P&F Chart Patterns
        • Scanning Your ChartLists
        • Scanning for an Overlay of an Indicator
        • Writing Min/Max Scans
        • Writing Percent Change Scans
        • Scanning Over a Range of Dates
        • Writing Scans With OR Clauses
      • Troubleshooting Scans
        • Troubleshooting Equality Scans
      • Getting Help With Scans
      • Scan Syntax Reference
        • Scan Syntax: Ticker Properties
        • Scan Syntax: Price, Volume, and SCTRs
        • Scan Syntax: Technical Indicators
        • Scan Syntax: Technical Functions
        • Scan Syntax: Predefined Patterns
        • Scan Syntax: Groups
      • Advanced Scan Library
        • Sample Scans
        • Predefined Scans
        • Published Scans
        • User-Contributed Scans
        • Gord Greer's Scan Building Blocks
    • Technical Alerts
      • Technical Alert Workbench
      • Your Alerts
  • Your Account
    • Subscribing to StockCharts
    • Service Levels & Data Plans
    • Login & Passwords
    • Your Account Settings
    • Managing Your Subscription
      • Cancelling Your Account
    • StockCharts Add-Ons
      • OptionsPlay Add-On
  • Learning More
    • Market Commentary
      • Blogs
      • ChartWatchers Newsletter
      • StockCharts TV
    • Educational Resources
    • Frequently Asked Questions (FAQs)
    • Step-By-Step Instructions
      • SharpCharts How-Tos
        • SharpCharts Workbench How-Tos
          • How to Print a SharpChart
          • How to Share a SharpChart on Social Media
          • How to Email a SharpChart
          • How to Insert a SharpChart in a Document or Presentation
          • How to View Indicator and Overlay Values for Specific Days
          • How to Save a SharpChart
        • SharpChart Editing How-Tos
          • How To Use The Interactive Date Slider
          • How to Display More than One Symbol on a SharpChart
          • How to Create Overlaid Charts
          • How to Add an Overlay to an Indicator
          • How to Add a Moving Average to the Volume Bars on a Chart
        • ChartNotes How-Tos
          • How to Pin an Annotation on a SharpChart
          • How to Save a Chart from a Blog Article with the Author's Annotations
        • ChartList How-Tos
          • How to Use the ChartList Summary
          • How to Search for a Saved Chart in Your ChartLists
          • How to Share a ChartList with Another Member
        • ChartList Editing How-Tos
          • How to Create a New ChartList
          • How to Add Predefined Symbol Groups to a New ChartList
          • How to Add Predefined Groups into an Existing ChartList
          • How to Upload Symbols to a ChartList from a Spreadsheet
          • How to Rearrange Charts in a ChartList
          • How to Delete a Saved Chart from a ChartList
      • StockChartsACP How-Tos
        • Setting Period, Type And, Range
        • Chart Attributes
          • Part One
          • Part Two
        • Sharing And Printing
        • Saving Charts
          • Saving A New Chart
          • Saving An Existing Chart As New
        • Chart Templates
          • Applying Predefined Chart Templates
          • Saving A New Chart Template
        • Using ChartLists
          • Creating A New ChartList
        • Chart Layouts
          • Accessing Chart Layouts
          • Creating A New Custom Layout
        • Additional Tools
          • Accessing Research Tools
    • Troubleshooting
      • Unable to Log In
      • Website Slow or Down
        • Using OpenDNS
      • Website Functionality Issues
    • Customer Support
    • Policies & Limitations
      • Terms of Service
      • Privacy Statement
      • No Service Level Guarantees
      • Data Policies
      • Usage Limitations
      • Reprint Permission Policies
      • Billing Policies
      • Membership Policies
      • Public ChartList Policies
      • Customer Support Policies
Powered by GitBook
LogoLogo

ON STOCKCHARTS

  • Charts & Tools
  • Articles
  • StockCharts TV
  • ChartSchool

MEMBERS

  • Your Dashboard
  • Your ChartLists
  • Advanced Scans
  • Technical Alerts

HELP

  • Support Center
  • FAQs
  • Contact Us
  • Pricing

COMPANY

  • About Us
  • What's New
  • Careers
  • StockCharts Store

© StockCharts.com, Inc. All Rights Reserved.

On this page
  • Accessing the Advanced Scan Workbench
  • Parts of the Advanced Scan Workbench
  • How To Build a Scan
  • The Scan Criteria Box
  • Scan Components
  • Managing Your Scans
  • Using Your Scan
  • Checking Syntax
  • In-Line Error Checking and Auto-Fixing
  • Running the Scan
  • Scheduled Scans
  • Scheduling a Scan
  • Viewing Your Scheduled Scans
  • ChartLists Created By Scheduled Scans
  • The Bottom Line
  • Additional Resources
  • Reference Guides
  • Articles
  • Tutorials
  • Videos

Was this helpful?

Export as PDF
  1. Scanning & Alerts
  2. Technical Scans

Advanced Scan Workbench

PreviousScanning for Stocks: The BasicsNextStandard Scan Workbench

Last updated 20 days ago

Was this helpful?

Scans are an invaluable resource for investors and traders because they allow you to discover charts with any technical condition imaginable. The Advanced Scan Workbench helps you achieve this goal, giving you the tools you need to build, test, and run complex scans and save them for later use.

The Advanced Scan Workbench gives users complete control over the Scan Engine. It's very flexible and allows you to do the following:

  • Create conditions with multiple indicators on each side of the Comparison Operator.

  • Create scans that join different conditions together with “OR” logic.

  • Modify more scan parameters.

  • Specify the sort order of results.

  • Display extra fields in the scan results.

Check out our Advanced Scan Workbench overview video below, or just read on to learn how to get the most out of the Advanced Scan Workbench.

Accessing the Advanced Scan Workbench

  • Click the New Scan button in the Your Scans section of the dashboard.

You can also access the Advanced Scan Workbench from any page by clicking on your name in the top right corner and choosing Your Scans from the dropdown menu.

Parts of the Advanced Scan Workbench

  1. Scan Management

  2. Starting Date Adjuster

  3. Scan Criteria Box

  4. Run Scan Button

  5. Check Syntax Button

  6. Reformat Button

  7. Errors and Warnings Selector

  8. Reset Criteria Button

  9. Scan Components Area

  10. Additional Resources

How To Build a Scan

The Scan Criteria Box

The Scan Criteria Box contains the criteria used to run the scan. Enter all scan clauses that make up your scan in this box.

When you create a new scan, you'll see default filters in the Scan Criteria box. These represent default filters that are often used in scans. You are free to modify or delete these criteria. You can manually add scan clauses or copy from the Scan Components area.

The Auto-Suggestions feature makes it simple to type clauses.

  • Start typing in the Scan Criteria Box. The feature will automatically suggest possible clauses for you in a dropdown menu (see below).

  • Select the clause you want with your mouse or arrow keys.

  • When the option you want is highlighted in blue, press the Enter key to insert the clause in your scan. If the dropdown menu doesn't appear, Windows and Mac users can click Ctrl+Space to launch the auto-suggestions dropdown menu.

Scans can be a maximum of 8000 characters long; a message below the Scan Criteria Box shows you how many characters you can still add to your scan. If you click the Reformat button at the bottom of the Scan Criteria Box, it will automatically format the clauses in your scan, putting each clause on its own line. This will clean up a messy scan.

If you want to start over, clicking the Reset Criteria button below the Scan Criteria Box will remove all scan criteria from the box and reset it to the default criteria.

The Advanced Scan Workbench offers two ways to check for errors in the syntax of your scan: the “Check Syntax” button (below the Scan Criteria Box) and the in-line error and warning messages (to the left of each line of the scan). See the Checking Syntax section later in this article for more details on checking your scan clause for errors.

Scan Components

Use the Scan Components area to insert common clauses into the scan you're building. It allows you to enter the clause and ensure that the syntax is correct, a handy tool when you're unsure of the exact syntax to use.

The clauses in the Scan Components area are broken down into several different categories, and each has a dropdown menu. Once you select a clause from one of the menus, click the Add button to append the clause (with its default settings) to the scan in the Scan Criteria Box with its default settings. You can manually modify these default settings in the Scan Criteria Box.

Managing Your Scans

Once you've built your scan, save the scan criteria and reuse it whenever you want without reentering all the filters. StockCharts Basic members can save just one custom scan, Extra members can save up to 200 custom scans on their account, and Pro members can save up to 500. The number of scans you have available will be displayed at the top of the Advanced Scan Workbench.

The Scan Management area of the Advanced Scan Workbench allows you to add, modify, delete, and view your saved scans.

You can save a new scan by clicking the “Save As” icon in the Scan Management area. You will be prompted to enter a name for your scan. Choose a name that will help you find it again later. Your scans will be listed alphabetically by name, so you may want to add a prefix to each scan name in order to group your scans by the main indicator used or, alternately, by bullish vs. bearish scans. (Use whatever form of organization is most useful to you.)

To load a saved scan in the Advanced Scan Workbench later, click the “Your Saved Scans” dropdown menu in the Scan Management area and find your scan on the list. Scans are arranged alphabetically by scan name. You can tell which saved scan is loaded in the Scan Criteria Box, as the name of the currently loaded scan will be displayed in this dropdown box.

If you make changes to your saved scan, save them by clicking the “Save” icon in the Scan Management area. To save a copy of the scan, click the “Save As” icon and give it a different name. To rename your scan without creating a new copy, click the “Rename” icon and give the existing scan a new name.

If you no longer need a scan, delete it by loading it in the Scan Criteria Box and clicking the “Delete” icon in the Scan Management area.

To view all your saved scans on a single page, click the “See All” icon in the Scan Management area. This page will display the scan name and syntax for each saved scan. If you wish to remove one or more scans from this view, check the box to the left of the scan's name and click the red “Delete Selected Scans” button.

Using Your Scan

Once your scan has been built, running it will be fairly simple. However, there are a couple of steps you might want to take before pressing the “Run Scan” button.

The Starting Date Adjuster

Before running your scan, you can use the Starting Date Adjuster to specify which day of data the scan will be run against. This can be used to see historical signals or results for a past scan - i.e., the results that the scan would have returned at some point in the past.

The default setting is 0 days before the Last Intraday Update (during market hours) or Last Market Close (outside of market hours). Most of the time, you'll want to find stocks that meet the criteria right now, so the default settings will be just fine.

If you need to change the settings, you can specify that your scan should start up to 3000 trading days (roughly 12 years) in the past. Keep in mind that, depending on your scan criteria, the further back you go, the less accurate your results will be. Specifically, exponential moving average calculations require a much larger number of data points to be accurate. EMAs with large offsets are prone to inaccuracies.

When you click in the “Starting” box, a popup calendar will display the associated date for that offset value (the offset date has a white background and orange text). Alternatively, if you click on a date in the calendar, that offset will be put into the “Starting” box. The offset will be relative to either the latest intraday update or the last close, based on the selection in the dropdown menu.

Note: The Scan Engine will only run the scan on one date at a time. It cannot run a single scan over a date range. For example, one may wish to run a scan for 52-week highs on the dates within the range of September 4th through 7th. Currently, this requires four separate scans using the appropriate date offsets.

Checking Syntax

It's always a good idea to check the syntax before running your scan to ensure there are no errors to address. The Advanced Scan Workbench offers two ways to check your scan for syntax errors.

The Check Syntax Button

To check for errors across the entire scan, click the “Check Syntax” button below the Scan Criteria Box.

If there is a syntax error, text will appear at the bottom of the box that identifies the problem. If you see the message below, you are ready to run the scan.

Your scan syntax is correct. Click "Run Scan" to view the results.

Note: If this is your main mode of error checking, we recommend clicking this button after each scan clause you add or modify to ensure there are no errors in that clause. Spotting a mistake after adding a single clause is usually much faster than trying to spot a mistake after entering twenty clauses.

In-Line Error Checking and Auto-Fixing

There's a more detailed option for syntax checking in the Advanced Scan Workbench. Errors are now listed right next to the problem line of your scan, making it easy to figure out which line to fix. If you mouse over the red error or yellow warning icon to the left of the line, as shown below, a popup message will give you more detailed information about the problem. We've also added some warning messages, alerting you to potential problems that would not prevent your scan from running but may not give the results you intended. A drop-down menu at the bottom of the Scan Criteria Box allows you to switch between showing errors only or both errors and warnings.

For selected errors, the workbench can now auto-fix the error for you with the click of a button. For example, if you leave out the “and” between two clauses, you will see a red error icon to the left of the line containing those clauses. If you mouse over the error icon, a message will appear informing you that you've left out the clause joiner and offer to fix it, as shown above. Click on the error icon to automatically insert the missing “and” into your scan.

Running the Scan

To run the scan, click the green “Run Scan” button below the Scan Criteria Box. The results will launch in a new tab or window.

Scheduled Scans

In addition to running your scan manually, you can schedule your scan to run at a certain time each day. The scan results can be saved to a new or existing SharpCharts or ACP ChartList, and you will receive an email with a link to the scan results for that day.

The page allows you to schedule new scans and view/manage your existing scans, all from the same page:

Scheduling a Scan

Scheduling a scan from the New Scheduled Scans section of the page takes just a few simple steps:

  1. Choose the saved scan you want to schedule from the dropdown list.

  2. Choose when you would like the scheduled scan to run each day—market open, market close, or a custom time. You can also choose which days of the week to run the scan by clicking the buttons in the Run Days section. By default, the scan is run on weekdays only.

  3. Choose the location for the scan results—save them in a new ChartList, use them to overwrite an existing ChartList, or merge them into an existing ChartList.

  4. Click the green Save Scheduled Scan button.

Once your scheduled scan is saved, it will run automatically at the specified time and place the scan results in the SharpCharts or ACP ChartList you specified. It will also send you an email with a link to view your scan results.

Note: If you do not wish to receive the email notification when your scheduled scan is run, uncheck the "Send email with scan results" checkbox when configuring your scheduled scan.

Viewing Your Scheduled Scans

The Your Scheduled Scans section of the page will show all of the scans you have scheduled in a table with the following columns:

  • Scan Name: Shows the name of the scan you have scheduled. To edit the scan, click on its name to go to that scan in the Advanced Scan Workbench.

  • Run Days: Shows the days of the week on which the scan is scheduled to run.

  • Run Time: Shows the time that the scan is scheduled to run each day (in UTC time).

  • Action; Specifies whether the results will be put in a new ChartList, used to replace an existing ChartList, or merged into an existing ChartList.

  • List: Shows the name of the ChartList with a link to view the list in Summary View (or in StockChartsACP for ACP ChartLists).

  • Last Run: Shows the date and time the scan was last run (in UTC time).

  • Results: Indicates whether or not the last run was successful. It may also give more details about whether any results were returned and whether they were truncated due to ChartList size limits.

  • Actions: Click the icons to play/pause the scheduled scan, delete it, or edit it, respectively.

Note: Extra members can schedule up to 10 scans, and Pro members can schedule up to 25 scans on their account. Basic members cannot schedule scans.

ChartLists Created By Scheduled Scans

When you choose to save your scheduled scan results into a brand new ChartList, the ChartList name is always prefixed with "Scheduled Scan", along with the scan name and the date the ChartList was created, so that it is easily identifiable.

Fourteen days after a ChartList is automatically created by a scheduled scan, the ChartList is considered "expired" and removed from your account. If you do not want the ChartList to be removed after 14 days, rename the ChartList to remove the "Scheduled Scan" part of the list's name.

To edit the ChartList's name, go to Edit View for that ChartList, click on the current ChartList name so it becomes an active text box, change the name of the list, and save.

The Bottom Line

The Advanced Scan Workbench is a powerful tool for creating, managing, and running scans. While learning how to write effective scans takes time and effort, the Scan Components area and other features of the Advanced Scan Workbench can significantly lower the learning curve.

Additional Resources

Reference Guides

Articles

Tutorials

Videos

This article will introduce you to the main features of the Advanced Scan Workbench but does not cover the details of writing scans. For more information on using our scan “language,” please see our article in the Support Center. In addition, check out our to learn the specific syntax for each scan clause we support.

From , click the Advanced Scan Workbench link in the Member Tools section, or...

Cool Tip. If you find yourself entering the same starting scan criteria repeatedly, put those criteria in a saved scan so you can call them up each time you start a scan. See our article in the Support Center for step-by-step instructions.

Learn More.

Learn More:

For more details on the specific clauses and their syntax, please click the links below to go to the appropriate section of the .

. Clauses for filtering by security type, symbol, name, country, exchange, and more.

. Clauses for standard price and volume measurements (OHLC values, all-time highs, volume, liquidity, etc.). Also includes SCTR ranking clauses.

. Clauses for several popular technical indicators. Also includes clauses for standard arithmetic functions, such as min/max and percent change; see the section of the Scan Syntax Reference for details on these functions.

. Clauses for bullish and bearish candlestick patterns, such as hammers or morning stars. Also includes Elder Bar and Ichimoku Cloud patterns. These are all true/false clauses, which indicate whether the pattern is currently present for that stock.

. Clauses for more discrete candlestick patterns, called candlestick building blocks. They include everything from dojis to spinning tops. These are all true/false clauses, indicating whether the pattern is currently present for that stock.

. Clauses for standard bullish and bearish P&F patterns, such as bullish triangles and double-bottom breakouts. These are all true/false clauses, indicating whether the pattern is currently present for that stock.

. Clauses for several popular bullish and bearish technical indicators are found on our Predefined Scans page, from MACD crossovers to 52-week highs/lows.

. Clauses to filter stocks by membership in various indexes (e.g., limiting to stocks that are in the S&P 500), as well as ETF clauses that allow you to limit your results to non-inverse or leveraged ETFs.

. Clauses to limit your scan results to stocks in a particular SharpCharts or StockChartsACP ChartList. In the scan clause, the ChartList will be identified by number, but a comment to the right of the clause will show the ChartList's name.

. Clauses that limit your scan results to stocks that are (or are not) in a particular sector or industry. We currently offer scanning for US and Canadian sectors and industries only. Select “US” or “CA” from the dropdown menu before choosing a sector or industry.

Learn More.

Learn More.

Check out the article in the Support Center for more information on getting the most out of your scan results.

To access Scheduled Scans from , click the “Scheduled Scans” link in the “Member Tools” section or click the “More” button in the “Your Scans” section of the page and choose “Scheduled Scans.” You can also access Scheduled Scans from the Advanced Scan Workbench by clicking the Scheduled Scans tab at the top of the workbench.

Learn More:

Writing Scans
Scan Syntax Reference
Your Dashboard
Scan Templates
Scan Syntax Reference
Scan Syntax Reference
Scan Syntax Reference
Ticker Properties
Price, Volume, and SCTRs
Technical Indicators
Technical Functions
Predefined Scans
Scanning Over a Range of Dates
Working with Scan Results
Your Dashboard
Edit View
Scan Syntax Reference
Scanning Over a Range of Dates
Create Your Own Scan Templates
Scan Workbench Tutorial 1: Advanced Scan Workbench
Advanced Scan Workbench: The Basics
Advanced Scan Workbench: Managing Scans
Export a Standard Scan to the Advanced Scan Workbench
Indexes and ETFs
ChartLists
Sectors and Industries
Candlestick Patterns
Candlestick Building Blocks
P&F Patterns