🖥️ Interface

Using the Dashboard

The PolyBot dashboard is your full command centre — monitor performance, manage positions, tweak settings, and stop the bot instantly without touching the command line.

Accessing the Dashboard

Open your browser and navigate to:

Local machine: http://localhost:8080
Remote VPS: http://YOUR_VPS_IP:8080

If the dashboard doesn't load on a VPS, ensure port 8080 is open in your firewall:

sudo ufw allow 8080 && sudo ufw reload

💡 Bookmark it. The dashboard URL is all you need to monitor and control your bot from any device on your network.

Dashboard Tabs Overview

📊 Overview

Total equity, realized P&L, open P&L, win rate, trade count, and a live equity curve chart. Updated every 10 seconds.

📂 Positions

All currently open positions: market name, YES/NO direction, shares held, entry price, current price, and unrealized P&L.

📜 Trades

Full history of every trade: timestamp, direction, bet size, fill price, exit price, P&L, and which strategy triggered it.

⚙️ Settings

Live configuration editor. Change mode, bet size, risk limits, and Telegram settings — all applied instantly without a restart.

🔔 Alerts

Configure Telegram notifications. Enter your bot token and chat ID, test the connection, and toggle individual alert types.

🔄 Updates

Shows current bot version and available updates. One-click update button — no SSH, no docker pull, no manual restart.

Overview Tab in Detail

The Overview is your primary health check. Key metrics displayed:

Total Equity: USDC balance + value of all open positions at current market price
Realized P&L: Locked-in profit/loss from closed positions since bot start
Open P&L: Unrealized gain/loss on currently open positions (marked to market)
Win Rate: Percentage of closed trades that were profitable
Daily P&L: Today's net result — resets at midnight UTC
Equity Curve: SVG chart showing total equity over time since last bot start

Positions Tab in Detail

Each row in the positions table shows:

Market: The question slug (e.g., btc-updown-15m-14:00)
Direction: YES or NO badge
Shares: Number of shares held
Entry: Average fill price per share in USDC
Current: Live mid-price from order book
Unreal. P&L: (Current − Entry) × Shares
Strategy: ml / snipe / arb / copy (what triggered the trade)

Settings Tab — Live Config

Every setting from config.yml is editable here. Key controls:

Switch MODE between paper / dry-run / live
Adjust BET_AMOUNT, MAX_POSITION_USDC, DAILY_LOSS_LIMIT
Enable or disable individual strategies (ml / snipe / arb)
Toggle any Copy Bot protection filter

Click Apply Settings — the bot applies changes on the next decision cycle (within 30 seconds).

Currency Selector

All P&L values can be displayed in 16 currencies. Click the currency dropdown in the top-right of any tab:

USD · EUR · GBP · AUD · JPY · CAD · CHF · SGD · INR · BRL · MXN · SEK · NOK · DKK · PLN · CZK

Exchange rates are fetched from open FX APIs and refresh every hour.

🛑 Emergency Kill Switch

⚡ Kill Switch

The large red STOP button in the top-right of every tab immediately: cancels all open orders on the Polymarket order book, halts the bot's trading loop, and sends a Telegram alert if configured. No positions are force-closed — existing open positions remain on Polymarket until they resolve naturally or you close them manually. Use this button if you see unexpected behaviour or want to pause trading instantly.

Auto-Update from Dashboard

Go to Dashboard → Updates. When a new version is available:

The current and new version numbers are displayed
Click Update Now
The bot pulls the new Docker image, applies it, and restarts — typically under 90 seconds
All your settings and trade history are preserved

If you prefer to update via CLI:

cd ~/polybot docker compose pull docker compose up -d

← Configuration Strategies →