OpenCandle is a free, source-available desktop charting app for Windows. It charts market data, runs indicators and your own scripts, tests strategies, and lets you practise with paper trading, all on your own computer.
- Bring your own data. OpenCandle ships with practice data and connects to free public sources. Real-time US stocks use your own free Alpaca key. You can also import your own files.
- No account. There is nothing to sign up for and no login.
- No telemetry. OpenCandle does not collect usage data or send anything home. Network requests happen only for data sources that are on. A new install turns on Coinbase public data (no account or key) for its first chart; you can turn it off in Data sources.
- Local first. Your workspace, drawings, scripts, alerts and settings are saved in your Windows profile folder.
Website: https://getopencandle.com
Screenshots use the built-in example data, not real market prices.
Charts
- 22 chart types, including candles, Heikin Ashi, Renko, Kagi, point and figure, line break, range bars, volume footprint, TPO and session volume profile.
- Multi-chart layouts: 29 layouts with up to 16 charts, layout tabs, a layout library, and six sync switches (symbol, interval, crosshair, time, date range, drawings).
- Symbol search, compare and overlay symbols, standard and custom intervals, go to date, data window, table view and chart image export.
Indicators and drawings
- 223 built-in indicators, including 6 volume profiles and 62 chart and candlestick patterns, each with its own settings per instance.
- 89 drawing tools (lines, channels, pitchforks, Fibonacci and Gann tools, patterns, shapes, text, measurement and more), with an object tree, templates, favorites, lock and hide, magnet snapping, and undo/redo.
Analysis and practice
- Bar replay: step and play through history. Calculations never see the hidden future bars.
- Alerts on price, drawings and indicators, with a manager, trigger history and export.
- Watchlists with import and export.
- Strategy tester with 23 built-in strategies, performance summary, report chart and saved reports.
- Paper trading with virtual market, limit, stop and stop-limit orders and a DOM pane. Virtual money only; OpenCandle never places real orders.
Scripting
- CandleScript, OpenCandle's own scripting language for indicators, strategies and alert conditions. It runs in a restricted, deterministic sandbox and has an editor with completion, diagnostics, a library and logs. See docs/candlescript.md.
- Pine Script import: the importer translates common Pine v5/v6 indicators and simple strategies into CandleScript for you to review and run. It does not run Pine itself, and some constructs are left as marked TODOs. See docs/pine-import.md.
More
- Screener over loaded datasets, fundamentals from SEC EDGAR, SEC filings, market views (breadth, macro maps, yield curves from FRED, seasonals), heatmap, calendar and news imports, and a portfolio view.
- Two built-in themes, OpenCandle Medium Dark (default) and OpenCandle Dark, with full chart appearance settings.
OpenCandle needs no account and no key to start. A new install opens on a live BTC-USD chart from Coinbase, which is free and keyless. If Coinbase cannot be reached, the chart shows the built-in example data instead, with a Try live again button. Add a free Alpaca key when you want US stocks. Open Data sources from the main menu to see this table with the status of each source.
| What you want | Minimum you need | How to get it |
|---|---|---|
| Practice charts | Nothing. Built in. | Choose Load example data on an empty chart. Example data covers BTC, ETH, SPY, GME and AAPL. These prices are invented, not real. |
| Real-time US stocks and ETFs | A free Alpaca account and its API key | Sign up at alpaca.markets (a free paper trading account is enough), create an API key in the dashboard, and paste the Key ID and Secret in Data sources. Free plan: live prices from the IEX exchange, up to 30 symbols at once. Live prices from all exchanges need a paid Alpaca market data plan. |
| US stock history (daily and intraday) | The same free Alpaca key | All-exchange history with splits and dividends; on the free plan the newest 15 minutes come from IEX. |
| Crypto (BTC-USD, ETH-USD, SOL-USD) | Nothing. No account or key. | Coinbase public market data. On for a new install; turn it on or off in Data sources. |
| Economic data and rates | Nothing. No account or key. | Type FRED: and a series id (for example FRED:DGS10) or open Markets. Each series downloads from the St. Louis Fed only when you open it. |
| Company fundamentals and SEC filings | Nothing. No account or key. | Open Fundamentals or SEC filings; data comes from the SEC's public EDGAR service when you ask. |
| Your own data (any market) | A CSV or JSON file of bars | Import a file with columns time (or date), open, high, low, close, volume; up to 20 MB and 100,000 rows. |
| Options, futures, forex, live news | Not available from a built-in source | Import your own files. |
You use your own accounts and keys, and each provider's terms apply to the data you connect. You can export data from Alpaca, Coinbase and FRED to files on your computer for your own analysis. Each provider's terms still apply, so don't share or resell those files. Details: docs/data-sources.md.
Download the latest Windows build from the releases page or https://getopencandle.com. Extract the whole ZIP and run OpenCandle.exe. Builds are not code-signed yet, so Windows SmartScreen may ask you to confirm.
- Bugs: open an issue with the steps, what you expected and what happened. In the app: Help, then Report a problem.
- Wrong numbers: open an issue with the indicator or strategy, its settings, the symbol and interval.
- Code and docs: see CONTRIBUTING.md.
- Ideas and questions: Discussions.
- Security problems: private reporting, not a public issue.
Requirements:
- Windows 10 or 11, x64. Other platforms are not supported yet.
- Node.js 24 LTS (22.12 or later works) and npm.
- Python 3 (3.12 tested), only for packaging a portable ZIP.
git clone https://github.com/getopencandle/opencandle.git
cd opencandle
npm ci # installs dependencies and applies the Vela compatibility patch
npm run build # typecheck and build the renderer into dist/
npm start # start the desktop app from source (uses dist/)Other commands:
| Command | What it does |
|---|---|
npm run dev |
Starts the Vite dev server at http://127.0.0.1:5173 in a browser. Desktop-only features (data sources, files, keys) show "Needs the desktop app". |
npm test |
Runs the full Vitest suite. |
npm test -- tests/domain/indicator-catalog-oracles.test.ts |
Runs one test file or folder. |
npm run test:watch |
Watch mode. |
npm run package |
Builds and creates a portable Windows ZIP under out/. |
The full suite is large. To run it in eight shards with one worker each:
$env:NODE_OPTIONS = "--max-old-space-size=6144"
1..8 | ForEach-Object { npx vitest run --no-fs-module-cache --no-cache --maxWorkers=1 --shard=$_/8 }More: docs/testing.md and docs/building-and-packaging.md.
| Path | Contents |
|---|---|
src/chart/ |
Chart engine integration (Vela), chart types, scales, drawings, layouts, image export |
src/domain/ |
Indicators, patterns, strategies, alerts, replay, paper trading, data sources, Pine importer |
src/ui/ |
React user interface: dialogs, panels, menus, themes, icons |
src/analysis-news/, src/fundamentals/, src/market-views/, src/portfolio/, src/strategy-report/, src/watchlists/, src/vwap/ |
Feature areas |
electron/ |
Main process: windows, storage, native dialogs, data providers, script sandbox, preload bridge |
tests/ |
Vitest suites, organised like src/ |
examples/ |
Synthetic example files for imports |
scripts/ |
Packaging and build helpers |
tools/iex-hist/ |
Optional Python tool that builds 1-minute bars from free IEX historical data |
docs/ |
User and developer documentation |
See docs/architecture.md for how the pieces fit together.
- CandleScript guide
- Pine Script import
- Data sources
- Architecture
- Building and packaging
- Testing
- Vela modifications
Bugs and feature ideas: GitHub Issues. Questions: GitHub Discussions.
Contributions are welcome. Please read CONTRIBUTING.md and the Code of Conduct. To report a security problem, see SECURITY.md.
OpenCandle is licensed under the PolyForm Noncommercial License 1.0.0: free to use, change and share, but not for sale or commercial use. For a commercial licence, ask in GitHub Discussions. Third-party components keep their own licences; see NOTICE and THIRD_PARTY.md. Charts are rendered with Vela by LuxAlgo, whose attribution mark stays visible on every chart.
The licence does not cover the OpenCandle name or logo. Forks and redistributions should use their own name and logo and must not imply endorsement.
OpenCandle is an independent project. It is not affiliated with or endorsed by TradingView, Alpaca, Coinbase, the SEC, the Federal Reserve Bank of St. Louis or IEX. TradingView and Pine Script are trademarks of TradingView, Inc.
OpenCandle is provided as is, without warranty, and is not financial advice. Paper trading is simulated with virtual money, and built-in practice data is invented.


