Investing-signal platform for NASDAQ stocks. Surfaces the best trading opportunities through weighted multi-dimensional scoring — technical indicators, support/resistance quality, sentiment, fundamentals, and momentum — with asymmetric risk:reward scanning.

Philosophy: Don't predict price. Find the path of least resistance, key S/R zones, and asymmetric R:R setups.

Stack

Layer	Tech
Backend	Python 3.12+, FastAPI, Uvicorn, async SQLAlchemy, Alembic
Database	PostgreSQL (asyncpg)
Scheduler	APScheduler — OHLCV, sentiment, fundamentals, R:R scan
Frontend	React 18, TypeScript, Vite 5
Styling	Tailwind CSS 3 with custom glassmorphism design system
State	TanStack React Query v5 (server), Zustand (client/auth)
Charts	Canvas 2D candlestick chart with S/R overlays
Routing	React Router v6 (SPA)
HTTP	Axios with JWT interceptor
Data providers	Alpaca (OHLCV), OpenAI (sentiment, optional micro-batch), Fundamentals chain: FMP → Finnhub → Alpha Vantage

Features

Backend

Ticker registry with full cascade delete
Universe bootstrap for sp500, nasdaq100, nasdaq_all via admin endpoint
OHLCV price storage with upsert and validation
Technical indicators: ADX, EMA, RSI, ATR, Volume Profile, Pivot Points, EMA Cross
Support/Resistance detection with strength scoring and merge-within-tolerance
Sentiment analysis with time-decay weighted scoring
Fundamental data tracking (P/E, revenue growth, earnings surprise, market cap)
5-dimension scoring engine (technical, S/R quality, sentiment, fundamental, momentum) with configurable weights
Risk:Reward scanner — long and short setups, ATR-based stops, configurable R:R threshold (default 1.5:1)
Auto-populated watchlist (top-10 by composite score) + manual entries (cap: 20)
JWT auth with admin role, configurable registration, user access control
Scheduled jobs with enable/disable control and status monitoring
Admin panel: user management, data cleanup, job control, system settings

Frontend

Glassmorphism UI with frosted glass panels, gradient text, ambient glow effects, mesh gradient background
Interactive candlestick chart (Canvas 2D) with hover tooltips showing OHLCV values
Support/Resistance level overlays on chart (top 6 by strength, dashed lines with labels)
Data freshness bar showing availability and recency of each data source
Watchlist with composite scores, R:R ratios, and S/R summaries
Ticker detail page: chart, scores, sentiment breakdown, fundamentals, technical indicators, S/R table
Rankings table with configurable dimension weights
Trade scanner showing detected R:R setups
Admin page: user management, job status with live indicators, enable/disable toggles, data cleanup, system settings
Protected routes with JWT auth, admin-only sections
Responsive layout with mobile navigation
Toast notifications for async operations

Pages

Route	Page	Access
`/login`	Login	Public
`/register`	Register	Public (when enabled)
`/watchlist`	Watchlist (default)	Authenticated
`/ticker/:symbol`	Ticker Detail	Authenticated
`/scanner`	Trade Scanner	Authenticated
`/rankings`	Rankings	Authenticated
`/admin`	Admin Panel	Admin only

API Endpoints

All under /api/v1/. Interactive docs at /docs (Swagger) and /redoc.

