> For the complete documentation index, see [llms.txt](https://trader-docs.b2trader.b2broker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trader-docs.b2trader.b2broker.com/widgets/order-book.md).

# Order book

## Summary

This widget displays a list of currently open buy and sell limit orders for a selected asset along with the current bid-ask spread.

<figure><img src="/files/HwJ559YV9KyugQmmUQMT" alt="Order book"><figcaption><p>Order book</p></figcaption></figure>

The widget is dynamic and is continuously updated in real time. It provides three different sections displaying the following information:

* Open sell orders are highlighted in red and listed in the top section. The best ask, which is the sell order with the lowest price, is displayed at the bottom of this list.
* Open buy orders are highlighted in green and listed in the bottom section. The best bid, which is the buy order with the highest price, is displayed at the top of this list.
* The middle section displays the current bid-ask spread indicating the gap between the best ask and bid prices declared for an asset.

## Settings

### Select a market

The current market is displayed in the widget header.

To change the market, click the market symbol and select a different one from the list.

### Display only asks/bids

In the upper part of the widget, you can choose how to display the Order book:

* Full view.
* Buy orders only + spread.
* Sell orders only + spread.

## Fields

Each row of the Order book provides the following information about a selected market:

**Price, {QUOTE}**

The price, in the quote asset.

***

**Amount, {BASE}**

The total amount of the base asset available at a corresponding price level.

***

**Total**

The total amount, in the quote asset, required to fully execute the orders at a corresponding price level.

{% hint style="info" %}
In addition, you can use the [Market depth](/widgets/market-depth.md) widget to evaluate the liquidity of a specific asset based on the overall volume of orders traded at various price levels.
{% endhint %}

For Spot markets, hover over Order book rows to view additional information and buy or sell assets in click:

**Average price**

The average price, in the quote asset.

***

**Total volume**

The total amount of the base asset available at a corresponding price level.

***

**Grand total**

The total amount, in the quote asset, required to fully execute the orders at a corresponding price level.

***

**Buy** / **Sell**

Click the button to instantly place a Market order to buy or sell the asset at the selected price level.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://trader-docs.b2trader.b2broker.com/widgets/order-book.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
