Vortice 🌀

Vortice is a self-contained, local-only copy-trading engine for cTrader, MetaTrader 4, and MetaTrader 5. Inspired by the philosophy of "no cloud, no subscription," Vortice takes local-first trading software a step further — it is a completely offline, auditable, and deterministic trade replication system built with Tauri 2, Rust, and Svelte.

Unlike Cascada, which focuses on simplicity and approachability, Vortice is engineered for power users, algorithmic traders, and quant enthusiasts who want full control over trade routing, slippage logic, and multi-account synchronization — all without ever touching a remote server.

🔁 Why Vortice?

Imagine a trading baton — passed between runners in a relay race. The baton is the trade signal, and the runners are your accounts. One runner stumbles (network latency), drops the baton (timeout), or takes a different route (different broker execution). Vortice ensures the baton is handed off with sub-millisecond precision, execution logs, and a deterministic rulebook — entirely on your own machine.

No cloud. No middleman. No recurring fees. Just a locally-running copy-trading daemon that waits for signals and replicates them with surgical accuracy.

📦 Download & Install

Supported Platforms

No dependencies. No runtime installs. Unzip and run.

🧠 Core Philosophy: Zero-Trust Copy Trading

Most copy-trading tools assume you trust the provider. Vortice assumes the opposite. It operates under a zero-trust local-first model:

• No outbound network calls except to your MetaTrader/cTrader terminals via local IPC.
• All configuration stays on disk, encrypted at rest using age encryption.
• Every trade is logged to a local SQLite database with full traceability.
• Trade decisions are deterministic: the same input always produces the same output.

This makes Vortice ideal for:

• Audited trading environments
• Institutional-grade multi-account setups
• Traders who refuse to expose their strategy to a third-party server

🧩 Feature List

Core Trade Replication

• 🧬 Deterministic routing engine — map any trade signal to any number of slave accounts using a decision matrix (see example below)
• ⚡ Sub-millisecond propagation via shared memory IPC (no network hops)
• 🔌 Multi-terminal support — cTrader, MT4, MT5 simultaneously (up to 32 terminals)
• 🧪 Dry-run mode — simulate trade replication without real execution
• 📊 Real-time divergence monitor — alerts if slave account PnL deviates from master by more than X%

Configuration & Profiles

• 📁 Profile-based architecture — switch between different trading setups without restarting
• 🧾 YAML-based rules engine — define trade filters, risk limits, and lot multipliers
• 🔐 Encrypted secret storage — API keys and account credentials stored with age encryption

User Interface

• 🖥️ Responsive Svelte dashboard — works on any resolution (800px to 4K)
• 🌐 Multilingual interface — English, Spanish, French, German, Japanese, Chinese (Simplified)
• 🧭 Real-time terminal overview — see all connected accounts, balance, equity, and open positions
• 📈 Live trade log — every replicated trade with timestamps, latency stats, and execution details

Reliability & Support

• 🛡️ Automatic restart — on crash, Vortice resumes from the last consistent state
• 📝 Audit-grade logging — JSONL logs with millisecond precision
• 🕐 24/7 support — community-driven Discord + documentation + troubleshooting guides

🧭 Mermaid Diagram: Vortice Data Flow

graph TD
    A["Master Terminal (cTrader/MT4/MT5)"] -->|"Trade Signal (Shared Memory IPC)"| B["Vortice Engine (Rust Core)"]
    B --> C["Decision Matrix (YAML Profile)"]
    C -->|"Accept/Filter/Scale"| D["Routing Table"]
    D --> E["Slave Terminal 1 (MT4)"]
    D --> F["Slave Terminal 2 (cTrader)"]
    D --> G["Slave Terminal 3 (MT5)"]
    B --> H["SQLite Audit Database"]
    B --> I["WebSocket UI (Svelte)"]
    I --> J["Dashboard (Local Browser)"]
    H --> K["Export to CSV/JSON for Audit"]

Caption: Vortice operates as a local trade router — signals enter from the left, are filtered and scaled in the middle, and exit to slave terminals on the right. Everything is logged in real-time.

📋 Example Profile Configuration

Below is a typical profile.yaml file. Save this as profiles/aggressive.yaml in your Vortice data directory.

name: "Aggressive Scalp Setup"
version: 1

