> For the complete documentation index, see [llms.txt](https://docs.trymatrix.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trymatrix.xyz/perp-bots/monitor-a-bot.md).

# Monitor a Bot

### Open Bot Details

You can open a bot from two locations:

* Perp Bot&#x73;**:** open ![](/files/erLkidB7k38rMTjM518W) Perps from the bottom navigation, tap ![](/files/S5Av20H5HbCjoYQFcmUc) Bots in the top-right corner and select a bot from My bots or All bots.
* Asset&#x73;**:** open ![](/files/Om14yzCeNIALlKfPxsCs) Assets, select Perps, open Perp bots and tap a bot.

<figure><img src="/files/zoag4eVrqcW9ct65C57X" alt="" width="188"><figcaption></figcaption></figure>

### Check Status and Grid Range

The top of the page shows the bot’s Total PnL, ROI, Grid PnL, Unrealized PnL, status and health.

The range section shows the Lower and Upper grid bounds, the current Mid price and whether the price is inside or outside the configured range.

Tap the ![](/files/ZpmvBnauaDefd6lLNdEU) chart icon to view the market chart with the bot’s current position, open orders and recent fills.

<figure><img src="/files/TBhzqErbekdgL6o5V59G" alt="" width="188"><figcaption></figcaption></figure>

### Use the Overview Tab

Select Overview to review the bot’s volume, fills, fees and average entry price.

The Performance section includes its investment, notional value, leverage, PnL, ROI, APR, fees and trading volume. The Deployment section shows the bot instance, account, version and deployment activity.

<figure><img src="/files/XaJEqqwtkAJhSmydXBp0" alt="" width="375"><figcaption></figcaption></figure>

### Review Position, Orders and Config

Use the following tabs to review the bot’s current activity and configuration:

* Positio&#x6E;**:** balance, free margin, net position, average entry price, position value, margin, leverage and unrealized PnL.
* Open Order&#x73;**:** current Buy and Sell orders, their prices and quantities, the mid price and maximum orders per side.
* Confi&#x67;**:** price range, grid levels, spacing, order size, maximum notional value, maximum orders per side and order frequency.

<figure><img src="/files/kq1r8fa0cjllTxlsdlg7" alt="" width="563"><figcaption></figcaption></figure>

### Review Fills

Select Fills to review orders executed by the bot.

Each fill shows its side, price, quantity, grid PnL, fee and execution time. If the bot has more fills than can be shown on one page, use Prev and Next to move between pages.

<figure><img src="/files/NF5AqG8ikW83AxN7GfXH" alt="" width="188"><figcaption></figcaption></figure>

### Analyze Performance

Select Analysis to review the bot’s performance over time.

The summary at the top shows Total APR, Grid APR and the ratio of Buy and Sell fills.

Choose an interval of 15m, 1H or 1D, then select a range of 1D, 7D, 30D or 90D. Switch between Chart and Table views depending on how you want to review the data.

In Chart view, you can:

* Switch between Gross and Net PnL
* Enable +UPnL to include unrealized PnL
* Show cumulative PnL or volume
* Review PnL, volume and net position charts

Press the chart to view values for the selected period.

In Table view, review PnL, volume, fees and fills for each period. Tap a column heading to sort the results.

<figure><img src="/files/xwJUwsbbA9gMOE4pj3oX" alt="" width="563"><figcaption></figcaption></figure>

### Check Error Logs

Select Logs to review error logs reported for the bot.

Use the search field to find a specific message. Tap a log to expand it, use the copy icon to copy an individual message or tap Copy all to copy all logs matching the current search.

<figure><img src="/files/kGXRE9ndxvD2sXj7o5yN" alt="" width="188"><figcaption></figcaption></figure>

### Share or Open the Web Dashboard

Tap the ![](/files/MeNrw8KCbbChVKRlSfpD) share icon at the top of the page to share a link to the bot. Tap the ![](/files/o9XBztcfJCxrDkUJc1cI) external-link icon to open the bot in the web dashboard.

For instructions on pausing, resuming, stopping or copying a bot, see [Manage Your Bot](/perp-bots/manage-your-bot.md).
