surpriver

Why we included this project

Surpriver ranks your stock watchlist by how unusual the recent price and volume patterns look, with the idea that odd patterns often precede big moves. It pulls history from Yahoo Finance, builds return features and technical indicators, then runs anomaly detection to flag the few tickers that stand out from their own past behavior. The code is a short set of Python modules with a Docker setup, so you can read the whole pipeline in an afternoon and tweak the stock list or the feature set. That makes it a solid learning tool for anyone curious how anomaly detection behaves on real financial time series rather than clean toy data. It is not a live trading system or investment advice; treat it as a compact reference you can take apart and rebuild for your own experiments.