Themed Bot with Chart

Advanced Crypto Trading Bot with Live TradingView Charts — Complete User Manual
PyQt6 Kraken Binance US Gemini Live Charts 9 Strategies
Digitally signed · DennTech Trading Solutions · Windows Authenticode

Table of Contents

  1. Overview & Key Features
  2. System Requirements & Installation
  3. First Launch Setup
  4. API Key Management
  5. Interface Overview
  6. Live TradingView Chart
  7. Exchange & Trading Pair Setup
  8. Trading Strategies
  9. Trade Configuration
  10. Watchlist
  11. Stop Loss & Risk Management
  12. Dry Run Mode
  13. Theme Customization
  14. Positions & Trade History
  15. Troubleshooting

1. Overview & Key Features

Themed Bot with Chart is the most feature-rich and visually advanced version of DennTech's cryptocurrency trading bot lineup. Built on a PyQt6 foundation with a polished glossy UI, it combines the core algorithmic trading engine with a real-time TradingView-powered candlestick chart — an integrated professional charting experience that runs inside the application itself. Every buy and sell signal the bot generates is plotted directly on the chart as visual markers, giving you complete, at-a-glance insight into what the bot is doing and why.

This edition includes all nine trading strategies, supports Kraken, Binance US, and Gemini exchanges, and offers a fully customizable visual theme system with live color editing and preset management.

What Makes It Different from Retro Bot

2. System Requirements & Installation

ComponentMinimumNotes
OSWindows 10 64-bitWindows 11 recommended
RAM4 GB8 GB for extended sessions
PythonPython 3.10+Source version
InternetRequiredFor exchange API and chart data

Running from Source

  1. Navigate to the Themed_bot_with_chart folder.
  2. Install dependencies: pip install -r requirements.txt
  3. Launch: python main.py

3. First Launch Setup

On first launch, the bot presents a brief setup walkthrough. You will set your preferred theme, enter API keys for your exchange, and configure the trading pair. This takes under 5 minutes and only happens once — all settings are stored for future sessions.

4. API Key Management

Click Manage API Keys in the main dashboard or from the File menu. The API Key panel shows three sub-tabs — one per exchange.

Required Permissions

Create your API keys with the following permissions:

Never enable withdrawal permissions on bot API keys. This is the most critical security measure for any exchange-connected application. Withdrawal access turns a compromised key into a total fund loss scenario.

Saving and Testing Keys

Enter your API key and secret in the corresponding fields. Click Save. Click Test Connection to verify the keys are valid, the exchange is reachable, and your account balance can be retrieved. The test result shows your available balance by currency — confirming the connection is successful and the bot can read your account data.

Enabling an Exchange

After saving and testing keys, click Enable Exchange to make it the active trading exchange. Only one exchange can be active at a time for live trading. The enabled exchange is shown in the main dashboard status bar with a green indicator.

5. Interface Overview

The Themed Bot with Chart dashboard is divided into four primary areas:

6. Live TradingView Chart

The integrated chart is powered by TradingView's Lightweight Charts library (the same charting engine used on TradingView.com), rendered inside the PyQt6 window via a Qt WebEngine view. It is a production-grade, hardware-accelerated candlestick chart — not a placeholder or screenshot.

Chart Behavior

When the bot is running on an active trading pair and exchange, the chart:

Chart Interaction

Standard TradingView chart interactions are supported:

Chart Colors & Theme

The chart color scheme automatically updates to match the currently selected UI theme. When you switch to a Light theme, the chart background and grid colors update accordingly. When in Dark theme (default), the chart uses a near-black background with high-contrast candles and markers for the best visibility.

Chart Indicators

Optional indicator overlays can be toggled from the Chart menu. Available overlays depend on the active strategy:

7. Exchange & Trading Pair Setup

Select your exchange from the Exchange dropdown in the left control panel. The exchange must have been previously configured with valid API keys and enabled via the API Key Manager. Once an exchange is selected, the Trading Pair dropdown loads all available markets for that exchange.

Selecting a Trading Pair

Choose the trading pair from the dropdown. Common pairs include BTC/USD, ETH/USD, SOL/USD, MATIC/USD, and many others depending on the exchange. The chart immediately loads historical candles for the selected pair. The available balance and minimum order size for the pair are shown below the pair selector.

