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. Tuned for the Indian stock market (NSE/BSE) by default, with US and European markets a tab away.
⭐ 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.
- 🖥️ Widget-based workspace — drag, resize, add, and remove panels (
react-grid-layout); your layout is saved locally and restored on reload - ⌘K global command palette — instantly search stocks, ETFs, and crypto and jump straight to them
- 📈 Professional charting (via
lightweight-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 - 💹 Quote panel — last / bid / ask / OHLC, volume, market cap, P/E, EPS, dividend yield, 52‑week range, beta, shares outstanding
- 📰 News feed — aggregated and de‑duplicated from multiple RSS sources, per‑symbol or global
- 🔎 Full‑market screener — filter by sector, market cap, % change, and volume across NSE (default), the entire US equity market, or Europe's largest exchanges, sortable on every column
- 🗺️ Live sector heatmap — treemap sized by market cap, colored by daily % change, refreshing every few seconds, for NSE/US/Europe
- ⛓️ Options chain — calls and puts side‑by‑side with strike, bid/ask, volume, open interest, and ITM highlighting
- 🪙 Crypto board — top assets with 7‑day sparklines, BTC/ETH dominance, and full OHLCV charting for any listed coin
- 🏦 Macro dashboard — NIFTY 50 / NIFTY BANK / SENSEX / India VIX by default, plus US Treasury yield curve & VIX and Euro area yields as secondary tabs
- 💼 Portfolio tracker — log buy/sell transactions, track average cost, realized & unrealized P&L (persisted in SQLite)
- 📅 Calendar — economic events (Fed, ECB, CPI, NFP and more) with consensus forecast, previous reading and, for the major US/EU releases, the actual outcome; plus a per‑watchlist earnings calendar with click‑through history showing forecast vs. actual EPS for the last several quarters and the stock's next‑day price move
- 🤖 AI assistant (optional) — ask questions about the symbol you're looking at, powered by Claude, fully context‑aware of the terminal's current data
- ⚡ Near real‑time updates — quotes and indexes refresh every second with a subtle flash on change, so you always know what just moved
- ⌨️ Keyboard shortcuts everywhere —
⌘Kto search,⌥1–⌥9to add any widget
Candlesticks, 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 — US (stocks/ETFs) | Nasdaq public quote API | Yahoo Finance → Stooq |
Quotes — NSE/BSE (.NS/.BO symbols) |
jugaad-rpc (NSE, real‑time)¹ |
Yahoo Finance → TradingView scanner (fundamentals only) |
| Fundamentals (P/E, EPS, beta, div yield) | TradingView scanner API (america scan for US, india scan for NSE/BSE) |
— |
| Historical candles | Nasdaq chart API (US) / jugaad-rpc¹ (NSE) |
Yahoo Finance → Stooq (US) / Yahoo Finance (NSE) |
| Symbol search | TradingView symbol search (sorted India‑first) | Yahoo Finance |
| Full‑market screener / heatmap | TradingView scanner API — NSE by default, whole‑US or major‑Europe scans a tab away | — |
| Options chain — US | Nasdaq option‑chain API | Yahoo Finance |
| Options chain — NSE index options (NIFTY/BANKNIFTY/FINNIFTY) | jugaad-rpc¹ |
— |
| News | Yahoo Finance RSS + Google News RSS, region‑biased to India for .NS/.BO symbols |
— |
| Crypto quotes & board | CoinGecko | Binance public API |
| Crypto candles | Binance public API (klines) | — |
| Macro — India indexes (NIFTY 50 / NIFTY BANK / India VIX) | jugaad-rpc¹ (NSE, real‑time) |
Yahoo Finance index quotes |
| Macro — India (SENSEX) quote | TradingView scanner (direct‑ticker quote, BSE — outside jugaad‑rpc's NSE‑only scope) | Yahoo Finance index quote |
| Macro — India (SENSEX) chart history | no working source — jugaad‑rpc is NSE‑only, Yahoo/Stooq don't carry it from every network; see Roadmap | — |
| Macro — US (Treasury yields, VIX) / EU (yields, ECB rate, HICP) | FRED (Federal Reserve) / ECB | — |
| Economic calendar (schedule, forecast, previous — incl. RBI/India events) | 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 (india scan for NSE/BSE symbols) |
— |
| Earnings history (forecast vs. actual, surprise %) | Nasdaq earnings‑surprise API (US symbols only — no NSE equivalent found yet) | — |
| Short‑volume — US | FINRA Reg SHO daily file | — |
| Short‑volume — NSE (bulk/short/block deals) | jugaad-rpc¹ |
— |
| Insider transactions — US | SEC EDGAR (Form 4) | — |
| Insider transactions — NSE (best‑effort: general corporate announcements, not SEBI insider‑trading filings specifically) | jugaad-rpc¹ |
— |
¹ jugaad-rpc is this project's own companion NSE data service, run as the jugaad-rpc container in docker-compose.yml (JUGAAD_RPC_URL for a standalone npm run dev), published from jugaad-rs as ghcr.io/am1n1602/jugaad-rpc — confirmed live end‑to‑end (quotes, history, options, index snapshot, large deals, corporate announcements). If the container isn't running, every call above falls back to Yahoo/TradingView exactly the same as a genuine RPC failure.
⚠️ These are public endpoints, not officially licensed data feeds — treat prices as delayed/indicative, not execution‑grade. Seeserver/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
- Web UI → http://localhost:3000
- API health → http://localhost:4000/api/status
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.
- The API binds to
127.0.0.1and only accepts browser requests fromhttp://localhost:3000by default — nothing else on your network can reach it out of the box. - The portfolio and AI endpoints require a shared secret. If you don't set
API_KEYyourself, the API generates one on first run and saves it todata/.api-key; the bundled web app reads that file automatically, so local dev stays zero-config. - To expose this beyond your own machine, set
API_HOST=0.0.0.0,API_KEY=<a-strong-secret>(on both the api and web processes), andWEB_ORIGIN=<your actual origin>explicitly. Don't do this without also keeping dependencies patched — see Known limitations below. - The
/api/airate limit (10 req/min) keys onreq.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, setTRUST_PROXY=1on the api process only if you also run your own reverse proxy in front of the web service that setsX-Forwarded-Forfrom 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.
India data layer
- NSE quotes, history, index options (NIFTY/BANKNIFTY/FINNIFTY), full option‑expiry listing, index snapshot (NIFTY 50/NIFTY BANK/India VIX), bulk/short/block deals and corporate announcements, all wired up to call
jugaad-rpcand confirmed live (GetOptionExpiriesadded in Phase 3, reusing jugaad-core's already‑live‑verifiedoption-chain-contract-infoparsing rather than guessing at new NSE behavior) - SENSEX chart history — no working source. jugaad‑rpc's scope is NSE‑only (SENSEX is BSE's own index) and Yahoo/Stooq don't carry it from every network; the quote still resolves via TradingView's scanner (direct‑ticker mode) independent of Yahoo. Two real paths forward if this is worth picking up: reverse‑engineer TradingView's unofficial WebSocket chart‑session protocol (unverified, needs live iteration), or add a proper BSE module to jugaad‑rs the same way NSE modules were built (bigger cross‑repo effort, also needs live endpoint verification)
- SEBI insider‑trading‑disclosure‑specific endpoint (the Insider widget's NSE data is general corporate announcements today, not that specifically — needs a confirmed NSE endpoint first, per jugaad‑rs's own verify‑live‑before‑coding discipline)
- RBI G‑Sec yield curve for the Macro widget — researched (RBI's DBIE portal, data.rbi.org.in/DBIE, looks like the best free lead, similar in spirit to FRED for the US) but not verified: this environment's network policy blocks egress to data.rbi.org.in outright, so whether it has a clean CSV/JSON endpoint (vs. only an interactive portal) needs checking from a normal connection before building against it
- NSE‑equivalent of forecast‑vs‑actual earnings history
- Additional Indian financial news RSS sources (Moneycontrol/ET/LiveMint) — same blocker as above, candidate URLs turned up by search but unverifiable from here; verify before adding
- Single‑stock NSE F&O options (index options only for now, by design)
General
- Chart drawing tools & multi‑asset comparison overlay
- Black‑Scholes Greeks on the options chain
- Price alerts with desktop notifications
- PostgreSQL as an alternative to SQLite
Have an idea? Open an issue — contributions are very welcome.
Pull requests are welcome, especially:
- New or more resilient data providers (
server/src/providers/) - New widgets (
web/components/widgets/) - Bug fixes and UI polish
Please open an issue first for anything non‑trivial so we can align on approach before you invest the time.
npm auditstill flags two dependency advisories this project doesn't force-fix:fast-xml-parser's XMLBuilder injection (moderate) doesn't apply here — onlyXMLParseris used, neverXMLBuilder— andpostcss'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.- If you deploy behind a reverse proxy or load balancer, set
API_HOST/WEB_ORIGINto 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.



