Repository navigation
Credits
Stonks builds on public research, books and open-source libraries.
flowchart LR
R[neurotrader888 research] --> S[Strategies and tests]
B[Trading books] --> P[Principles and backlog]
L[Open-source libraries] --> C[Stonks code]
Ports of github.com/neurotrader888. Each is Stonks' own implementation of the published algorithm; no code is copied. Every module docstring names its source and lists deviations. Shorts became flat, because the broker is long-only.
| Repo | License | Used for |
|---|---|---|
| mcpt | MIT |
ma_crossover, permutation test ideas |
| VolatilityHawkes | MIT | volatility_hawkes |
| TimeSeriesVisibilityGraphs | MIT | visibility_graph_path |
| VSAIndicator | MIT | vsa |
| TechnicalAnalysisAutomation | MIT |
market_profile_sr, head_shoulders, flag_pennant, harmonic_xabcd, pip_miner, extremes helpers |
| market-structure | MIT | market_structure_break |
| PermutationEntropy | MIT | feature_regime_filter |
| TimeSeriesReversibility | MIT | feature_regime_filter |
| TradeDependenceRunsTest | MIT |
feature_regime_filter, last_trade_filter
|
| TrendlineBreakoutMetaLabel | MIT | trendline_meta_label |
| TVLIndicator | MIT | tvl_deviation |
| IntramarketDifference | none |
intramarket_difference, rebuilt from its algorithm description only; no code read |
Reading list for roadmap Phase 7, studied from legal sources only (open-access editions, author sites and papers, companion code).
Systems, sizing and risk
- Ernest Chan, Quantitative Trading, Algorithmic Trading
- Robert Carver, Systematic Trading
- Kevin Davey, Building Winning Algorithmic Trading Systems
- Perry Kaufman, Trading Systems and Methods
- Rishi Narang, Inside the Black Box
- Ralph Vince, The Mathematics of Money Management
- Andreas Clenow, Following the Trend, Stocks on the Move
- Adam Grimes, The Art and Science of Technical Analysis
Markets, fundamentals and portfolios
- Burton Malkiel, A Random Walk Down Wall Street
- John Bogle, The Little Book of Common Sense Investing
- Larry Harris, Trading and Exchanges
- Benjamin Graham, The Intelligent Investor
- Peter Lynch, One Up on Wall Street
- Wesley Gray, Quantitative Value
- Richard Grinold and Ronald Kahn, Active Portfolio Management
- Igor Tulchinsky, Finding Alphas
- Boyd, and market history classics
Statistics, time series and ML
- Marcos Lopez de Prado, Advances in Financial Machine Learning
- Stefan Jansen, Machine Learning for Algorithmic Trading
- Matthew Dixon et al., Machine Learning in Finance
- Ruey Tsay, Analysis of Financial Time Series
- James Hamilton, Time Series Analysis
- David Ruppert, Statistics and Data Analysis for Financial Engineering
- John Ehlers, Cycle Analytics for Traders
- Dan Stefanica, A Primer for the Mathematics of Financial Engineering
- Steven Shreve, Stochastic Calculus for Finance
Execution, volatility and engineering
- Robert Kissell, The Science of Algorithmic Trading and Portfolio Management
- Barry Johnson, Algorithmic Trading and DMA
- John Hull, Options, Futures, and Other Derivatives
- Sheldon Natenberg, Option Volatility and Pricing
- Euan Sinclair, Volatility Trading
- Jim Gatheral, The Volatility Surface
- Paul Wilmott, Paul Wilmott Introduces Quantitative Finance
- Yves Hilpisch, Python for Finance
- Wes McKinney, Python for Data Analysis
- Brett Slatkin, Effective Python
- Strimpel, Scarpino
Plus the Axon "100 books" series, deduplicated against the above.
The synthesis is docs/principles.md and the backlog docs/research/book-lessons.md in the repo. Strategies built from the books: Book Strategies.
| Library | Used for |
|---|---|
| DuckDB | The lake |
| SQLite (Python stdlib) | State |
| pandas, NumPy | Data handling |
| pydantic, pydantic-settings | Settings and schemas |
| structlog | JSON logs |
| Typer, Rich | CLI and tables |
| requests, python-dotenv | EODHD client, .env loading |
| yfinance | Yahoo source (behind DataSource) |
| alpaca-py | Alpaca broker (behind Broker) |
| scikit-learn | ML strategies (behind classifier and clusterer seams) |
| SciPy | Statistics (PSR, deflated Sharpe, bootstrap, HAC) |
| exchange-calendars | Market calendars (behind scheduling.calendar) |
| cryptography | Encryption of stored broker credentials |
| pywebpush | Web Push notifications (behind a notification channel) |
| filelock | Store and scheduler locks |
| FastAPI, Uvicorn | REST API |
| mcp | MCP server (official Python SDK) |
| httpx2 | HTTP client for MCP and tests |
| pytest, pytest-xdist, ruff, uv | Tests, lint, packaging |
| Angular | The web console |
| Docker, Caddy, Tailscale, restic, Terraform | Deployment |
Source: sleousis/Stonks. Plans and status: docs/roadmap.md.
Start
Concepts
- Architecture
- Data and Storage
- Strategies
- Book Strategies
- Lab and Validation
- Backtesting
- Accounts and Modes
Using Stonks
- Strategy Studio
- Trading Tick
- Risk and Go-Live
- Operations
- Scheduling and Backups
- Deploy
- API and MCP
- Web Console
Reference