Skip to content
Back to search

OpenTraderWorld

Free and source-available, self-hostable trading workspace: data, backtest, trading journal, news aggregator, rich-doc editor, portfolio, 20+ modules with a built-in MCP server and AI agent.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/G-OTW/OpenTraderWorld with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/G-OTW/OpenTraderWorld'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/g-otw--opentraderworld/badge.svg)](/listings/g-otw--opentraderworld)

HTML

<a href="/listings/g-otw--opentraderworld"><img src="/api/listings/g-otw--opentraderworld/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

You need [Docker](https://g-otw.github.io/OpenTraderWorld/guide/docker) (macOS, Linux or Windows).

curl -fsSL https://raw.githubusercontent.com/G-OTW/OpenTraderWorld/master/install.sh | bash

The installer asks a few questions, generates strong secrets, pulls the prebuilt images and starts the stack, creates your admin account and prints its password once. Then open **http://localhost:5454** and sign in. If you want the long version (manual setup, headless servers, LAN/HTTPS/public exposure, backups), it is all in [the documentation](https://g-otw.github.io/OpenTraderWorld/guide/install).

Prefer to be walked through it? The [guided install](https://opentraderworld.com/hosting/setup) on the website takes you through it step by step.

> **If the page won't load over plain HTTP.** Browsers with HTTPS-only mode (Chrome/Edge > HTTPS-First, Firefox HTTPS-Only, Safari) rewrite `http://` into `https://` and then cache > that redirect, so a LAN install answers nothing at all. Open the address in a private > window to confirm that is what is happening, then allow HTTP for that host. Or switch to > the LAN + HTTPS mode in Settings → Network and get a real certificate.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 655 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. # OpenTraderWorld
  3. **Your trading workspace, on your own machine.**
  4. [![Website](https://img.shields.io/badge/website-opentraderworld.com-1f6feb)](https://opentraderworld.com)
  5. [![License](https://img.shields.io/badge/license-FSL--1.1--MIT-blue)](LICENSE)
  6. [![Docs](https://img.shields.io/github/actions/workflow/status/G-OTW/OpenTraderWorld/docs.yml?branch=master&label=docs)](https://g-otw.github.io/OpenTraderWorld/)
  7. [![Docker Compose](https://img.shields.io/badge/deploy-Docker%20Compose-2496ED?logo=docker&logoColor=white)](https://g-otw.github.io/OpenTraderWorld/guide/install)
  8. A free, self-hosted platform that bundles the tools traders and investors actually use: trading journal, market data and backtesting, portfolios, news, planning. Your data stays on your machine. And if you want it, your own AI agent runs the whole thing alongside you.
  9. [**Website**](https://opentraderworld.com) ·
  10. [Documentation](https://g-otw.github.io/OpenTraderWorld/) ·
  11. [Install in 2 minutes](https://g-otw.github.io/OpenTraderWorld/guide/install) ·
  12. [Module tour](https://g-otw.github.io/OpenTraderWorld/modules/) ·
  13. [Suggest a feature](https://opentraderworld.com/suggestions) ·
  14. [Hosting it](https://opentraderworld.com/hosting)
  15. ### [▶ Try the live demo](https://demo.opentraderworld.com)
  16. No account, no install, already full of realistic data. It is a shared sandbox, wiped every 15 minutes.
  17. <picture>
  18. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/charts-dark.gif">
  19. <img width="80%" alt="Charts: a Pine Script indicator added from the library, then a trend line drawn on BTCUSDT, in a 2×2 workspace" src="docs/public/screenshots/charts-light.gif">
  20. </picture>
  21. </div>
  22. ---
  23. ## Nobody needs a new Bloomberg Terminal
  24. Every few weeks another product promises to be "the Bloomberg Terminal for the rest of us".
  25. It is the wrong target, because Bloomberg does not sell software.
  26. - A Bloomberg Terminal costs roughly **$30,000 per user per year**, on two-year contracts.
  27. LSEG Workspace, ex-Refinitiv Eikon, sits around **$22,000** for the full tier.
  28. - **What that money buys is immediacy and access**: news in under a second, dealer runs,
  29. liquidity, and a closed chat network holding the people on the other side of your trade.
  30. - The screens, the charts, the functions are the wrapper. Nobody signs a $30k contract for
  31. the UI.
  32. **OpenTraderWorld is not trying to be the next Bloomberg Terminal.** It is the workspace
  33. around your own decisions: your journal, your portfolios, your backtests, your research, your
  34. automations, enhanced by your favorite AI model. Free, on your machine, with the data providers you already pay for (or the free ones).
  35. ---
  36. ## Why OpenTraderWorld?
  37. - 🆓 **Free.** No subscription, no paywall, no "pro tier". Free for everyone, whether you
  38. trade for a living or on the side. The idea behind it: *get profitable before spending a dime.*
  39. - 🔒 **Private and self-hosted.** It runs on your computer or your server with Docker. No
  40. account, no cloud, no telemetry. Right after install it only answers on localhost, until
  41. *you* decide otherwise.
  42. - 🧩 **Modular.** 25+ modules. Install what you use, detach the rest.
  43. - 🔁 **Updated constantly.** New modules and improvements land regularly. The app tells you
  44. when a version is out, updating is a couple of commands it shows you, and your data always
  45. survives the upgrade.
  46. - 🗳️ **Built with its users.** Feature ideas come from the people using it. Suggest yours,
  47. vote on other people's, watch the roadmap move. See [Contributing ideas](#-suggest-vote-contribute).
  48. - 🌍 **7 languages.** English, French, German, Spanish, Italian, Portuguese, Chinese.
  49. - 🤖 **AI built in, on your terms.** There is a built-in
  50. [assistant](https://g-otw.github.io/OpenTraderWorld/modules/agent) that chats with your own
  51. data. You bring the provider (Anthropic, or any OpenAI-compatible endpoint), and it gets
  52. memory, skills and tool access scoped by token. There is also a built-in
  53. [MCP server](https://g-otw.github.io/OpenTraderWorld/config/ai-agents), so *external* agents
  54. can read or update your modules through that same token-scoped gateway. Both are off until
  55. you turn them on. Your keys are encrypted at rest and never reach the browser.
  56. - ⚙️ **Automate as much or as little as you like.** The
  57. [automator](https://g-otw.github.io/OpenTraderWorld/modules/automator) turns your routines
  58. into scheduled workflows: imports, reports, market scans, alerts, daily reviews. Any of them
  59. can hand a step to your own AI model, or be driven by it from end to end. You stay in charge
  60. the whole way: nothing runs, sends or writes anything you did not switch on yourself.
  61. - 🔑 **Secrets stay sealed.** An encrypted [Vault](https://g-otw.github.io/OpenTraderWorld/config/settings#vault)
  62. holds the credentials the app needs on your behalf. Encrypted at rest, write-only once saved,
  63. and plugged into any module by reference so you never paste them twice.
  64. ## Quick start
  65. You need [Docker](https://g-otw.github.io/OpenTraderWorld/guide/docker) (macOS, Linux or Windows).
  66. ```bash
  67. curl -fsSL https://raw.githubusercontent.com/G-OTW/OpenTraderWorld/master/install.sh | bash
  68. ```
  69. The installer asks a few questions, generates strong secrets, pulls the prebuilt images and
  70. starts the stack, creates your admin account and prints its password once. Then open
  71. **http://localhost:5454** and sign in. If you want the long version (manual setup, headless
  72. servers, LAN/HTTPS/public exposure, backups), it is all in
  73. [the documentation](https://g-otw.github.io/OpenTraderWorld/guide/install).
  74. > [!TIP]
  75. > **Prefer to be walked through it?** The guided install on the website takes you through it
  76. > step by step.
  77. >
  78. > [![Guided install, step by step](https://img.shields.io/badge/Guided_install-step_by_step-1f6feb?style=for-the-badge)](https://opentraderworld.com/hosting/setup)
  79. > **If the page won't load over plain HTTP.** Browsers with HTTPS-only mode (Chrome/Edge
  80. > HTTPS-First, Firefox HTTPS-Only, Safari) rewrite `http://` into `https://` and then cache
  81. > that redirect, so a LAN install answers nothing at all. Open the address in a private
  82. > window to confirm that is what is happening, then allow HTTP for that host. Or switch to
  83. > the LAN + HTTPS mode in Settings → Network and get a real certificate.
  84. ## A look inside
  85. Every image below is the real app, captured from a local install. Prices, news and backtests are
  86. real; the journal, portfolio and fundamentals figures are sample data. The images follow your
  87. GitHub theme, light or dark, except the Agent clip, recorded in dark.
  88. ### Dashboard
  89. Workspaces for each hat you wear (investor, trader, quant, portfolio), built from widgets: net
  90. worth, positions, live quotes, headlines, upcoming macro releases, goals. Rearrange them or add
  91. your own.
  92. <picture>
  93. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/dashboard-dark.gif">
  94. <img width="80%" alt="Dashboard: switching between the Investor, Trader, Quant and Portfolio workspaces" src="docs/public/screenshots/dashboard-light.gif">
  95. </picture>
  96. ### Charts
  97. Up to twelve linked charts per workspace, drawing tools, built-in studies and alerts. Paste a Pine
  98. Script v5/v6 indicator once, keep it in your library, and add it to any chart.
  99. **Trade from the chart** (experimental): send, move and cancel orders and close positions on
  100. Interactive Brokers, Binance, Binance USDⓈ-M Futures and the app's own paper trading account,
  101. with your own risk limits and a kill switch. A live account takes orders only once you turn
  102. live trading on for it, with its limits set. See [Trading from the chart](https://g-otw.github.io/OpenTraderWorld/config/trading).
  103. > [!WARNING]
  104. > Chart trading is new. It is heavily tested, against simulated venues and the brokers' own
  105. > test environments, but bugs can remain. Check every order at your broker, start small, and
  106. > trade at your own risk.
  107. <picture>
  108. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/charts-dark.png">
  109. <img width="80%" alt="Charts: a 2×2 workspace with BTCUSDT, ETHUSDT, NVDA and AAPL, each with its own indicators" src="docs/public/screenshots/charts-light.png">
  110. </picture>
  111. ### Backtest
  112. Load a saved strategy, pick a dataset, run. The report puts every trade on the chart, with the
  113. figures that matter next to buy and hold. Shown here: an EMA 21/55 crossover on ten years of
  114. AAPL daily bars, +375% against +1,217% for buy and hold. The engine does not flatter a strategy.
  115. <picture>
  116. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/backtest-dark.gif">
  117. <img width="80%" alt="Backtest: loading a strategy, adding the AAPL dataset, running it and reading the report" src="docs/public/screenshots/backtest-light.gif">
  118. </picture>
  119. ### Agent
  120. Ask in plain language and your own [AI agent](https://g-otw.github.io/OpenTraderWorld/modules/agent)
  121. does the work inside the app. Here, a 10-year MACD backtest on AAPL, from loading the data to
  122. out-of-sample checks and a verdict against buy and hold. Bring your own provider, and per-module
  123. permissions decide what it can touch.
  124. <img width="80%" alt="Agent: the assistant runs a full AAPL backtest through its tools, then writes the verdict against buy and hold" src="docs/public/screenshots/agent-dark.gif">
  125. ### Trading Journal
  126. Your trades with their equity curve, win rate, profit factor, Sharpe and drawdown, filtered by
  127. side, ticker, strategy, class or tag. R-multiple analytics, behaviour patterns and a PnL calendar
  128. sit one click away.
  129. <picture>
  130. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/journal-dark.png">
  131. <img width="80%" alt="Trading Journal: equity curve and performance statistics" src="docs/public/screenshots/journal-light.png">
  132. </picture>
  133. ### Portfolio Tracker
  134. Holdings priced daily, cost basis, unrealized and realized P/L, allocation by asset or class, and
  135. the full ledger of operations behind them.
  136. <picture>
  137. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/portfolio-dark.png">
  138. <img width="80%" alt="Portfolio Tracker: value history, allocation donut and holdings table" src="docs/public/screenshots/portfolio-light.png">
  139. </picture>
  140. ### Quant Tools
  141. The risk profile of any stored dataset: volatility, drawdown, value at risk, expected shortfall
  142. and the return distribution. Then correlation, efficient frontier, position sizing and
  143. derivatives in the next tabs.
  144. <picture>
  145. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/quant-dark.png">
  146. <img width="80%" alt="Quant Tools: BTCUSDT risk metrics, drawdown curve and return distribution" src="docs/public/screenshots/quant-light.png">
  147. </picture>
  148. ### Fundamentals
  149. Macro series from central banks and statistics offices, charted together with recession
  150. shading. Company statements, filings, ETFs, a market calendar and alternative data live in the
  151. next tabs.
  152. <picture>
  153. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/fundamentals-dark.png">
  154. <img width="80%" alt="Fundamentals: US CPI and the Fed funds rate on one macro chart" src="docs/public/screenshots/fundamentals-light.png">
  155. </picture>
  156. ### News
  157. Your RSS and JSON-API feeds in one stream, polled on a schedule, searchable and filterable by
  158. source.
  159. <picture>
  160. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/news-dark.png">
  161. <img width="80%" alt="News: market headlines from CNBC, Bloomberg, MarketWatch, CoinDesk and central banks" src="docs/public/screenshots/news-light.png">
  162. </picture>
  163. ### Automator
  164. Chain blocks into a workflow: a call to the app's own API or any URL, an AI step, a condition, a
  165. notification. Put it on a schedule and read every run afterwards.
  166. <picture>
  167. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/automator-dark.gif">
  168. <img width="80%" alt="Automator: opening the Pre-market briefing workflow, its AI step, then the run history" src="docs/public/screenshots/automator-light.gif">
  169. </picture>
  170. ### Trading Routines
  171. Pre-market, in-session and review checklists, each step with its own how-to, tracked by week,
  172. month and year.
  173. <picture>
  174. <source media="(prefers-color-scheme: dark)" srcset="docs/public/screenshots/routines-dark.png">
  175. <img width="80%" alt="Trading Routines: pre-market, execution and review checklists for the day" src="docs/public/screenshots/routines-light.png">
  176. </picture>
  177. ## Upgrading
  178. **Settings → Update app** tells you when a new version is out. The app cannot update itself
  179. (it has no shell or Docker access, by design), so run these on the host. Take a database
  180. backup first; migrations run automatically on the new container's first boot.
  181. A default install (prebuilt images, no git checkout) refreshes `deploy/` from the latest
  182. release (the public `master`), then pulls the new images. Your `.env`, `network.env` and `dns.env` are left alone.
  183. ```bash
  184. cd /path/to/opentraderworld
  185. TMP=$(mktemp -d)
  186. curl -fsSL https://codeload.github.com/G-OTW/OpenTraderWorld/tar.gz/master | tar -xz -C "$TMP"
  187. cp -R "$TMP"/*/deploy/. deploy/
  188. rm -rf "$TMP"
  189. docker compose -f deploy/docker-compose.yml -f deploy/docker-compose.images.yml \
  190. --env-file deploy/.env --env-file deploy/network.env \
  191. pull
  192. docker compose -f deploy/docker-compose.yml -f deploy/docker-compose.images.yml \
  193. --env-file deploy/.env --env-file deploy/network.env \
  194. up -d
  195. ```
  196. A source build (installed with `--build`, from a full clone) refreshes the checkout and
  197. rebuilds. Releases are fresh snapshots, so reset to the release rather than `git pull`.
  198. `git reset --hard` discards any local edits to tracked files.
  199. ```bash
  200. cd /path/to/OpenTraderWorld
  201. git fetch origin
  202. git reset --hard origin/master
  203. docker compose -f deploy/docker-compose.yml \
  204. --env-file deploy/.env --env-file deploy/network.env \
  205. up -d --build
  206. ```
  207. ## Try it without installing
  208. There is a public sandbox at **[demo.opentraderworld.com](https://demo.opentraderworld.com)**,
  209. also linked from the [website](https://opentraderworld.com). No account, no install, and it
  210. comes seeded with realistic data so you land in an instance that looks used rather than empty.
  211. One thing to keep in mind: it is *shared*. Everything you type is visible to other visitors,
  212. the whole database is wiped and re-seeded **every 15 minutes**, connectors are read-only, and
  213. settings, the Vault, broker accounts, notification channels and paper trading are disabled. It runs on a small free-tier server with free AI models, so it is
  214. slower than a local install. For anything real, install it. Two minutes.
  215. ## What's inside
  216. Every module ships with the app. Install what you use, detach the rest.
  217. ### Trading
  218. | Module | What it does |
  219. |---|---|
  220. | [Trading Journal](https://g-otw.github.io/OpenTraderWorld/modules/journal) | Trade log with templates, fee schedules, multi-currency FX and performance stats. |
  221. | [Trading Routines](https://g-otw.github.io/OpenTraderWorld/modules/productivity#routines) | Recurring session checklists: pre-market prep, in-session discipline, post-market review. |
  222. | [Mindset](https://g-otw.github.io/OpenTraderWorld/modules/productivity#mindset) | Daily mood and discipline check-ins, with a progress dashboard compared to your journal. |
  223. ### Market data and analysis
  224. | Module | What it does |
  225. |---|---|
  226. | [Historical Data](https://g-otw.github.io/OpenTraderWorld/modules/market-data#histdata) | Download OHLCV history from several providers into local datasets, or import your own file. |
  227. | [Charts](https://g-otw.github.io/OpenTraderWorld/modules/market-data#histviz) | 18 chart types (candles, Heikin Ashi, Renko, Kagi, point & figure…) with indicators, Pine Script v5/v6 compatible scripts and alerts, live or on demand, on any instrument a connector serves. |
  228. | [Backtest](https://g-otw.github.io/OpenTraderWorld/modules/market-data#backtest) | Signal, grid and DCA strategies with sizing, costs, an optimizer and paper trading forward. |
  229. | [Quant Tools](https://g-otw.github.io/OpenTraderWorld/modules/market-data#quant) | Risk and return analytics: VaR, correlation, efficient frontier, position sizing, Kelly. |
  230. | [Options](https://g-otw.github.io/OpenTraderWorld/modules/market-data#options) | Option chains from Interactive Brokers, Massive or Alpaca, American pricing with cash dividends, and a multi-leg builder with payoff, margin estimate and assignment warnings. For analysis: no orders are sent. |
  231. | [Scanner](https://g-otw.github.io/OpenTraderWorld/modules/market-data#scanner) | Watches instruments and hives of them with reusable signals, events and candlestick patterns on each closed bar, shows them on boards and notifies the hits. |
  232. | [Fundamentals](https://g-otw.github.io/OpenTraderWorld/modules/fundamentals) | Macro series, company statements, SEC filings, transcripts, ETFs, a market calendar and alternative data from primary sources and the aggregators you connect. |
  233. ### Portfolios and money
  234. | Module | What it does |
  235. |---|---|
  236. | [Watchlists](https://g-otw.github.io/OpenTraderWorld/modules/portfolio#watchlists) | Symbol watchlists with live prices, day changes, sparklines and notes. |
  237. | [Portfolio Tracker](https://g-otw.github.io/OpenTraderWorld/modules/portfolio#portfolios) | Live portfolio value with a buy/sell ledger and holdings priced daily. |
  238. | [MyWealth](https://g-otw.github.io/OpenTraderWorld/modules/portfolio#wealth) | Net worth across everything you own: accounts, property, crypto, valuables. |
  239. | [Managers' Portfolios](https://g-otw.github.io/OpenTraderWorld/modules/portfolio#mportfolios) | Superinvestor 13F holdings, browsable and snapshotable. |
  240. | [Tax Calculator](https://g-otw.github.io/OpenTraderWorld/modules/portfolio#taxcalc) | Trading and investing tax estimates from country templates. |
  241. | [Subscriptions](https://g-otw.github.io/OpenTraderWorld/modules/portfolio#subscriptions) | Your recurring subscriptions and what they cost you. |
  242. ### News and research
  243. | Module | What it does |
  244. |---|---|
  245. | [News](https://g-otw.github.io/OpenTraderWorld/modules/news-research#news) | RSS and JSON-API news aggregator with polling dashboards. |
  246. | [Mailbox](https://g-otw.github.io/OpenTraderWorld/modules/news-research#mailbox) | Newsletters, market news and broker mail read from your own IMAP mailbox, tracker-free. |
  247. | [Economic Calendar](https://g-otw.github.io/OpenTraderWorld/modules/news-research#economics) | Upcoming macro events. |
  248. | [FinanceDatabase](https://g-otw.github.io/OpenTraderWorld/modules/news-research#findb) | Search 300,000+ instruments locally, and file your favorites in folders. |
  249. | [Resources](https://g-otw.github.io/OpenTraderWorld/modules/news-research#resources) | Bookmark library for books, links and references. |
  250. | [Community Docs](https://g-otw.github.io/OpenTraderWorld/modules/news-research#community-docs) | Guides written by the community, synced and readable offline. |
  251. ### Notes and organization
  252. | Module | What it does |
  253. |---|---|
  254. | [Editor](https://g-otw.github.io/OpenTraderWorld/modules/productivity#editor) | Rich document editor with folders and table/kanban/gallery databases. |
  255. | [ToDo](https://g-otw.github.io/OpenTraderWorld/modules/productivity#todos) | Task list with due dates and categories. |
  256. | [Goals](https://g-otw.github.io/OpenTraderWorld/modules/productivity#goals) | Goals with metric tracking and deadlines. |
  257. | [Calendar](https://g-otw.github.io/OpenTraderWorld/modules/productivity#calendar) | Personal event calendar, with reminders, todos and goals overlaid on it. |
  258. | [RemindMe](https://g-otw.github.io/OpenTraderWorld/modules/productivity#remindme) | Reminders with in-app notifications and email/Telegram/Slack/Discord channels. |
  259. | [Time Tracker](https://g-otw.github.io/OpenTraderWorld/modules/productivity#time) | Project timers with budgets and hourly-rate value. |
  260. | [Prompt Store](https://g-otw.github.io/OpenTraderWorld/modules/productivity#prompt-store) | Searchable library of reusable AI prompts, tagged, rated and versioned. |
  261. | [Webhooks](https://g-otw.github.io/OpenTraderWorld/modules/productivity#webhooks) | Private inbound URLs that turn external alerts into notifications or Automator runs. |
  262. | [Automator](https://g-otw.github.io/OpenTraderWorld/modules/automator) | Scheduled workflows: call your own API or any URL, ask an AI step, transform, notify. |
  263. ### AI
  264. | Module | What it does |
  265. |---|---|
  266. | [Agent](https://g-otw.github.io/OpenTraderWorld/modules/agent) | Built-in AI chat assistant. Bring your own provider, switch model or prompt mid-conversation, and let it act on your data through MCP, with memory, skills and external MCP servers. Reachable from a floating chat on every page. |
  267. The full tour, with details, is in [the module docs](https://g-otw.github.io/OpenTraderWorld/modules/).
  268. ## Backtesting: signals, grid, DCA
  269. One engine, three ways to describe a strategy. No code.
  270. - **[Signals](https://g-otw.github.io/OpenTraderWorld/modules/market-data#backtest).** Entry and
  271. exit rules from indicators, price and values, long or short, with stops, pyramiding, and
  272. sizing by fixed quantity, percent of equity, risk per trade, Kelly or equity tiers. Build your own indicators,
  273. and the chart draws the same ones.
  274. - **[Grid](https://g-otw.github.io/OpenTraderWorld/modules/market-data#grid-strategy).** A ladder
  275. of levels between two bounds, long, short or neutral. Each cell buys low and sells one level up.
  276. - **[DCA](https://g-otw.github.io/OpenTraderWorld/modules/market-data#dca-savings-plan).** A
  277. weighted basket bought over time, never rebalanced: recurring contributions, buy tranches on a
  278. dip, sell rules on a gain objective. Measured like a savings plan, with IRR and a
  279. deposit-adjusted drawdown.
  280. Run any of them on one instrument or a whole portfolio, with exposure limits and a per-asset
  281. breakdown.
  282. ### Optimizer
  283. Take a run and vary its parameters: indicator lengths, thresholds, stops, sizing, costs,
  284. portfolio limits, grid settings, DCA amounts, excluded weekdays. Each gets a from / to / step.
  285. - It **prices the job first**, from what past runs measured on your own machine. Stop at any
  286. point and keep what is computed.
  287. - **Rank** on Sharpe, Sortino, return, net PnL, profit factor, win rate, expectancy, average
  288. trade, drawdown or trades. Any column re-sorts after, except the out-of-sample return: it is
  289. shown, never ranked.
  290. - **The spread matters more than the winner**: worst, average, best, and how many variants came
  291. out positive. One good number surrounded by terrible neighbours is noise.
  292. - **A multiple-testing haircut** puts the best Sharpe against the bar the best of *N* worthless
  293. strategies would clear anyway. Below it, the winner is explained by the number of tries.
  294. - Click any variant to read its full backtest. Nothing is stored until you keep it.
  295. Add an **in-sample / out-of-sample split** and the two stat blocks sit side by side. A wide gap
  296. between them is overfitting.
  297. ## Paper trading: the backtest, left running forward
  298. Press one button on a run you like and it keeps going on new candles. There is no second
  299. engine and no serialized simulator to drift: each tick reloads the window, runs the ordinary
  300. backtest, and diffs the trades against what is already stored. A session opened from a result
  301. reproduces that result exactly.
  302. - **Its own schedule**: every N minutes, daily, weekly, monthly or once, in your timezone.
  303. - **Live alerts** on entries and exits, or **a period summary** instead. Alert on every tick,
  304. only when something changed, or never.
  305. - **Summary cadence**: on each tick, hourly, daily or weekly. Entry and exit alerts always
  306. leave on the tick that produced them; turn them off to get only the summary.
  307. - **Your wording, not ours.** Entry, exit and summary messages are templates you write, with a
  308. preview against a sample trade before you save.
  309. - Anything the app could not deliver waits in the session inbox. You read it at the next login.
  310. Filter alerts down to the tickers you care about, and pick which channels a session pushes to.
  311. ## Data connectors
  312. One connector list for the whole app. A connector is a provider account, its credentials
  313. (typed in or plugged from the encrypted Vault, write-only once saved), an optional request
  314. limit, and the modules allowed to use it. Modules have no provider settings of their own.
  315. | Provider | Credentials | Asset types | Symbol search | Live stream |
  316. |---|---|---|---|---|
  317. | **Binance** | none | crypto spot | yes | yes |
  318. | **Binance USDⓈ-M Futures** | none | crypto perpetuals and futures | yes | yes |
  319. | **Bitfinex** | none | crypto spot and perpetuals | yes | yes |
  320. | **Bitget** | none | crypto spot and USDT-M futures | yes | yes |
  321. | **Bybit** | none | crypto spot, perpetuals and futures | yes | yes |
  322. | **Bybit EU** | none | crypto spot | yes | yes |
  323. | **Coinbase** | none | crypto spot | yes | yes |
  324. | **Deribit** | none | crypto spot, perpetuals, futures and options | yes | yes |
  325. | **Gate.io** | none | crypto spot and perpetuals | yes | yes |
  326. | **Kraken** | none | crypto spot | yes | yes |
  327. | **KuCoin** | none | crypto spot | yes | yes |
  328. | **KuCoin Futures** | none | crypto perpetuals and futures | yes | yes |
  329. | **MEXC** | none | crypto spot and perpetuals | yes | yes |
  330. | **OKX** | none | crypto spot, perpetuals and futures | yes | yes |
  331. | **Yahoo Finance** | none | equity, ETF, index, crypto | yes | no |
  332. | **Alpha Vantage** | API key | equity, ETF | yes | no |
  333. | **EODHD** | API key | equity, ETF, FX, crypto | yes | no |
  334. | **Alpaca** | key + secret | equity, crypto, options | yes | yes (based on your broker subscription) |
  335. | **Massive (Polygon.io)** | API key | equity, ETF, options, futures, crypto, FX, index | yes | yes (paid plan) |
  336. | **OANDA** | API token + account id | FX, CFDs | yes | no |
  337. | **TradeStation** | OAuth: client id, secret, refresh token | equity, ETF, options, futures, index | by symbol | no |
  338. | **FOREX.com (StoneX)** | username + password + AppKey | FX, CFDs | yes | no |
  339. | **Capital.com** | API key + identifier + password | FX, indices, shares, crypto (all CFDs) | yes | yes |
  340. | **Interactive Brokers** | none (your own gateway) | equity, ETF, crypto, FX, index, futures, options | yes | yes (based on your broker subscription) |
  341. Every provider connects directly, with an API key or none at all. Interactive Brokers is the
  342. exception: you run IB Gateway or TWS yourself and the connector stores a host and a port.
  343. OANDA, TradeStation, FOREX.com and Capital.com are broker feeds: they read the prices of the
  344. account you already have there, so they ask for that account's credentials.
  345. Details in [the connectors guide](https://g-otw.github.io/OpenTraderWorld/config/connectors).
  346. ### Live feeds
  347. Every timeframe a provider downloads, it also streams, daily and weekly included. A provider
  348. that publishes one grain (Alpaca, Massive, Interactive Brokers) has the larger timeframes folded
  349. from it, and a session-shaped candle (daily, weekly) is re-read from the provider once it closes.
  350. | Provider | Price updates from | Best bid / ask |
  351. |---|---|---|
  352. | **Binance**, **Binance USDⓈ-M Futures** | candles | yes |
  353. | **Bitfinex**, **Bitget**, **Bybit**, **Bybit EU**, **Deribit** | candles | yes |
  354. | **Gate.io**, **Kraken**, **KuCoin**, **KuCoin Futures**, **MEXC**, **OKX** | candles | yes |
  355. | **Coinbase** | trades | yes |
  356. | **Capital.com** | bid and ask candles, charted at their mid | yes, from the candles |
  357. | **Alpaca** | one-minute bars (trades on options) | yes |
  358. | **Massive** | one-minute aggregates | yes, a separate Massive plan; none on indices |
  359. | **Interactive Brokers** | trades (midpoint on cash FX and crypto, five-second bars on options and indices) | yes, none on indices |
  360. OANDA, TradeStation and FOREX.com download history but do not stream: their live prices are not
  361. served over a WebSocket. A chart can draw the live best bid and ask as two lines, and paper
  362. trading fills on them.
  363. Missing a provider? [Ask for it](https://github.com/G-OTW/OpenTraderWorld/issues) and it gets
  364. added.
  365. ## Broker accounts
  366. A broker account links to the place you trade, and only reads by default. It imports your fills into
  367. the journal, aligns a portfolio on what the account holds, draws positions and working orders
  368. on the chart, and reads a tax year. It sends orders only where the broker takes them and you
  369. turn **Trading** on for the account ([experimental](https://g-otw.github.io/OpenTraderWorld/config/trading)).
  370. | Broker | Reads | Trading from the chart |
  371. |---|---|---|
  372. | **Interactive Brokers (Gateway)** | recent fills (chart markers), positions, orders, account | yes, experimental (live and paper accounts) |
  373. | **Binance** | fills, orders, holdings, account | yes, experimental (live and Spot Demo Mode) |
  374. | **Binance USDⓈ-M Futures** | fills, positions, orders, margin balances | yes, experimental (live and futures testnet) |
  375. | **Paper trading** (simulated, run by the app) | fills, positions, orders, account | yes |
  376. | **Alpaca** | fills, positions, orders, holdings | no |
  377. | **Bitfinex**, **Bitget**, **Bybit**, **Deribit**, **Gate.io**, **MEXC**, **OKX** | fills, positions, orders, holdings | no |
  378. | **Bybit EU**, **Coinbase Advanced Trade**, **Kraken**, **KuCoin** | fills, orders, holdings | no |
  379. | **KuCoin Futures** | fills, positions, orders | no |
  380. | **OANDA**, **TradeStation**, **FOREX.com (StoneX)**, **Capital.com**, **NinjaTrader** | fills, positions, orders, holdings | no |
  381. | **Interactive Brokers (Flex)** | fills, positions, holdings | no |
  382. Where a broker issues a view-only key, the form asks for that one. Journal imports from
  383. Interactive Brokers go through the Flex account. A live account trades only once you turn
  384. **Live trading** on for it, which requires a size limit per order, a size limit per position and
  385. a loss limit. Details in
  386. [the broker accounts guide](https://g-otw.github.io/OpenTraderWorld/config/brokers).
  387. ## Fundamentals
  388. Macro series, company statements, SEC filings, earnings-call transcripts, ETF holdings, a
  389. market calendar and alternative data, read from the sources that publish them and stored in
  390. your own database. Every source is a data connector granted to the module; nothing is fetched
  391. until you add one. When several providers serve the same data, they are tried in the order you
  392. set.
  393. | Provider | Key | What it serves |
  394. |---|---|---|
  395. | **SEC EDGAR** | none | statements, filings, insider trades |
  396. | **FRED (St. Louis Fed)** | free | macro series |
  397. | **US Treasury** | none | yield curve, public debt |
  398. | **ECB, Eurostat** | none | euro-area macro series |
  399. | **BIS** | none | central-bank policy rates, effective exchange rates |
  400. | **OECD, IMF, World Bank** | none | leading indicators, World Economic Outlook, country data |
  401. | **BLS, BEA, EIA, US Census** | free | US macro detail |
  402. | **CFTC** | none | Commitments of Traders |
  403. | **FINRA** | none | short interest |
  404. | **Financial Modeling Prep** | free tier (holders and transcripts: Ultimate plan) | estimates, earnings, segments, dividends, holders, peers, ESG, ETF, calendar, transcripts |
  405. | **Finnhub** | free tier (estimates, ESG, transcripts, congress trades: premium) | estimates, earnings, peers, ESG, calendar, transcripts, congress trades |
  406. | **Alpha Vantage** | free tier | estimates, earnings, dividends, ETF, calendar, transcripts |
  407. | **EODHD** | paid | dividends, ETF, calendar |
  408. | **Massive (Polygon.io)** | free tier | dividends, short interest |
  409. | **USAspending** | none | government contracts |
  410. | **LDA.gov** | free | lobbying |
  411. | **USPTO Open Data Portal** | free | patents |
  412. | **Quiver Quant** | paid | congress trades, lobbying, contracts, patents |
  413. Prices and market ratios come from any market-data connector with daily equity bars. Details
  414. in [the Fundamentals guide](https://g-otw.github.io/OpenTraderWorld/modules/fundamentals).
  415. ## Notifications
  416. These are the notification methods available today. More are planned: if your preferred one is
  417. missing, [ask for it](https://github.com/G-OTW/OpenTraderWorld/issues).
  418. | Channel | What you provide |
  419. |---|---|
  420. | **Email** | your own SMTP server |
  421. | **Telegram** | a bot token and a chat id |
  422. | **Slack** | an incoming webhook URL |
  423. | **Discord** | an incoming webhook URL |
  424. Secrets are sealed on save and never shown again. What can notify you: chart alerts and broker
  425. reconcile notices, paper trading sessions, watchlist alerts, reminders, finished or parked data
  426. downloads, fundamentals refreshes, new mail, journal, portfolio and tax imports, live feed
  427. outages, sign-in alerts, inbound webhooks, and any automator workflow. Everything is off until you switch it on, and
  428. in-app notifications work without configuring a single channel.
  429. ## Voice control
  430. Push to talk, never always listening: the microphone opens while you hold a shortcut (or click
  431. the mic in the top bar) and closes when you release.
  432. - **Command mode** (`Alt+V`): what you say becomes a plan. *"open journal"* works out of the
  433. box in seven languages; anything no command matches can go to the AI agent.
  434. - **Dictation mode** (`Alt+Shift+V`): what you say is typed into the focused text field, never
  435. read as a command.
  436. - **Voice commands**: a phrase you choose runs a sequence of steps (open a page, ask the agent,
  437. run an Automator workflow, switch theme, hide figures, speak a sentence). Say several in one
  438. go, *"turtle, then open settings"*, and they run in order.
  439. - **Confirmation first**: every plan is shown before it runs, unless you mark a command to skip
  440. it (off by default). A phrase fires only on its own, never as a word inside a sentence.
  441. Speech engines work like the other brokers: one list in Settings → Voice, keys sealed or
  442. plugged from the Vault.
  443. | Engine | Setup | Where the audio goes |
  444. |---|---|---|
  445. | **This browser** | none (Chrome, Edge, Safari) | the browser vendor's speech service |
  446. | **Self-hosted Whisper** | optional bundled service, `--profile voice` | stays on your machine |
  447. | **whisper.cpp** | your own server | stays on your server |
  448. | **OpenAI, Groq** | API key | that provider |
  449. | **Any OpenAI-compatible server** | URL, model, optional key | that server |
  450. The browser only allows the microphone over HTTPS or on localhost. Details in
  451. [the voice control guide](https://g-otw.github.io/OpenTraderWorld/config/voice).
  452. ## ⭐ Enjoying it? Help it grow
  453. OpenTraderWorld is free and built in the open. If it is useful to you, the easiest way to give
  454. back costs nothing:
  455. - **Star the repo.** It is a quick signal, and it helps other people find the project.
  456. - **Share it.** A word to a fellow trader, a link in your community, a mention anywhere. It
  457. helps more than you would think.
  458. No pressure. Even just trying it out and telling a friend means a lot. 🙏
  459. Got ideas, or found a bug? See [Suggest, vote, contribute](#-suggest-vote-contribute) below.
  460. ## 💡 Suggest, vote, contribute
  461. This project grows on user feedback:
  462. - **Suggest a feature or a module.** Head to
  463. [opentraderworld.com/suggestions](https://opentraderworld.com/suggestions) and describe what
  464. you are missing and how you would use it.
  465. - **Vote.** 👍 the suggestions you want most on the website. Popular requests get prioritized.
  466. - **Report bugs.** Open an [issue](https://github.com/G-OTW/OpenTraderWorld/issues) with the
  467. symptom and a few log lines.
  468. - **Write for the community.** Guides written in the app's Editor can be submitted for
  469. publication in the shared [Community Docs](https://opentraderworld.com/docs) library, where
  470. every install can read them.
  471. ## Project links
  472. | Where | What you'll find |
  473. |---|---|
  474. | [**opentraderworld.com**](https://opentraderworld.com) | Project home: module overview, community guides, roadmap voting, demo. |
  475. | [opentraderworld.com/tools](https://opentraderworld.com/tools) | The 25+ modules by domain, in plain language. |
  476. | [opentraderworld.com/docs](https://opentraderworld.com/docs) | Community Docs: trading guides written by users, synced into every install. |
  477. | [opentraderworld.com/hosting/setup](https://opentraderworld.com/hosting/setup) | Guided install, step by step. |
  478. | [opentraderworld.com/suggestions](https://opentraderworld.com/suggestions) | Suggestions and polls: propose features, vote on the roadmap. |
  479. | [demo.opentraderworld.com](https://demo.opentraderworld.com) | Live shared demo, reseeded every 15 minutes. |
  480. | [Documentation](https://g-otw.github.io/OpenTraderWorld/) | Install, configuration and module reference. |
  481. | [GitHub](https://github.com/G-OTW/OpenTraderWorld) | Source, releases, issues. |
  482. ## Under the hood
  483. | Layer | Tech |
  484. |-------|------|
  485. | Backend / core | **Rust** (Axum): API, scheduler, background jobs |
  486. | Frontend | **SvelteKit** single-page app |
  487. | Data | **PostgreSQL**, the only place your data lives |
  488. | Reverse proxy / TLS | **Caddy**, automatic HTTPS certificates |
  489. | Deployment | **Docker Compose**, non-intrusive and quickly rebuilt |
  490. ```
  491. OpenTraderWorld/
  492. ├── install.sh # one-command installer (fetches deploy/, runs setup)
  493. ├── deploy/ # docker-compose stack, setup.sh, Caddy config
  494. ├── core/ # Rust workspace (API, store, scheduler, feeds…)
  495. ├── frontend/ # SvelteKit app (modules UI)
  496. ├── docs/ # documentation site (VitePress)
  497. ├── scripts/ # validation and parity checks
  498. └── testbook/ # non-regression run against a throwaway instance
  499. ```
  500. ## Status
  501. Actively developed. It is usable today and moving fast. Check **Settings → Update app** in the
  502. app to know when a new version is out.
  503. ## Disclaimer
  504. This software is for **educational and informational purposes only**. It is **not** financial,
  505. investment, or trading advice. **USE IT AT YOUR OWN RISK.** The author and any affiliates
  506. accept **no responsibility** for your trading or investment results, or for any loss or damage
  507. arising from use of this software. Never risk money you cannot afford to lose. There will be
  508. bugs: the software is provided **"as is", without warranty of any kind**. You alone are
  509. responsible for how you use it and for the decisions you make with it.
  510. ## License
  511. [FSL-1.1-MIT](LICENSE) (Functional Source License). Free for everyone, including commercial
  512. use, self-hosting at work, modification, redistribution and forks. The one thing it does not
  513. grant is a **Competing Use**: selling the software, or offering it to others as a paid product
  514. or a hosted service. Each release turns into plain **MIT** two years after it is published.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.