# SwietcherBot

> SwietcherBot is an automated trading and market intelligence platform that connects TradingView alerts and custom webhooks to cTrader, Binance, and Bybit with sub-100ms execution latency, autonomous AI position management (Ralph AI Trader), and multi-account prop trading bridging (SwietProp Desktop).

## Overview

SwietcherBot eliminates manual execution friction by providing a unified, secure gateway between market analysis tools (TradingView, custom scripts) and institutional execution venues. It features:
- **Instant Webhook Execution:** Sub-100ms order routing to 100+ cTrader brokers, Binance USDT-M Futures, and Bybit V5 Unified.
- **Ralph AI Trader:** Autonomous position management engine evaluating multi-timeframe regime changes, scaling Take Profits, trailing Stop Losses, and providing Telegram approval workflows.
- **SwietProp Desktop:** Desktop execution and bridge connecting NinjaTrader 8 to prop trading challenges (Apex, Topstep, FundedNext) with multi-account synchronization.
- **AI Market Screener:** Over 750 real-time metrics, MTF scoring, volume spikes, and algorithmic opportunity detection across Crypto and Forex.
- **Enterprise Security:** AES-256-GCM encrypted API storage, cTrader official OAuth 2.0, 2FA, rate limiting, and Cloudflare WAF protection.

## Core Capabilities

### 1. TradingView to cTrader Webhook Router
- **Execution Endpoint:** `https://swietcherbot.space/webhook`
- **Supported Assets:** Forex (EURUSD, GBPUSD, USDJPY, etc.), Metals (Gold/XAUUSD, Silver/XAGUSD), Indices (US30, NAS100, GER40), Commodities (USOIL), and Crypto CFDs.
- **Broker Support:** Official cTrader Open API integration supporting 100+ brokers including IC Markets, Pepperstone, FxPro, Fondex, and TopFX.
- **Order Types & Risk:** Market orders, Limit orders, Stop orders, multi-level Take Profits (TP1, TP2, TP3, TP4), Stop Loss in pips or exact price, and auto break-even triggers.
- **Account Multi-Routing:** Link multiple demo and live cTrader accounts and switch or route dynamically.

### 2. Binance & Bybit Signal Bots
- **Direct API Trading:** Native support for Binance USDT-M Futures and Bybit V5 Unified accounts.
- **Leverage:** Supports leverage up to 125x with Cross and Isolated margin modes.
- **Bot Engine:** WunderTrading and custom signal payload compatibility, Dollar-Cost Averaging (DCA), Trailing Stop Loss, and laddered Take Profit execution.

### 3. Ralph AI Trader (Autonomous Position Manager)
- **Position Monitoring:** Continual multi-timeframe review of open trades using advanced AI models (Gemini, DeepSeek, Groq).
- **Dynamic Risk Adjustment:** Automatically tightens Stop Losses as trades enter profit, detects adverse market regimes, and secures gains.
- **Telegram Notification & Approval:** Instant interactive Telegram messages with one-click "Approve" / "Reject" buttons for automated actions.

### 4. SwietProp Desktop & NinjaTrader 8 Bridge
- **Prop Firm Automation:** Automated execution compliant with prop firm rules (drawdown limits, news event locks, minimum hold duration).
- **Supported Micro Futures:** MES (Micro S&P), MNQ (Micro Nasdaq), MGC (Micro Gold), MHG (Micro Copper), M2K (Micro Russell), MYM (Micro Dow), SIL (Micro Silver).
- **Multi-Account Copying:** One master signal copied simultaneously across multiple challenge and funded accounts with sub-millisecond local latency.

## Webhook Specifications & Formats

### cTrader / Forex Payload Format
Send an `HTTP POST` request to `https://swietcherbot.space/webhook` with `Content-Type: application/json`:
```json
{
  "license": "YOUR_SECRET_LICENSE_KEY",
  "symbol": "XAUUSD",
  "action": "BUY",
  "volume": 0.1,
  "sl": 2650.00,
  "tp": 2700.00,
  "comment": "TradingView Breakout"
}
```

### Crypto / Binance & Bybit Signal Bot Format
```json
{
  "secret": "YOUR_SIGNAL_BOT_SECRET",
  "bot_id": "BOT_UUID",
  "symbol": "BTCUSDT",
  "action": "BUY",
  "order_type": "MARKET",
  "amount_usdt": 500,
  "leverage": 10,
  "tp1": 68000,
  "tp2": 70000,
  "sl": 64000
}
```

## Documentation Index

Explore detailed documentation and setup guides:

- [Getting Started](https://swietcherbot.space/docs/getting-started): Quick onboarding, account creation, and first webhook test.
- [Connect cTrader](https://swietcherbot.space/docs/ctrader): Step-by-step OAuth 2.0 authorization with cTrader brokers.
- [Connect Binance & Bybit](https://swietcherbot.space/docs/binance-bybit): API key creation, IP allowlisting, and permission security.
- [Signal Bots & Webhooks](https://swietcherbot.space/docs/signal-bots): Building automated DCA and grid bots for crypto.
- [Webhook Reference & PineScript](https://swietcherbot.space/docs/webhook-reference): Complete JSON syntax, PineScript alert examples, and error codes.
- [Ralph AI Trader](https://swietcherbot.space/docs/ralph-ai): Setting up AI position supervision and Telegram link token.
- [Auto Trade Engine](https://swietcherbot.space/docs/auto-trade): Automated scanning, algorithmic entry rules, and safety gates.
- [Crypto Terminal](https://swietcherbot.space/docs/crypto-terminal): Real-time crypto screeners, multi-timeframe scoring, and indicators.
- [Forex Terminal](https://swietcherbot.space/docs/forex-terminal): Currency pair and precious metals screeners.
- [SwietProp Desktop](https://swietcherbot.space/docs/swietprop-install): Installing and licensing the desktop app for NinjaTrader 8.
- [Desktop Integrations](https://swietcherbot.space/docs/desktop-integrations): Connecting NinjaTrader prop accounts and local copy trading.
- [Connect Telegram](https://swietcherbot.space/docs/telegram): Linking your Telegram account for trade alerts and approvals.
- [Security & Risk](https://swietcherbot.space/docs/security-risk): 2FA setup, encryption architecture, and risk disclaimers.
- [Accounts & Plans](https://swietcherbot.space/docs/account-plans): Starter, Pro, and Elite tier feature comparison.
- [Troubleshooting](https://swietcherbot.space/docs/troubleshooting): Diagnosing webhook errors, broker connection timeouts, and execution logs.

## Additional Resources

- **Full Documentation Dump:** [https://swietcherbot.space/llms-full.txt](https://swietcherbot.space/llms-full.txt)
- **Website & Terminal:** [https://swietcherbot.space](https://swietcherbot.space) | [https://terminal.swietcherbot.space](https://terminal.swietcherbot.space)
- **XML Sitemap:** [https://swietcherbot.space/sitemap.xml](https://swietcherbot.space/sitemap.xml)
- **Official Telegram Community:** [https://t.me/swietcherbot](https://t.me/swietcherbot)
- **Support Contact:** support@swietcherbot.space