Group	Endpoints
Health	`GET /health`
Auth	`POST /auth/register`, `POST /auth/login`
Tickers	`POST /tickers`, `GET /tickers`, `DELETE /tickers/{symbol}`
OHLCV	`POST /ohlcv`, `GET /ohlcv/{symbol}`
Ingestion	`POST /ingestion/fetch/{symbol}`
Indicators	`GET /indicators/{symbol}/{type}`, `GET /indicators/{symbol}/ema-cross`
S/R Levels	`GET /sr-levels/{symbol}`
Sentiment	`GET /sentiment/{symbol}`
Fundamentals	`GET /fundamentals/{symbol}`
Scores	`GET /scores/{symbol}`, `GET /rankings`, `PUT /scores/weights`
Trades	`GET /trades`
Watchlist	`GET /watchlist`, `POST /watchlist/{symbol}`, `DELETE /watchlist/{symbol}`
Admin	`GET /admin/users`, `POST /admin/users`, `PUT /admin/users/{id}/access`, `PUT /admin/users/{id}/password`, `PUT /admin/settings/registration`, `GET /admin/settings`, `PUT /admin/settings/{key}`, `GET/PUT /admin/settings/recommendations`, `GET/PUT /admin/settings/ticker-universe`, `POST /admin/tickers/bootstrap`, `POST /admin/data/cleanup`, `GET /admin/jobs`, `POST /admin/jobs/{name}/trigger`, `PUT /admin/jobs/{name}/toggle`, `GET /admin/pipeline/readiness`

Development Setup

Prerequisites

Python 3.12+
PostgreSQL (via Homebrew on macOS: brew install postgresql@17)
Node.js 18+ and npm

Backend Setup

# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Configure environment
cp .env.example .env
# Edit .env with your values (see Environment Variables below)

# Start PostgreSQL and create database
brew services start postgresql@17
createdb stock_data_backend
createuser stock_backend

# Run migrations
alembic upgrade head

# Start the backend
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

A default admin/admin account is created on first startup. Open http://localhost:8000/docs for Swagger UI.

Frontend Setup

cd frontend
npm install
npm run dev

Open http://localhost:5173 for the Signal Dashboard. The Vite dev server proxies /api/v1/ requests to the backend at http://127.0.0.1:8000.

Frontend Build

cd frontend
npm run build     # TypeScript check + production build → frontend/dist/
npm run preview   # Preview the production build locally

Tests

# Backend tests (in-memory SQLite — no PostgreSQL needed)
pytest tests/ -v

# Frontend tests
cd frontend
npm test

Environment Variables

Configure in .env (copy from .env.example):

Variable	Required	Default	Description
`DATABASE_URL`	Yes	—	PostgreSQL connection string (`postgresql+asyncpg://...`)
`JWT_SECRET`	Yes	—	Random secret for JWT signing
`JWT_EXPIRY_MINUTES`	No	`60`	JWT token expiry
`ALPACA_API_KEY`	For OHLCV	—	Alpaca Markets API key
`ALPACA_API_SECRET`	For OHLCV	—	Alpaca Markets API secret
`GEMINI_API_KEY`	For sentiment	—	Google Gemini API key
`GEMINI_MODEL`	No	`gemini-2.0-flash`	Gemini model name
`OPENAI_API_KEY`	For sentiment (OpenAI path)	—	OpenAI API key
`OPENAI_MODEL`	No	`gpt-4o-mini`	OpenAI model name
`OPENAI_SENTIMENT_BATCH_SIZE`	No	`5`	Micro-batch size for sentiment collector
`FMP_API_KEY`	Optional (fundamentals)	—	Financial Modeling Prep API key (first provider in chain)
`FINNHUB_API_KEY`	Optional (fundamentals)	—	Finnhub API key (fallback provider)
`ALPHA_VANTAGE_API_KEY`	Optional (fundamentals)	—	Alpha Vantage API key (fallback provider)
`DATA_COLLECTOR_FREQUENCY`	No	`daily`	OHLCV collection schedule
`SENTIMENT_POLL_INTERVAL_MINUTES`	No	`30`	Sentiment polling interval
`FUNDAMENTAL_FETCH_FREQUENCY`	No	`daily`	Fundamentals fetch schedule
`RR_SCAN_FREQUENCY`	No	`daily`	R:R scanner schedule
`FUNDAMENTAL_RATE_LIMIT_RETRIES`	No	`3`	Retries per ticker on fundamentals rate-limit
`FUNDAMENTAL_RATE_LIMIT_BACKOFF_SECONDS`	No	`15`	Base backoff seconds for fundamentals retry (exponential)
`DEFAULT_WATCHLIST_AUTO_SIZE`	No	`10`	Auto-watchlist size
`DEFAULT_RR_THRESHOLD`	No	`3.0`	Minimum R:R ratio for setups
`DB_POOL_SIZE`	No	`5`	Database connection pool size
`LOG_LEVEL`	No	`INFO`	Logging level

