stockPrediction

Stock & Crypto Prediction Platform (MVP)

MVP monorepo with:

• Next.js dashboard (apps/web)
• FastAPI backend (backend/api)
• Python worker for ingestion, training, and settlement (backend/worker)
• TimescaleDB + Redis via Docker Compose

What MVP Includes

• 5-minute OHLCV ingestion:
  • Binance for crypto (BTCUSDT, ETHUSDT)
  • Polygon for stocks (AAPL, MSFT, SPY)
• OHLCV-based feature engineering (EMA, RSI, MACD, volatility, volume change, lagged returns)
• 1-hour return prediction using XGBoostRegressor
• APIs:
  • POST /api/v1/predict
  • GET /api/v1/price
  • GET /api/v1/history
  • POST /api/v1/feedback
• Redis prediction caching
• Prediction history and feedback capture
• Dashboard with chart, predict flow, and history table

Quick Start

1. Copy env template:

   cp .env.example .env
   

2. Set POLYGON_API_KEY in .env (required for stock ingestion).
3. Start services:

   docker compose up --build
   

4. Open:
   • Web: http://localhost:3000
   • API docs: http://localhost:8000/docs

Useful Commands

• One-off backfill + train (inside worker container):

  docker compose run --rm worker python -m backend.worker.bootstrap --days 30
  

• Run worker once (ingest + settle + train-if-needed):

  docker compose run --rm worker python -m backend.worker.scheduler --once
  

Tests

• Python tests:

  pip install -r requirements-dev.txt
  pytest -q
  

• Web tests:

  cd apps/web
  npm install
  npm test
  

Notes

• This project is for educational/research use and must not be treated as financial advice.
• API keys are server-side only via environment variables.