Skip to content
All library documents

Using Bot Status, Order Book, and Ticker Commands to Monitor Trading

Article Hummingbot docs

Summary

This operations guide explains how to inspect a running trading bot and its market. A status view can show the exchange and trading pair, balances and inventory, active orders, errors, connection state, and whether paper trading is enabled. A live status option refreshes this information continuously, though the document says it is unavailable for liquidity-mining strategies.

It also describes commands for viewing the order book and ticker. The order-book view reports bid and ask prices with their volumes, with options for continuous display, line count, and selecting another exchange or market. The ticker shows the best bid, best ask, midpoint, and last trade price. An example status output illustrates balances, asset percentages, and outstanding buy and sell orders. These commands support monitoring and inspection; the guide does not explain a trading strategy or claim that the displayed data predicts prices.

Key ideas

  • The status view summarizes markets, balances, outstanding orders, errors, and exchange connectivity.
  • A live status option continuously updates bot information, with a stated strategy limitation.
  • The order-book command displays bid and ask prices and volumes, with optional live viewing and market selection.
  • The ticker reports best bid, best ask, midpoint, and last trade price.
  • These commands help monitor a bot but do not provide predictive signals or a trading method.

Tags

Full text
# Check Bot and Market Status


# Check Bot and Market Status

## Check bot status

Run `status` command or CTRL+S to show the bot's current status. The output may differ depending on the running strategy, but generally, it shows the following information:

- Market(s) you're trading in
- Balance or inventory of trading pair assets
- Active or outstanding orders
- Error messages
- Exchange connection status
- Paper trading mode (when enabled)

## Get live bot status

The `status --live` command displays the real-time status of the bot.

![](../assets/img/status-live.gif)

!!! note
    Currently, this feature works on all strategies except `liquidity mining` strategy.

## View market order book

By default, the `order_book` command displays the top 5 bid/ask prices and volume of the current market, similar to how they're displayed in the exchange's order book.

**Optional arguments**

| Command Argument | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `--live`         | Continuously displays the order book in real-time            |
| `--lines`        | Number of lines to display                                   |
| `--exchange`     | Specifies the exchange when running a secondary exchange     |
| `--market`       | Specifies the trading pair when running a secondary exchange |

**Sample usage**

Run `order_book --live --lines 20` to show the top 20 bid/ask and volume in real-time.

![](../assets/img/orderbook-live-lines.gif)

## View market ticker prices

The `ticker` command displays the market prices, specifically the best bid, best ask, mid price, and last trade price.

![](../assets/img/ticker-command.png)

**Optional arguments**

| Command Argument | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `--live`         | Displays the ticker in real-time                             |
| `--exchange`     | Specifies the exchange when running a secondary exchange     |
| `--market`       | Specifies the trading pair when running a secondary exchange |

## status

Get the market status of the current bot.

```
>>>  status

  Markets:
    Exchange  Market  Best Bid Price  Best Ask Price  Mid Price
     binance  ETHBTC        0.025521        0.025527   0.025524

  Assets:
                            ETH    BTC
     Total Balance       4.3725 0.1274
     Available Balance   3.3725 0.1021
     Current Value (BTC) 0.1116 0.1274
     Current %            46.7%  53.3%

  Orders:
     Level  Type      Price Spread  Amount (Orig)  Amount (Adj)       Age Hang
         1  sell  0.0257747  0.98%              1             1  00:00:02   no
         1   buy 0.02526431  1.02%              1             1  00:00:02   no



**Optional arguments**

| Command Argument            | Description                                                  |
| --------------------------- | ------------------------------------------------------------ |
| `-live`                     | Displays status in real time.                                |
```

Shown in full with attribution under the source's licence. Licence: Apache-2.0

This summary was written by Stratmill's research agent from the original; it is not a copy of the source.