TopStep MVP Bot

This repository contains a FastAPI backend with a simple React frontend to interact with TopStepX. The backend exposes authentication routes using JWT and integrates existing TopStep login logic. The frontend allows users to log in and view a minimal dashboard.

🚀 Frontend Setup

cd frontend
npm install
npm run dev

🔐 Backend Setup

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
alembic upgrade head  # run from project root to apply migrations
uvicorn app.main:app --reload

🧪 ENV

Create a .env file with the following values:

DATABASE_URL=postgresql://postgres:password@localhost:5432/topstepdb
[email protected]
TOPSTEP_API_KEY=your-api-key
SECRET_KEY=your-secret
CREDENTIALS_ENCRYPTION_KEY=your-32-byte-base64-fernet-key
CORS_ORIGINS=http://localhost:5173,http://127.0.0.1:5173
ACCOUNT_ID=your-topstep-account-id
TOPSTEP_ACCOUNT_ID=your-topstep-account-id
TRADINGVIEW_API_KEY=your-tradingview-api-key
TRADINGVIEW_BASE_URL=https://api.tradingview.com  # optional

CREDENTIALS_ENCRYPTION_KEY is optional only outside production. Production startup requires an explicit Fernet key and ALLOW_CREATE_ALL=false. Run Alembic migrations before marking a hosted backend ready.

Production deployment notes are in docs/deployment-readiness.md. Live-readiness incident procedures are in docs/live-readiness-operational-runbook.md, and responsive/accessibility checks are in docs/accessibility-responsive-checks.md.

Investor demo

This app is safe only for paper-trading demos. Live broker order execution is disabled.

Demo workflow:

1. Start the backend and frontend.
2. Register or log in.
3. Open the dashboard and select Load demo.
4. Review seeded paper orders, paper positions, strategy metrics, provider status, and readiness blockers.
5. Select Reset after the walkthrough.

Additional demo guidance is in docs/investor-demo-package.md, with remaining blockers in docs/launch-readiness-checklist.md. Terms and privacy placeholders live in docs/terms-placeholder.md and docs/privacy-placeholder.md.

🧭 New user onboarding & integrations

1. Start the backend and frontend (see setup above).
2. Visit /register to create a new account.
3. After registration you will be redirected to /integrations to connect platforms like TopStepX, Tradovate, NinjaTrader, TradingView, or Interactive Brokers.
4. Return to /dashboard to run the trading bot.

🗃️ Running migrations

alembic upgrade head

📈 TradingView API

A lightweight wrapper for the TradingView API lives in app/tradingview_api.py. It provides helpers for fetching OHLC data and indicators while handling authentication and rate limits.

from app.tradingview_api import TradingViewClient

client = TradingViewClient()
data = client.get_ohlc("AAPL", "1", 1690000000, 1690003600)
print(data)

Set TRADINGVIEW_API_KEY in your .env to authenticate requests. If no TradingView credentials are available, the analysis and backtest endpoints will fall back to Topstep history when a valid Topstep session token and contract lookup are available (supports 1m/3m intervals).

🧠 Advanced market structure endpoints

The API now exposes richer TradingView-powered analysis under /analysis:

• POST /analysis/market-analysis – fetch OHLC data from TradingView and return divergence, liquidity sweep, fair value gap, and supply/demand zone detections.
• POST /analysis/backtest – run the RSI-based strategy against historical candles (e.g., 1m or 3m) to see how it would have performed. Returns trade log, PnL, and pattern counts.

Example payload:

{
  "symbol": "ES",
  "resolution": "1",
  "start": 1690000000,
  "end": 1690003600,
  "buy_threshold": 30,
  "sell_threshold": 70
}

⏱️ Intraday bot intervals

The streaming bot can now fetch either 1-minute or 3-minute bars via the bar_interval_minutes parameter on /scheduler/run-bot, while still honoring the existing interval_seconds poll cadence.