The project's README from github.com/ErTasselli/OpenTerminal. As one markdown file: README.md.
A Terminal‑style workspace for the rest of us — built entirely on free, public market data.
Dark. Dense. Keyboard‑driven. Zero paid API keys, zero subscriptions.
⭐ If this is useful to you, consider starring the repo — it genuinely helps other people find it.
Real trading terminals cost $2,000+ a month. Most retail dashboards either lock the good stuff behind a paywall or run on a single flaky data source that breaks the moment you actually need it.
OpenTerminal takes a different approach: it stitches together several free, publicly documented (or reverse‑engineered but widely used) market data endpoints — the same ones that power major finance sites' own front ends — into one fast, keyboard‑first, widget‑based dashboard that runs entirely on your machine. Every data endpoint has an automatic fallback chain, so a single provider hiccup never takes the whole app down.
No signup. No credit card. No rate‑limited demo tier. Clone it, npm install, and you have a live terminal in under a minute.
react-grid-layout); your layout is saved locally and restored on reloadlightweight-charts) — candlesticks, bars, line, area, volume, 8 timeframes (1D → MAX), and SMA / EMA / VWAP / Bollinger Bands / RSI / MACD indicators, each with a live hover legend showing OHLC, volume, and every active indicator's value under your cursor⌘K to search, ⌥1–⌥9 to add any widgetCandlesticks, bars, line, or area — 8 timeframes, six technical indicators, and a live legend under your cursor showing OHLC, volume, and every active indicator's value for the candle you're pointing at.
The whole US equity market as a treemap — sized by market cap, colored by daily % change, refreshing every few seconds so nothing you're watching ever goes stale.
Top assets with 7‑day sparklines and BTC/ETH dominance — click through to full OHLCV candlestick charting for any listed coin, same charting engine as stocks.
Headlines aggregated and de‑duplicated across multiple sources, filterable per‑symbol or global, so you're never digging through five tabs to catch up.
No paid API, no keys, and no single point of failure — every endpoint has a fallback chain, and results are cached with a stale‑while‑revalidate strategy so a temporary outage never blanks out the UI.
| Data | Primary source | Fallback |
|---|---|---|
| Quotes (stocks/ETFs) | Nasdaq public quote API | Yahoo Finance → Stooq |
| Fundamentals (P/E, EPS, beta, div yield) | TradingView scanner API | — |
| Historical candles | Nasdaq chart API | Yahoo Finance → Stooq |
| Symbol search | TradingView symbol search | Yahoo Finance |
| Full‑market screener / heatmap | TradingView scanner API (live, whole US market) | — |
| Options chain | Nasdaq option‑chain API | Yahoo Finance |
| News | Yahoo Finance RSS | Google News RSS |
| Crypto quotes & board | CoinGecko | Binance public API |
| Crypto candles | Binance public API (klines) | — |
| Macro (Treasury yields, VIX) | FRED (Federal Reserve) | — |
| Economic calendar (schedule, forecast, previous) | Forex Factory public feed | — |
| Economic calendar (actual — Fed / ECB / CPI / NFP only) | FRED (Federal Reserve) | — |
| Earnings calendar (next/last date, EPS estimate) | TradingView scanner API | — |
| Earnings history (forecast vs. actual, surprise %) | Nasdaq earnings‑surprise API | — |
⚠️ These are public endpoints, not officially licensed data feeds — treat prices as delayed/indicative, not execution‑grade. See
server/src/providers/— each provider is a small, isolated module, so swapping or adding a data source is a 30‑minute job.
git clone https://github.com/ErTasselli/openterminal.git
cd openterminal
npm install
npm run dev
That's it — no .env file required to get a fully working terminal.
export ANTHROPIC_API_KEY=sk-ant-...
npm run dev
Without a key, everything else still works — the AI widget just shows a friendly "unavailable" message instead of failing.
Two optional knobs for the assistant, both standard for the Anthropic SDK:
ANTHROPIC_BASE_URL — point the assistant at an Anthropic-compatible endpoint (a self-hosted gateway, an EU-hosted relay, etc.) instead of api.anthropic.com.ANTHROPIC_MODEL — override the model sent in requests (default: claude-opus-4-8). Required when the endpoint behind ANTHROPIC_BASE_URL serves models under different ids.127.0.0.1 and only accepts browser requests from http://localhost:3000 by default — nothing else on your network can reach it out of the box.API_KEY yourself, the API generates one on first run and saves it to data/.api-key; the bundled web app reads that file automatically, so local dev stays zero-config.API_HOST=0.0.0.0, API_KEY=<a-strong-secret> (on both the api and web processes), and WEB_ORIGIN=<your actual origin> explicitly. Don't do this without also keeping dependencies patched — see Known limitations below./api/ai rate limit (10 req/min) keys on req.ip. Calls made through the bundled web proxy all arrive from that proxy's own address, so by default every caller sharing it shares one bucket. If you're serving more than one real user through it, set TRUST_PROXY=1 on the api process only if you also run your own reverse proxy in front of the web service that sets X-Forwarded-For from the real client and doesn't let visitors set it themselves — otherwise a caller can forge that header to dodge the limit.docker compose up --build
Portfolio data persists in the terminal-data volume (SQLite, WAL mode). Ports are published on 127.0.0.1 only by default; see Security defaults to expose it deliberately.
| Layer | Stack |
|---|---|
| Frontend | Next.js 15 · React 19 · TypeScript · Tailwind CSS 4 · Zustand · TanStack Query |
| Charts | lightweight-charts (candles/indicators) · D3 (heatmap treemap) · Recharts (yield curve) |
| Backend | Node.js · Express · TypeScript |
| Database | SQLite (better-sqlite3, WAL mode) |
| AI | Anthropic Claude (optional) |
├── server/ # Express + TypeScript API
│ └── src/
│ ├── providers/ # nasdaq, tradingview, yahoo, stooq, fred, econcalendar, coingecko, binance, news
│ ├── routes/ # market, portfolio, ai
│ ├── cache.ts # TTL cache with stale-while-revalidate fallback
│ └── db.ts # SQLite (better-sqlite3, WAL)
└── web/ # Next.js 15 + React 19 + Tailwind 4
├── components/ # TopBar, Sidebar, Workspace, CommandPalette
├── components/widgets/ # Chart, Quote, Watchlist, News, Screener, Heatmap, Crypto, Options, Macro, Portfolio, Calendar, AI
├── lib/ # API client, technical indicators
└── store/ # Zustand store (workspace layout, persisted)
Run tests with npm test (Vitest, no network calls). CI runs on every push — see .github/workflows/ci.yml.
Have an idea? Open an issue — contributions are very welcome.
Pull requests are welcome, especially:
server/src/providers/)web/components/widgets/)Please open an issue first for anything non‑trivial so we can align on approach before you invest the time.
npm audit still flags two dependency advisories this project doesn't force-fix: fast-xml-parser's XMLBuilder injection (moderate) doesn't apply here — only XMLParser is used, never XMLBuilder — and postcss's high-severity issue is bundled inside Next.js itself, only resolved by a Next 16 major upgrade. Both are tracked, neither is silently ignored.API_HOST/WEB_ORIGIN to match, and terminate TLS in front of it — this project doesn't handle HTTPS itself.For personal and educational use only. Market data comes from public endpoints and may be delayed, incomplete, or occasionally wrong — do not use this for real investment decisions.
This project is not affiliated with, endorsed by, or sponsored by any of the data providers it connects to. It does not host or redistribute data to third parties — it's source code you run yourself, fetching data directly from the provider. Respect the terms of service of the underlying data providers; most free sources are licensed for personal/research use only and prohibit commercial redistribution.
star the repo ⭐ — it's the best way to support the project.