Know when to trade, and when to stay flat. AlphaBoard is an invite-only trading-intelligence workspace: it reads live markets across six timeframes, drafts a plan with the AI model you choose, lets you rehearse it with paper money, then grades every call against what price actually did next.
Analysis and paper trading by default. Agent sessions can also trade on a crypto exchange (testnet or real money) once the owner connects one — at their own risk. AlphaBoard is not financial advice.
Version 2.0.0 · Next.js 16 · TypeScript · PostgreSQL · see CHANGELOG.md
| Read | 66 assets — crypto (Binance), gold, indices and forex (Yahoo Finance). Trend and momentum from 5-minute to weekly candles side by side, candlestick and chart patterns (incl. order blocks and FVGs), futures funding / open interest / long-short, news and fundamentals. Missing data shows as “Unavailable”, never a guess. |
| Decide | One click asks the chosen AI model (OpenAI, Anthropic Claude, OpenRouter or DeepSeek) for a plan built from data the server gathers itself: entry, stop, target, sizing and reasoning. Output is schema-validated; the plan can be “stay flat”. |
| Practise | A 10,000 USDT paper account: isolated margin, leverage up to 20×, 0.05% slippage and a 0.05% fee per side, stops and targets checked every minute on candle highs/lows — even with the tab closed. |
| Delegate | Agent sessions: give a small AI desk a mandate (capital, symbols, spot or perpetual, risk per trade, loss limit, time box) and watch it work in a live room — market and news analysts, an optional bull/bear debate, a strategist, then a rule-based risk engine that sizes, clamps or vetoes every trade. Stops, the loss limit and the end-of-session prompt (web and Telegram, 5-minute answer window) are enforced by code. Every closed trade lands in the Journal with a lesson; each session ends with a report against buy-and-hold. Runs on paper, on any ccxt crypto exchange (spot or perpetual), or on OANDA for forex, gold and silver — testnet / practice first, real money only after typing LIVE. |
| Measure | Every BUY/SELL signal is replayed on later candles and scored in R: win rate, expectancy, profit factor, drawdown, confidence calibration, by model / asset / timeframe. Your record shows on the trade ticket. |
Also: trade journal with AI screenshot auto-fill and post-mortems, chart-reading academy, price alerts (in-app bell, optional Telegram), signal archive, per-user AI allowance, admin console (system health, users, invites & waitlist, AI usage and cost).
Requirements: Node 22+, Docker (for PostgreSQL).
git clone https://github.com/farjadp/AlphaBoard.git && cd AlphaBoard
npm install
cp .env.example .env # fill in AUTH_SECRET, ADMIN_EMAIL, ADMIN_PASSWORD and at least one AI key
docker compose up -d db # PostgreSQL on localhost:5434
npm run db:deploy # apply migrations
npm run db:seed # create the first admin from ADMIN_EMAIL / ADMIN_PASSWORD
npm run dev # http://localhost:3000Sign in as the admin, accept the risk disclaimer, then invite traders from Admin → Invites (or convert requests from the landing-page waitlist).
| Variable | Required | Purpose |
|---|---|---|
DATABASE_URL |
yes | PostgreSQL connection string |
AUTH_SECRET |
yes | Session secret (openssl rand -base64 32) |
AUTH_TRUST_HOST |
production | true behind Vercel or another proxy |
APP_URL |
yes | Public base URL — invite links, sitemap, Open Graph |
ADMIN_EMAIL, ADMIN_PASSWORD |
first boot | Bootstraps the first admin (idempotent) |
OPENAI_API_KEY |
one AI key | Default provider (default model gpt-5.4-mini, images gpt-4o) |
ANTHROPIC_API_KEY, OPENROUTER_API_KEY, DEEPSEEK_API_KEY |
optional | More providers; only providers with a key can be chosen |
AI_DEFAULT_PROVIDER, AI_DEFAULT_MODEL |
optional | Initial default until an admin sets one in Admin → AI |
FINNHUB_KEY, ALPHAVANTAGE_KEY, MARKETAUX_KEY, NEWS_API_KEY, CRYPTOPANIC_KEY (+ CRYPTOPANIC_PLAN) |
optional | News hub sources (RSS and Yahoo need no key); see Admin → News |
TELEGRAM_BOT_TOKEN |
optional | Alert delivery to Telegram (users link a chat in Settings) |
CRON_SECRET |
optional | Lets an external scheduler call POST /api/cron/tick |
TICK_DISABLED |
optional | 1 turns the 60-second tick off (sessions and Telegram keep running) |
NEWS_DISABLED |
optional | 1 turns the news hub pass off |
LIVE_TRADING_ENABLED, EXCHANGE_KEY_SECRET |
optional | Both needed for exchange sessions: the flag, and 32 random bytes (base64) that encrypt stored API keys |
TRADING_HALT |
optional | 1 refuses every new exchange entry (exits still run) |
WORKER_MODE |
optional | inline (default): background work runs inside the web process · separate: run npm run worker as its own process |
| Command | What it does |
|---|---|
npm run dev / npm run build / npm start |
Dev server / production build / prisma migrate deploy && next start |
npm test · npm run test:db |
Unit tests · unit + PostgreSQL tests (schema test on the local database) |
npm run typecheck · npm run lint |
tsc --noEmit · ESLint (both run in CI with the DB tests and the build) |
npm run db:migrate · npm run db:deploy · npm run db:seed |
Create a migration · apply migrations · bootstrap the admin |
npm run worker |
Background worker on its own (with WORKER_MODE=separate on the web process) |
npm run build:worker |
Bundle the worker to dist/worker.mjs (the Docker image runs it as node worker.mjs) |
docker compose --profile full up --build # app + postgresThe image runs as a non-root user and exposes GET /api/health (database and scheduler status). In production the same image is the Fly worker (node worker.mjs).
- Auth & access: NextAuth (credentials, JWT), invite-only registration,
requireUser()/requireAdmin()in every route handler and server action, risk-disclaimer gate inproxy.ts. - Security: nonce-based CSP (
proxy.ts) plus HSTS, frame, referrer and permissions headers (next.config.ts); per-IP rate limits (auth, AI, API, public forms); size-capped JSON bodies; zod validation on every input and every AI answer. - Data: PostgreSQL via Prisma migrations; every row scoped to its user; screenshots as owner-only attachments;
/importmoves data saved in the browser by v1. - Worker: one leased worker (inside the web process by default) runs the 60-second tick (paper stops/targets, equity, signal grading, alerts), the 15-second session monitor (session stops, loss limits, end prompts, decision cycles, journal and reports) and Telegram long-polling (link codes,
/sessions,/positions, inline buttons). A database lease guarantees a single active worker. - Exchanges:
lib/venues/ccxt.ts(ccxt, market orders, deterministic client ids written before sending, lookup on an unknown outcome, never a blind retry),lib/venues/reconciler.ts(exchange vs ledger every 30 s; any mismatch halts), keys AES-256-GCM encrypted (lib/secrets). Stops rest on the exchange as stop-loss orders where the exchange supports them (software stops, checked every 15 s, otherwise and as a fallback). - Agent sessions:
lib/sessions(mandate, lifecycle, cycle, monitor, report),lib/sessions/desk(context block, prompts, runners),lib/risk(deterministic risk engine),lib/venues(venue interface; paper today, exchanges next). - Observability: pino JSON logs with a request id on every response; server errors stored for Admin → System.
Project docs: docs/HANDOFF.md (current state, conventions, production runbook), docs/ARCHITECTURE.md (folder map and data flow), docs/superpowers/specs/ (design spec), docs/archive/plans/ (finished phase plans), docs/audits/ (accessibility and UI audit), PRODUCT.md (product brief).
- Web on Vercel, Git-linked to this repo; merging to
maindeploys.scripts/vercel-build.shapplies migrations on production builds only (over the direct Neon URLDATABASE_URL_UNPOOLED), then builds. SetWORKER_MODE=separatethere. - Database on Neon via the Vercel Marketplace integration (pooled
DATABASE_URLfor the app, unpooled for migrations). Migrations must own the schema; do notdb push. - Worker on Fly.io (
fly.toml): one machine runningnode worker.mjsfrom the same image, with the unpooledDATABASE_URL. Keep exactly one worker machine; a database lease prevents two from ticking at once. - Environment variables: the list above plus
AUTH_TRUST_HOST=trueandAPP_URL=https://<your domain>. After the first boot sign in as the admin, accept the disclaimer, and check Admin → System shows the tick running.
Full runbook, ids and gotchas: docs/HANDOFF.md § Production.
AlphaBoard is an analysis and education tool. It does not provide financial advice. Trading, especially with leverage, carries a high risk of loss. The legal text in /legal is a draft and should be reviewed by a lawyer before public launch.