OpenTerminal README

The project's README from github.com/ErTasselli/OpenTerminal. As one markdown file: README.md.

OpenTerminal

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.

Stack License: MIT No API Key Required PRs Welcome

ErTasselli%2FOpenTerminal | Trendshift


OpenTerminal dashboard — live chart, quote panel, watchlist, news and macro indexes

⭐ If this is useful to you, consider starring the repo — it genuinely helps other people find it.


Why OpenTerminal?

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.


✨ Features


📸 A closer look

Charting

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.

Candlestick chart with SMA/RSI/MACD indicators and hover legend

Live sector heatmap

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.

Live sector heatmap of the US equity market

Crypto

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.

Crypto board with sparklines and dominance

News

Headlines aggregated and de‑duplicated across multiple sources, filterable per‑symbol or global, so you're never digging through five tabs to catch up.

Per-symbol and global news feed, aggregated and de-duplicated

🗂️ Data sources

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.


🚀 Quick start

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.

Optional: AI assistant

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:

Security defaults


🐳 Docker

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.


🧱 Tech stack

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)

📁 Project structure

├── 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.


🗺️ Roadmap

Have an idea? Open an issue — contributions are very welcome.


🤝 Contributing

Pull requests are welcome, especially:

Please open an issue first for anything non‑trivial so we can align on approach before you invest the time.


Known limitations


⚖️ Disclaimer

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.

License

MIT


star the repo ⭐ — it's the best way to support the project.

OpenTerminal (ErTasselli/OpenTerminal)

Searching Database…

Что это такое?OpenTerminal — это self-hosted торговый дашборд в стиле терминала, который собирает бесплатные публичные данные рынков (акции, крипта, макропоказатели) в одно рабочее пространство с управлением с клавиатуры. Платные API-ключи и подписки не нужны.
Это десктопное приложение или я запускаю его в браузере?Это self-hosted веб-приложение: фронтенд на Next.js/React в паре с бэкендом на Node.js/Express, который вы запускаете сами (локально или через Docker), а потом открываете в браузере.
Как его запустить?Склонируйте репозиторий, выполните npm install и запустите — веб-интерфейс и API поднимутся без файла .env; также поддерживается Docker, при этом данные портфеля сохраняются в SQLite-томе.
Нужен ли мне для чего-нибудь API-ключ Anthropic?Нет — весь дашборд работает без всяких ключей. API-ключ Anthropic нужен только для опционального виджета с AI-ассистентом; без него этот виджет просто покажет сообщение о недоступности, и ничего не сломается.
Насколько надёжны рыночные данные?Данные берутся из публичных (а иногда и реверс-инжиниренных) эндпоинтов, а не из лицензированных каналов, поэтому цены стоит воспринимать как задержанные или ориентировочные, а не как котировки для исполнения; при этом у каждого типа данных есть автоматический резервный провайдер на случай, если основной источник ляжет.
Безопасно ли открывать доступ к нему за пределами моего компьютера?По умолчанию API слушает только 127.0.0.1 и требует автоматически сгенерированный общий секрет для эндпоинтов портфеля и AI, так что никто другой в вашей сети до него не доберётся; чтобы открыть доступ дальше, нужно вручную задать APIHOST, APIKEY и WEBORIGIN, а сам проект HTTPS не терминирует.
Что умеет скринер по всему рынку и тепловая карта?Скринер фильтрует весь рынок акций США по сектору, капитализации, изменению в % и объёму, с сортируемыми колонками, а живая тепловая карта секторов показывает тот же рынок в виде treemap, где размер блока соответствует капитализации, а цвет — дневному изменению в %, обновляясь каждые несколько секунд.
Какие индикаторы поддерживают графики?Графики поддерживают свечи, бары, линию и область на 8 таймфреймах с индикаторами SMA, EMA, VWAP, Bollinger Bands, RSI и MACD; значения показываются вживую под курсором вместе с OHLC и объёмом.
Могу ли я вести учёт своих сделок?Да — встроенный трекер портфеля позволяет записывать сделки на покупку и продажу и считает среднюю цену, а также реализованную и нереализованную прибыль/убыток; всё хранится локально в SQLite.
Зачем делать это вместо использования настоящего торгового терминала?Настоящие торговые терминалы стоят от $2,000 в месяц, а большинство бесплатных дашбордов зависят от одного ненадёжного источника данных; OpenTerminal объединяет несколько бесплатных публичных эндпоинтов с автоматическими цепочками переключения, так что сбой одного провайдера не роняет всё приложение.
Creator
ErTasselli
Size
3.5 MB
Stars
1.8K
Age
2mo
Commits · 90 Days