Parabolic Precursor Scanner
Testing & User Guide
Prepared for: Mr. Per (danskdesign)
Project: Order B - Python Stock Scanner
Developer: Nouman Ahmed
Version: 3.0 (Dual-Mode Detection)
Document: Comprehensive Testing & Operations Guide
This document walks you through testing every feature of your scanner, verifying that all your
requirements are met, and using the dashboard day-to-day.
1. What You Are Getting
This package implements your full Milestone 1 requirements plus several extras built during
development to make day-to-day use easier. Here is a side-by-side checklist of what you asked for
and what is delivered.
# Your Requirement Delivered
1 Scan all stocks $0.05-$5.00 every 30 minutes Yes
2 Daily signal list at 7:00 AM CET Yes (auto morning report)
3 Dashboard with Signals tab (today only) Yes
4 Lists Mon-Fri, 1 year archive Yes (SQLite + auto-cleanup)
5 Each entry: Company, Ticker, Sector, TV link Yes
6 CSV export importable into TradingView Yes (plain ticker format)
7 Telegram notifications Yes (configurable from dashboard)
8 Dashboard shareable with friends via URL Yes (network-exposed)
9 Full access to all code and services Yes (all source provided)
10 Deploy on DigitalOcean / Azure Yes ([Link] + systemd unit)
11 Configurable SMA200 drop threshold Yes (Settings tab sliders)
Extras Beyond Your Requirements
• Dual detection engine - You can choose between Mode A (strict classic flat), Mode B (your
requested directional logic), Mode AB (signal if either fires), or Mode AND (signal only if both
confirm). Switchable from the dashboard with a single click.
• Signal strength badges - Each signal is tagged STRONG (RVOL 8x+), MEDIUM (5x+), or
NORMAL so you and your friends can prioritise at a glance.
• Manual scan trigger - A 'Run Full Scan Now' button on the dashboard lets you kick off a scan
outside the 30-minute schedule.
• Custom watchlist - You can add specific tickers that should always be scanned, even if they
fall outside the $0.05-$5.00 range.
• Live notification setup - Telegram bot token and chat IDs editable from the dashboard. No
need to edit code or config files.
• Auto-refresh - Dashboard refreshes itself every 60 seconds so your friends viewing via URL
always see the latest signals.
• Sector breakdown chart - Visual bar chart of how many signals fired in each sector today.
• Mode breakdown stats - See exactly how many signals each detection mode is finding.
2. Installation Status
The scanner is already installed and tested on the developer's machine. When deployed to your VPS,
the same setup script handles everything automatically. You will receive:
• SSH access to your DigitalOcean droplet (or Azure VM)
• Dashboard URL like [Link] - share this with friends
• Source code repository with all 13 Python files plus setup scripts
• Telegram bot token if you want us to create the bot, or use your own
• Polygon API key already configured in the system
Note: The dashboard is the only thing you actually need to interact with. The scanner runs in the
background as a systemd service and restarts automatically if the server reboots. Everything else is
operational and self-managing.
3. The Dashboard - Your Main Interface
Open the dashboard URL in any browser (Chrome, Safari, Edge, mobile browsers all work). You will
see a sidebar with live status and seven tabs across the top:
Signals
Today's signals only - sorted by RVOL by default, filterable by sector and detection mode. Each row
has a clickable TradingView chart link. Top 5 signals are highlighted with strength badges. CSV and
watchlist downloads at the bottom.
Historical
Date picker to view any past day in the last 365 days. Shows the same columns and CSV download
for that day.
Monthly Archive
Pick any month, see all signals grouped by date in collapsible sections. Useful for backtesting and
reviewing past performance.
Scanner Status
Manual scan trigger, recent scan logs (time, tickers scanned, signals found, errors, duration), and
current configuration as JSON.
Settings
All detection parameters editable. Slider for SMA200 max slope (your specific request), volume
multiplier, price range, SMA proximity, cooldown. Detection mode selector at the top (A / B / AB /
AND).
Notifications
Telegram bot token, chat IDs, and Discord webhook URLs all editable here. Test buttons send a test
message to verify the connection works.
Watchlist
Custom ticker list - tickers you want monitored every cycle even if they move outside $0.05-$5.00.
Save and scan-now buttons.
4. Step-by-Step Test Plan
This is the complete sequence to verify every feature is working end-to-end. Each test takes 1-3
minutes. Total time: about 30 minutes.
Test 1: Open the Dashboard
Open [Link] in your browser. You should see:
• Green pulsing dot in the sidebar indicating 'Auto-refresh ON'
• A 'Today's Signals' counter (will be 0 if scanner has not run yet)
• Detection mode shown in the sidebar (default: B)
• Five metric cards at the top: Signals Today, Sectors, Avg RVOL, Last Scan
Expected: Page loads in under 3 seconds. No error messages.
Test 2: Configure Telegram
Click the Notifications tab. Enter your Telegram bot token and chat ID, then click Test Telegram
Connection.
Setup steps if you do not have a bot yet:
1. Open Telegram, search for @BotFather
2. Send /newbot, choose a name and username
3. Copy the token BotFather gives you (looks like 123456:ABC...)
4. Open a chat with your new bot, send any message
5. Visit [Link] in browser
6. Find the 'chat':{'id': NUMBER} - that NUMBER is your chat ID
Expected: Green success message and a test message arrives in your Telegram chat within 5
seconds.
Test 3: Run a Manual Full Scan
Click the Scanner Status tab, then the Run Full Scan Now button. The scan runs in the background
(15-30 minutes for ~4,200 stocks).
Expected: While running, the scan log will eventually show a new row with the start time, tickers
scanned count, and signals found. If signals were detected, your Telegram and the Signals tab will
show them.
Test 4: Verify Signal Display
After a scan completes (or any time signals exist), go to the Signals tab. You should see:
• Top 5 signals with strength badges (STRONG/MEDIUM/NORMAL) and mode badges
(A/B/AND)
• A full table below with sortable columns: Ticker, Company, Sector, Price, RVOL, etc.
• A clickable 'Open Chart' link in the rightmost column that opens TradingView Supercharts in a
new tab
• Sector breakdown bar chart at the bottom
• Two download buttons: CSV and TradingView Watchlist (.txt)
Test 5: Test Detection Mode Switch
Go to Settings tab. Change Detection Mode from B to AB and click Save All Settings. Then go to
Scanner Status and run another manual scan. Compare the number of signals to your previous Mode
B scan.
Expected: Mode AB will produce equal or more signals than Mode B alone, because any signal from
either mode will fire. Mode AND will produce equal or fewer.
Test 6: Verify Configurable SMA Slope
This is the feature you specifically requested - the ability to control how much the SMA200 is allowed
to drop.
On the Settings tab, find Mode B: Directional section. Move the Max SMA200 slope slider to a high
value like 1.0%/bar. Save settings and run a scan. Compare against running with the slider at
0.1%/bar.
Expected: Higher slope tolerance produces more signals (allows tickers with mildly declining
SMA200 through). Lower slope is stricter (only nearly-perfectly-flat bases pass).
Test 7: Test CSV Export and TradingView Import
On the Signals tab, click Download CSV. Open the file in Excel or any text editor to verify content.
Then click TradingView Watchlist (.txt) to download the watchlist. In TradingView:
• Open the Watchlist panel
• Click the menu icon, choose 'Import list'
• Upload the .txt file
• All tickers from today's signals appear in your watchlist
Test 8: Custom Watchlist
Go to Watchlist tab. Enter some tickers comma-separated, e.g., UGRO, AIXI, MOBX. Click Save
Watchlist, then Scan Watchlist Now.
Expected: Scan completes in under a minute (since it is only a few tickers). Any signals appear in the
Signals tab and Telegram.
Test 9: Historical and Monthly Tabs
Click Historical tab, pick yesterday's date or any past date. View signals for that day. Then click
Monthly Archive, pick a month, expand a date row.
Expected: Both views show the same data for matching dates. Signal counts match what was
reported on those days.
Test 10: Share With a Friend
Send the dashboard URL to a friend (or open it on your phone using mobile data, not WiFi, so you
simulate an external user). Verify they can:
• Open the URL successfully
• See current signals
• Click TradingView links and have them open correctly
• Download CSV files
Note: By default, the dashboard is read-only for external viewers in the sense that they can browse
signals and download data, but settings changes apply globally. If you need stricter access control,
we can add password protection in a follow-up update.
5. Detection Modes Explained
Your scanner ships with two detection engines. You can use either alone, both together, or require
both to agree.
Mode A: Classic Flat (Order A logic)
This is the strict version. The SMA200 must be genuinely flat - rising and falling are both penalised.
Volume must exceed the highest down-day volume in the recent base. Price must be tightly hugging
the SMA. This produces fewer signals but they are the highest quality.
Default thresholds: SMA slope 0.15%/bar maximum (both directions), volume must exceed highest
down-day volume in last 60 bars, price within 5% of SMA200.
Mode B: Directional (your preferred logic)
This matches your specific request: signals should fire when SMA200 is flat or rising, and only when it
is falling slowly. The asymmetric treatment means an obvious uptrend with a volume spike still counts
as a signal.
Default thresholds: rising SMA always passes, falling SMA blocked if slope worse than -0.3%/bar.
Volume must be at least 3x the 100-bar median AND the highest of the last 60 bars. Price within
+/-10% of SMA200.
Mode AB: Either Triggers
Maximum coverage. A signal fires if either Mode A or Mode B detects something. Use this if you want
to see everything and filter manually. Each signal is tagged with which mode fired it (A or B badge).
Mode AND: Both Required
Highest confidence. A signal only fires if both modes detect it independently. Far fewer signals but
each one is double-confirmed. Useful if you only want to act on the strongest setups.
My recommendation: Start with Mode B (your originally requested logic), monitor for a week, then
experiment with Mode AB to see if you are missing signals. Switch to Mode AND if you find Mode B
is too noisy.
6. Reading a Signal
Each signal you receive (in the dashboard, on Telegram, or in the CSV) contains these fields:
Field Meaning
Mode Which detection mode fired the signal (A, B, or AND)
Ticker Stock symbol (e.g., UGRO)
Company Full company name from Polygon reference data
Sector SIC industry classification
Price Last bar close price in USD
RVOL Relative volume - how many times bigger than baseline. Higher = stronger signal
SMA200 200-period Simple Moving Average value
SMA Slope % Rate of change of SMA200 per bar. Negative = falling, positive = rising
Dist SMA % Where price is relative to SMA200. Negative = below, positive = above
Volume Actual volume on the trigger bar
Time When the signal fired (UTC)
TradingView Direct link to that ticker's 30-min chart
7. Day-to-Day Operation
Your Morning Routine
At 7:00 AM CET each weekday, you will receive a Telegram message titled Daily Signal Report with
all signals from the previous evening session and overnight scan, grouped by sector. Each ticker is a
clickable link to its TradingView chart.
Open the dashboard, click the Signals tab, sort by RVOL descending. Top 5 will be highlighted with
strength badges. Click charts that interest you. Download the CSV if you want to import everything
into TradingView.
During the Trading Day
New signals arrive on Telegram in real-time as they fire (up to 30-min delayed due to scan schedule).
The dashboard refreshes itself every 60 seconds, so leaving it open in a tab shows the live state.
After Hours
The scanner continues to fire signals during pre-market and after-hours sessions if Polygon provides
the data. You will see them on the dashboard but tagged by their bar close time. Most parabolic
precursor moves happen during regular hours, so this is mostly a bonus.
Adjusting Sensitivity
If you find you are getting too many signals, go to Settings and tighten parameters:
• Increase the volume multiplier (3.0 -> 5.0 will require stronger volume spikes)
• Decrease the SMA slope tolerance (0.3 -> 0.1 will only allow nearly-flat bases)
• Decrease the SMA proximity (10% -> 5% will only catch signals close to the mean)
• Switch to Mode AND for the strictest filtering
If you want more signals, do the opposite:
• Decrease the volume multiplier
• Increase the SMA slope tolerance
• Increase the SMA proximity
• Switch to Mode AB
8. Troubleshooting
Q: Dashboard shows 'No signals today'
A: This is normal if no stocks meet all gates. The scanner only fires when SMA is flat/rising AND
volume spikes AND price is in range. On flat market days you may get zero signals.
Q: Telegram messages not arriving
A: Go to Notifications tab, click Test Telegram Connection. If it fails, check that your bot token is
correct and that you have sent at least one message to your bot from your Telegram account so it
can reach you.
Q: Last Scan time is hours old
A: Check the Scanner Status tab. If the scan_log shows errors, the issue is usually a Polygon API
rate limit or network problem. Click Run Full Scan Now to force a new scan.
Q: Charts show wrong ticker exchange
A: TradingView auto-resolves ticker symbols. If a ticker is ambiguous (e.g., trades on multiple
exchanges), TradingView will pick the primary listing. Edit the chart manually to switch exchange if
needed.
Q: Settings changes not taking effect
A: Settings apply on the next scan cycle. If you want them immediately, run a manual scan from the
Scanner Status tab.
Q: Signals appearing for wrong price range
A: Check Settings tab - verify Min Price and Max Price are what you expect. The custom watchlist
always scans regardless of price range.
9. What Is Next
Your Order B (this scanner) is now complete and operational. When you are ready, Milestone 2 (the
Statistics dashboard you described) is the next phase. We are also ready to:
• Add password protection to the dashboard for selective sharing
• Add a backtest tab showing historical performance of each detection mode
• Connect to your broker for automated order placement (your Milestone 2 plan)
• Add news integration so each signal includes the latest news for that ticker
• Add float / short-interest data to signals (subject to Polygon plan)
Just send a message on Fiverr whenever you want to discuss any of these.
Need help?
I am available on Fiverr for any questions, issues, or future enhancements.
Even after 6 months from order completion, if you need any change or fix, I will handle it
without extra cost. That is my standing commitment for every project.
Best,
Nouman