Timeframe

Select the candle timeframe for strategy calculations: 1m, 5m, 15m, 30m, 1h, 4h, or 1d. The chart updates to show candles at the selected timeframe. Strategy signals are only generated on closed candles of the selected timeframe.

8. Trading Strategies

Themed Bot with Chart supports nine strategies, each targeting different market conditions. Select the strategy from the Strategy dropdown. When a strategy is selected, its configurable parameters appear below the dropdown. Hover over any parameter for a tooltip explaining its function.

RSI (Relative Strength Index)

Measures price momentum on a 0–100 scale. Buy below the oversold threshold (default: 30). Sell above the overbought threshold (default: 70). Parameters: RSI Period (default: 14), Oversold Level, Overbought Level. Effective in range-bound markets. The RSI indicator overlay on the chart clearly shows when thresholds are crossed.

MACD

Uses the convergence and divergence of fast and slow exponential moving averages to identify trend changes. Buy on MACD / signal line bullish crossover. Sell on bearish crossover. Parameters: Fast EMA Period (12), Slow EMA Period (26), Signal Period (9). MACD histogram and signal lines are visible in the chart sub-pane when this strategy is active.

Trend Following

Identifies the prevailing trend direction and enters positions in the trend direction only. Uses moving average slope and price position relative to the average. Configurable: Trend MA Period, MA Type (SMA/EMA). Best suited to markets with clear directional momentum.

Mean Reversion

Identifies statistically extreme price deviations from the mean and trades the expected reversion. Uses Bollinger Bands logic — buy at lower band touch, sell at upper band touch or mean return. Parameters: Lookback Period, Standard Deviation Multiplier.

Scalping

High-frequency, small-profit strategy using volume analysis and tight technical triggers on 1m or 5m charts. Best for BTC/USD and ETH/USD on Kraken or Binance US where spreads are tightest and order execution is fast.

Grid Trading

Places a grid of limit buy and sell orders at fixed intervals around the current price. Profits from oscillation as price bounces between grid levels. Parameters: Grid Spacing (%), Number of Levels, Capital Allocation. Visual grid lines can be shown on the chart overlay.

Momentum

Enters long when the rate-of-change indicator exceeds the momentum threshold, indicating strong upward price force. Exits when momentum fades. Parameters: Momentum Period, Entry Threshold, Exit Threshold.

Market Making

Simulates a market maker by placing simultaneous bid and ask orders near the current spread. Profits from both sides filling. Requires high-liquidity pairs and stable spreads. Parameters: Spread %, Order Size.

Arbitrage

Exploits intra-exchange order book inefficiencies or correlated pair price discrepancies. A simplified implementation designed for educational demonstration of arbitrage concepts on single-exchange accounts.

9. Trade Configuration

Trade Amount Mode

Amount

Enter the trade amount value corresponding to the selected mode. Conservative starting values: $25–$50 in Cash Mode; 3–5% in Percentage Mode. These allow meaningful performance observation without excessive capital exposure during initial testing.

10. Watchlist

The Watchlist panel (accessible via the Watchlist tab in the right panel) displays real-time prices for multiple pairs simultaneously. This lets you monitor market conditions across pairs even when trading only one active pair.

Adding Pairs

Click the + button in the watchlist panel. Select the exchange and type the pair symbol (e.g., BTC/USD, ADA/USD). The pair appears in the list with a live price feed. Color coding shows upward (green) or downward (red) price movement from the last refresh. Right-click any watchlist item to set a price alert or open the pair on the chart.

Opening a Watchlist Pair on the Chart

Right-click a pair in the watchlist and select View on Chart. The main chart switches to display that pair's price history. Note: the bot continues trading the originally configured pair — viewing another pair on the chart is for monitoring purposes only and does not change the active trading configuration.

11. Stop Loss & Risk Management

Stop loss is a critical safety mechanism that automatically closes open positions when a loss threshold is reached, preventing unlimited downside from single bad trades.

Enabling Stop Loss

Check Enable Stop Loss in the Trade Configuration panel. Enter the stop loss percentage. The bot places an internal stop loss order tracker — when position value drops by the specified percentage from entry, it triggers a market close order on the exchange.

Stop loss triggers are shown on the chart as orange markers at the exit candle, distinct from normal signal-based sell markers. This lets you review exactly which positions were stopped out versus closed on a strategy signal.

