Dashboard Usage

Dashboard Usage

The Gridera dashboard is your control center for managing grid bots. It provides real-time visibility into bot status, profitability, and health indicators. Learning to read the dashboard effectively lets you spot issues early and make informed decisions about your trading.

Dashboard Overview

When you log in, the dashboard shows all your bots in a summary view. Each bot card displays its current status, trading pair, and key metrics. Click any bot to access its detailed view with full controls and analytics.

The main sections of the dashboard are:

• Bot list: All configured bots with status indicators.
• Bot detail: Full view of a selected bot’s activity and performance.
• Controls: Start, stop, and configure buttons.
• Logs: Recent bot log output for debugging.

Bot Status Indicators

Each bot shows one of several status states:

Running: The bot is active and executing its trading cycle. This is the normal operating state. The status indicator appears green.

Stopped: The bot is not running. No orders are being placed or managed. Previous positions and orders may still exist on the exchange but are not being monitored.

Starting: The bot is initializing. It is loading configuration, connecting to WebSockets, syncing leverage, and performing startup checks. This typically takes 5-15 seconds.

Error: The bot encountered a problem and stopped unexpectedly. Check the logs section for error details. Common causes include API connectivity issues, insufficient balance, or configuration errors.

Shutting down: The bot is performing a clean shutdown. It is cancelling orders, closing positions, and cleaning up. Do not interrupt this process.

Key Metrics

The bot detail view displays several important metrics:

Current price: The real-time mark price of the trading pair. This updates via WebSocket and shows the most recent price the bot is using for decisions.

Active grid levels: How many grid levels currently have open buy orders. This tells you how much of your grid is actively waiting for fills.

Filled levels: How many grid levels have been bought and are waiting for their TP orders to fill. A high number of filled levels means you are holding more positions.

Completed trades: The total number of buy-sell round trips completed. Each completed trade represents a captured grid profit.

Open orders: The total number of orders currently active on the exchange, including both buy entries and TP sells.

PnL Display

The dashboard shows profit and loss information in multiple views:

Session PnL: Profit or loss since the bot was last started. This resets each time you stop and restart the bot.

Lifetime PnL: Cumulative profit or loss across all sessions. This persists across restarts and gives you the long-term picture.

Realized PnL: Profit from completed round-trip trades. This is locked-in profit that will not change regardless of future price movement.

Unrealized PnL: The current profit or loss on open positions based on the mark price. This fluctuates with the market and becomes realized when positions are closed.

The PnL numbers update in real-time as trades complete and prices change. Positive values appear in green, negative in red.

Health Indicators

The dashboard includes health checks that warn you about potential issues:

Price feed status: Shows whether the bot is receiving price updates. A stale price feed means the bot may skip cycles.

API connectivity: Indicates whether REST API calls are succeeding. Persistent failures prevent the bot from placing or monitoring orders.

Reconciliation status: Shows whether the self-healing system has detected and corrected any discrepancies. Frequent corrections may indicate an underlying issue.

Last cycle time: When the bot last completed a trading cycle. If this is more than 30 seconds old, something may be blocking the cycle.

Using the Logs Section

The logs section shows the most recent bot output, typically the last 300 lines. This is invaluable for understanding what the bot is doing and troubleshooting issues.

Key log entries to look for:

• BUY FILL: A buy order filled at a grid level. Shows the price and amount.
• TP FILL: A take-profit order filled. Shows the price and realized profit.
• RECONCILIATION: The bot detected and corrected a discrepancy.
• GRID BREAK: The price exited the grid range. The bot may be shutting down.
• ERROR: Something went wrong. Read the message for details.

You can refresh the logs to get the latest output. The log section auto-scrolls to the newest entries.

Common Dashboard Actions

Starting a bot: Click the start button on a stopped bot. The bot loads its configuration and begins trading within seconds.

Stopping a bot: Click the stop button on a running bot. This triggers a clean shutdown: orders are cancelled, positions are closed, and the bot exits gracefully. Wait for the status to change to “Stopped” before taking further action.

Viewing configuration: Access the bot’s current configuration to review grid range, levels, order size, and other parameters.

Refreshing data: The dashboard auto-refreshes key metrics, but you can manually refresh if data appears stale.

Summary

• The dashboard provides real-time bot status, PnL tracking, and health indicators in a single view.
• Monitor filled levels and completed trades to understand bot activity; check health indicators for connectivity and reconciliation issues.
• Use the logs section to understand bot decisions and troubleshoot problems as they arise.

Next Step

Understand how profit tracking works in detail in PnL Tracking.