Production Deployment (Debian 12)

1. Install dependencies

sudo apt update && sudo apt install -y python3.12 python3.12-venv postgresql nginx nodejs npm

2. Create service user

sudo useradd -r -s /usr/sbin/nologin stockdata

3. Deploy application

sudo mkdir -p /opt/stock-data-backend
# Copy project files to /opt/stock-data-backend
cd /opt/stock-data-backend
python3.12 -m venv .venv
source .venv/bin/activate
pip install .

4. Configure

sudo cp .env.example /opt/stock-data-backend/.env
sudo chown stockdata:stockdata /opt/stock-data-backend/.env
# Edit .env with production values (strong JWT_SECRET, real API keys, etc.)

5. Database

DB_NAME=stock_data_backend DB_USER=stock_backend DB_PASS=strong_password ./deploy/setup_db.sh

6. Build frontend

cd frontend
npm ci
npm run build

7. Systemd service

sudo cp deploy/stock-data-backend.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now stock-data-backend

8. Nginx reverse proxy

sudo cp deploy/nginx.conf /etc/nginx/sites-available/stock-data-backend
sudo ln -s /etc/nginx/sites-available/stock-data-backend /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

Nginx serves the frontend static files from frontend/dist/ and proxies /api/v1/ to the backend.

9. SSL (recommended)

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d signal.thiessen.io

Verify

curl https://signal.thiessen.io/api/v1/health

Project Structure

app/
├── main.py              # FastAPI app, lifespan, router wiring
├── config.py            # Pydantic settings from .env
├── database.py          # Async SQLAlchemy engine + session
├── dependencies.py      # DI: DB session, auth guards
├── exceptions.py        # Exception hierarchy
├── middleware.py         # Global error handler → JSON envelope
├── cache.py             # LRU cache with per-ticker invalidation
├── scheduler.py         # APScheduler job definitions
├── models/              # SQLAlchemy ORM models
├── schemas/             # Pydantic request/response schemas
├── services/            # Business logic layer
├── providers/           # External data provider integrations
└── routers/             # FastAPI route handlers

frontend/
├── index.html           # SPA entry point
├── vite.config.ts       # Vite config with API proxy
├── tailwind.config.ts   # Tailwind + glassmorphism theme
├── package.json
└── src/
    ├── App.tsx          # Route definitions
    ├── main.tsx         # React entry point
    ├── api/             # Axios API client modules (one per resource)
    ├── components/
    │   ├── admin/       # User table, job controls, settings, data cleanup
    │   ├── auth/        # Protected route wrapper
    │   ├── charts/      # Canvas candlestick chart
    │   ├── layout/      # App shell, sidebar, mobile nav
    │   ├── rankings/    # Rankings table, weights form
    │   ├── scanner/     # Trade table
    │   ├── ticker/      # Sentiment panel, fundamentals, indicators, S/R overlay
    │   ├── ui/          # Badge, toast, skeleton, score card, confirm dialog
    │   └── watchlist/   # Watchlist table, add ticker form
    ├── hooks/           # React Query hooks (one per resource)
    ├── lib/             # Types, formatting utilities
    ├── pages/           # Page components (7 pages)
    ├── stores/          # Zustand auth store
    └── styles/          # Global CSS with glassmorphism classes

deploy/
├── nginx.conf           # Reverse proxy + static file serving
├── setup_db.sh          # Idempotent DB setup script
└── stock-data-backend.service  # systemd unit

tests/
├── conftest.py          # Fixtures, strategies, test DB
├── unit/                # Unit tests
└── property/            # Property-based tests (Hypothesis)