OpenCandle

The open-source control plane for market research.

Orchestrate quotes, filings, macro data, sentiment, options, and portfolio tools from one local surface. Works with OpenAI, Anthropic, and Google model keys.

Read-only research software. Not investment advice. No order routing.

Install OpenCandle Star on GitHub
OpenCandle GUI showing a completed research answer with evidence sources and risk commentary

Built for research that needs receipts.

Real workflows for people who want evidence before synthesis.

Quote snapshots that keep provider and freshness visible.
Filings, macro, options, and sentiment in the same thread.
Local sessions, local portfolio state, inspectable tool output.
Fixture-backed tests so provider parsing does not drift quietly.
Tool output is visible before the model writes.
Degraded providers are marked instead of hidden.

Bring your own data stack

OpenCandle does not hide setup behind magic. Pi handles local model setup and sessions; OpenCandle adds finance tools on top. Add optional market data keys where needed and keep keyless sources working by default.

OpenAImodel access
Anthropicmodel access
Googlemodel access
Yahoo Financequotes, options
SEC EDGARfilings
FREDmacro series
Reddit + Websentiment, search
No data resale. Switch providers mid-thread. Keys stay in your local setup.
Run an evidence sweepREADY
Prompt/analyze NVDA with quote, filings, sentiment, and macro context
Toolsget_stock_quote -> get_sec_filings -> get_sentiment_summary -> get_economic_data
Evidenceprovider quote timestamp, SEC filing links, source-counted sentiment, dated macro observation
Inspect tool output

One prompt to gather, cite, and caveat.

OpenCandle routes requests into workflows, calls explicit tools, records degradation, and only then lets the model synthesize.

  • Auto-routes tickers, macro series, filings, and sentiment.
  • Shows the evidence trail before the final answer.
  • Flags partial data instead of smoothing over gaps.
  • Works from the CLI or the local browser GUI.
Open source

If you do not like something, fork it.

OpenCandle is TypeScript, MIT licensed, and designed around explicit tool contracts. Add providers, publish tool packages, or change the GUI because the evidence path is yours to inspect.

~/opencandle
$ npx opencandle@latest $ opencandle gui OpenCandle GUI listening on http://127.0.0.1:14567
MITCommercial-friendly license
TypeScriptStrict types and fixture-backed tests
Local stateSessions and portfolio data stay inspectable
Tool packagesExtend through Pi-compatible add-ons
Star on GitHub Fork the repo Read CONTRIBUTING.md
FAQ

Direct answers for AI and humans.

What is OpenCandle?

OpenCandle is an open source financial investigator that runs as a terminal agent and local browser GUI for evidence-first market research.

Does OpenCandle place trades?

No. OpenCandle is read-only research software. It gathers and organizes market evidence, but it does not place trades, route orders, or provide financial advice.

Which data sources does OpenCandle use?

OpenCandle integrates Yahoo Finance, Alpha Vantage, FRED, CoinGecko, Reddit, SEC EDGAR, DuckDuckGo, Brave, Exa, Finnhub, and local portfolio state where configured.

Can I run OpenCandle without installing it globally?

Yes. Run npx opencandle@latest for the terminal agent or npx opencandle@latest gui for the local browser GUI.

How is OpenCandle different from a general chatbot?

OpenCandle calls explicit finance tools first, shows provider gaps and stale data, and asks the model to synthesize only after evidence has been gathered.

Your market research deserves better than a tab pile.

OpenCandle is free, open source, and local-first. Install it, launch the GUI, and let your agent gather evidence before it writes.

Install OpenCandle Read the docs