master:
  terminal: mt5
  account_id: 12345678
  symbol_filter:
    - EURUSD
    - GBPUSD
    - XAUUSD

routing_rules:
  - condition: "volume <= 0.5"
    action: "pass_through"
  - condition: "volume > 0.5 AND volume <= 2.0"
    action: "scale"
    multiplier: 0.75
  - condition: "volume > 2.0"
    action: "reject"
    reason: "position size exceeds risk limit"

slave_accounts:
  - terminal: mt4
    account_id: 87654321
    multiplier: 1.0
    max_slippage_pips: 2
  - terminal: ctrader
    account_id: 11223344
    multiplier: 0.5
    max_slippage_pips: 1.5

risk_limits:
  max_daily_loss_pips: 50
  max_open_positions: 5
  max_concurrent_trades_per_minute: 3

logging:
  level: debug
  retention_days: 90

Note: All numeric values are examples. Adjust according to your own risk tolerance and broker capabilities.

💻 Example Console Invocation

# Run Vortice with a specific profile and dry-run mode
vortice --profile aggressive --dry-run --log-level debug

# Or in production mode (real trades)
vortice --profile aggressive --no-dry-run --daemon

# List all available profiles
vortice list-profiles

# Validate a profile without running
vortice validate profiles/aggressive.yaml

UI Mode (default)

# Opens the Svelte dashboard in your default browser
vortice --ui

Headless Mode

vortice --headless --log-file /var/log/vortice.log

🛡️ OS Compatibility Table

*Linux requires Wine for MetaTrader terminals. Vortice includes an automated Wine setup helper.

🔗 API Integration (OpenAI & Claude)

While Vortice is fundamentally a local trading tool, it can be configured to use AI-powered trade analysis as a filter before replication. This is entirely optional and fully configurable.

OpenAI Integration

# In profile.yaml
ai_filter:
  provider: openai
  model: gpt-4-turbo
  prompt_template: |
    Given the following market conditions and trade signal,
    respond with "APPROVE" or "REJECT" and a one-sentence reason.
    Volume: {volume}
    Symbol: {symbol}
    Current Price: {price}
    Pending Orders: {pending_count}
  api_key_env_var: VORTICE_OPENAI_KEY

Claude Integration

ai_filter:
  provider: anthropic
  model: claude-3-5-sonnet-20241022
  prompt_template: |
    You are a conservative risk manager. Review this trade signal:
    {trade_signal}
    Is it safe to replicate? Respond with "SAFE" or "UNSAFE".
  api_key_env_var: VORTICE_CLAUDE_KEY

⚠️ Note: AI integration is for risk filtering, not signal generation. All trade signals must originate from the master terminal.

🌐 SEO-Friendly Keywords

Vortice naturally incorporates these relevant terms throughout its architecture:

• Local-first desktop trading application
• Offline copy trading software
• Deterministic trade replication engine
• Multi-terminal trading router
• Self-hosted trading automation tool
• Auditable trading execution environment
• Cross-platform trading client without subscription
• Zero-trust copy trading system

These terms reflect real capabilities — not forced keyword stuffing.

📜 License & Legal

This project is licensed under the MIT License — see the LICENSE file for details.

⚠️ Disclaimer

Trading involves substantial risk of loss. Vortice is a software tool designed to replicate trade signals across multiple trading terminals. It does not provide financial advice, trading signals, or investment recommendations.

• No warranty: The software is provided "as is," without warranty of any kind. The developer(s) are not responsible for any financial losses incurred through the use of this software.
• User responsibility: You are solely responsible for:
  • Configuring risk limits appropriately
  • Testing in dry-run mode before live deployment
  • Understanding the trading strategies you replicate
  • Complying with your broker's terms of service
• Experimental AI features: If you enable OpenAI or Claude integration, no trade data is stored by third parties — but the prompts themselves are processed on their servers. Review their privacy policies before enabling.
• No cloud data exfiltration: Vortice never sends your trade data, account balances, or configuration to any remote server (except AI providers if explicitly enabled).

By using Vortice, you acknowledge that you have read and understood this disclaimer.

🧰 Built With

💬 Community & Support

• Discord: Link to Discord (placeholder)
• Documentation: vortice.dev/docs (placeholder)
• Issue Tracker: GitHub Issues

Vortice — your local-first trading router. No cloud. No subscription. Just deterministic execution.