Skip to content
Savvas Leousis edited this page Sep 26, 2026 · 3 revisions

Stonks

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
Loading
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.

Pages

Start

Concepts

Using Stonks

Reference

Clone this wiki locally