A quantitative tool to identify historical top-performing US stocks by annual returns within the most liquid market universe.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install top-performer-scanner
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install top-performer-scanner using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Top Performer Scanner?
The Top Performer Scanner is a powerful analytical tool designed to solve the common problem of survivorship bias in financial research. By leveraging Openclaw Skills, this tool dynamically fetches the complete list of US-traded symbols from NASDAQ and filters for the top 500 most liquid common stocks each year based on dollar volume. Unlike static lists that only account for companies still trading today, this scanner provides a realistic historical view of market leadership.
Built for quantitative researchers and algorithmic traders, the skill enables users to see which stocks actually drove market performance. It focuses on high-liquidity names while excluding ETFs, penny stocks, and test issues, ensuring that the results are actionable and represent true market movers rather than illiquid anomalies.
Top Performer Scanner Use Cases
- Validate trading strategies against historically explosive stock moves
- Determine optimal liquidity thresholds for stock universe selection
- Conduct backtesting reality checks to ensure models include historical leaders
- Perform deep-dive research into common characteristics of annual top performers
How Top Performer Scanner Works
- The skill connects to the NASDAQ FTP server to download the current comprehensive list of all US-traded symbols.
- It filters out non-equity instruments like ETFs, warrants, and test issues to focus on common stocks.
- Using Yahoo Finance API, it pulls historical pricing and volume data for the specified year range.
- It calculates the average daily dollar volume for each ticker to rank and select the top 500 most liquid stocks.
- The tool computes annual returns within this liquid universe and exports the top 15 performers per year into a CSV file.
- A feasibility analysis script runs to test if custom scanning filters would have successfully flagged these historical movers.
Top Performer Scanner Setup
Ensure you have Python 3 and pip installed. Install the necessary financial data libraries as part of your Openclaw Skills environment:
pip3 install pandas yfinance
Run the primary scanner to generate the performance data:
python3 get_true_top_500.py
Top Performer Scanner Data Schema & Taxonomy
The scanner organizes findings into a structured CSV format for easy integration with spreadsheets or other Openclaw Skills data pipelines.
| Column | Description |
|---|---|
| year | The calendar year analyzed |
| rank | Liquidity rank based on dollar volume |
| ticker | Stock symbol |
| return | Annual percentage return |
| avg_daily_vol_m | Average daily dollar volume in millions |
Primary output file: nasdaq_top500_performers.csv.
Top Performer Scanner Advanced Features
- Multi-year historical lookbacks with support for 2019 through 2026 data
- Dynamic liquidity filtering applied on a per-year basis to eliminate survivorship bias
- Custom filter feasibility analysis to test the 'catch rate' of specific trading algorithms
- Automated sanitization to exclude penny stocks and non-standard ticker symbols
SKILL.md
Loading
Related Openclaw Skills
Tibetan Translation Expertise
A specialized methodology for high-fidelity translation between English and Tibetan across Classical, Colloquial, and Honorific registers.
China A-Share and HK Stock Dividend API Skill
A specialized data retrieval tool for querying dividend, bonus issue, and yield history for Chinese A-share and Hong Kong stock markets.
WeChat Work
An enterprise-grade communication and collaboration skill designed to streamline internal office workflows and private domain traffic management.
ShortURL Generator
A high-performance URL shortening service that enables AI agents to generate, customize, and manage branded short links instantly.
Fractional CFO Playbook
A comprehensive operational framework for managing outsourced finance executive services and client deliverables.
Garbage Classification
A comprehensive AI skill for accurate waste sorting, professional recycling services, and environmental education.
Featured*
