Repository navigation
Home
Savvas Leousis edited this page Sep 26, 2026
·
3 revisions
Stonks is a research and trading system for stocks, crypto, commodities and bonds. It collects market data into a local database, tests trading strategies hard before trusting them, and runs a daily "tick" that trades the approved ones. Trading is simulated by default; an Alpaca paper account is opt-in.
flowchart LR
C[Collect<br/>market data] --> R[Research<br/>backtest + lab]
R --> A[Approve<br/>shadow, go-live, promote]
A --> T[Trade<br/>daily tick per portfolio]
T --> W[Watch<br/>health, P&L, alerts]
W -. learn .-> R
| Stage | What happens | Main command |
|---|---|---|
| Collect | Pull prices and fundamentals into the lake | stonks ingest prices |
| Research | Tune a strategy and run survival tests | stonks lab run |
| Approve | Register in shadow, pass go-live, a human promotes |
stonks golive check, stonks registry promote
|
| Trade | Score, build each portfolio, apply risk limits, place orders | stonks tick |
| Watch | Check freshness, P&L and alerts |
stonks health, stonks pnl, stonks report
|
The built-in scheduler runs the daily loop for you. See Scheduling and Backups.
Start
Concepts
- Architecture
- Data and Storage
- Strategies and 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
- API Reference (interactive: Swagger UI)
- MCP Tools
- Configuration
- Testing and CI
- Roadmap
- Glossary
- Credits
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