Crypto markets can gap sharply on breaking news (exchange outages, regulatory announcements, major hacks). Stop losses protect against normal drawdowns but do not guarantee specific exit prices during flash crashes. Always use position sizing that keeps total risk to an acceptable level even in extreme scenarios.

12. Dry Run Mode

Dry Run Mode enables complete simulation using live market data with no real trades. Enable it before starting the bot using the Dry Run toggle in the main panel. A prominent blue banner in the dashboard confirms dry run is active.

In Dry Run mode, all signals, chart markers, virtual position entries and exits, and P&L calculations function identically to live mode — but no orders are submitted to the exchange. This is the recommended way to evaluate any new strategy or parameter change before committing real capital.

Keep the bot in Dry Run for at least 1–2 weeks on your chosen pair and timeframe. Review: how many trades were generated, the win/loss ratio, the maximum drawdown (the deepest loss valley in equity), and whether profits meaningfully exceed simulated exchange fees.

13. Theme Customization

Themed Bot with Chart offers a comprehensive visual customization system that extends beyond the application UI to the integrated chart.

Applying a Preset Theme

Click the Theme button in the top toolbar. The Theme dialog shows a preset grid. Click any preset to apply it instantly. Built-in presets: Midnight Black (default), Deep Ocean, Purple Haze, Forest Dark, Arctic White (light), and High Contrast. The chart colors, UI widget colors, and accent colors all update cohesively.

Custom Theme Builder

Click Custom in the theme dialog to open the full color editor. Individually adjustable elements:

Click Save as Preset to save your custom theme under a name. Saved presets appear in the preset grid alongside built-in themes.

Theme Files

The active theme is stored in bot_theme.css in the application folder. This is a standard CSS file that applies PyQt6 stylesheet rules. Advanced users can edit this file directly in any text editor. Preset themes are stored in theme_presets.json. Do not delete bot_theme.css — the bot will regenerate a default theme on next launch if it is missing.

14. Positions & Trade History

Active Positions

The Positions panel in the right area of the dashboard shows all currently open positions. For each position: entry price, current price, unrealized P&L in both dollar and percentage, stop loss level, and time in trade. All values update in real time as the price feed updates.

Trade History

Click the History tab in the bottom panel. Every completed trade is listed with: pair, entry time, exit time, entry price, exit price, realized P&L, strategy used, and exit reason (Signal, Stop Loss, or Manual). The history table is sortable by any column. Click any row to jump to that trade's candle on the chart — the chart pans to the entry candle and highlights the trade's duration.

Exporting History

Click Export CSV in the History panel to save the full trade history to a CSV file. Open it in Excel or Google Sheets to calculate detailed performance metrics, draw equity curves, or analyze strategy effectiveness by date range.

15. Troubleshooting

Chart shows no data / chart is blank

Ensure the selected exchange is configured with valid API keys and is connected. The chart requires successful exchange connection to fetch historical candle data. Click Test Connection in API Key Manager to verify. Also ensure an active internet connection — the chart library itself is bundled locally but candle data comes from the exchange API.

Buy/sell markers not appearing on chart

Markers only appear when the bot is actively running (not when the bot is stopped). Ensure the bot is started with the Start Bot button and that a strategy has generated at least one signal. In Dry Run mode, markers appear exactly as in live mode — signals in Dry Run are visible on the chart.

Theme colors are not saving

Ensure bot_theme.css is not set to Read-Only in Windows file properties. If you edited it manually and the bot cannot parse it, delete the file and restart — a default theme will regenerate automatically. Then re-apply your custom theme from the Theme dialog.

Bot stops unexpectedly

Check the live event log in the bottom panel for error messages. Common causes: exchange API rate limiting (too many requests in a short time — lower the polling frequency in Settings), exchange connectivity timeout (internet interruption), or an API key that has been revoked or expired on the exchange side.

Percentage Mode trades are too large

In Percentage Mode, trade size is relative to your available balance. A 10% trade on a $1,000 balance is a $100 order. If your balance grows significantly over time, percentage-mode orders grow proportionally. Review your configured percentage regularly and reduce it if needed to maintain consistent risk levels as account equity changes.


Themed Bot with Chart User Manual — DennTech — v1.0 — May 2026