> ## Documentation Index
> Fetch the complete documentation index at: https://takeprofit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Market Depth Widget
The **Order Book widget** (also called **Market Depth**) provides a real-time view of market liquidity and trade activity for a selected crypto instrument.
It helps you analyze:
* resting buy and sell liquidity
* bid and ask pressure near the spread
* liquidity walls and thin zones
* executed trades and short-term order flow in **Flow** mode
To choose an instrument, click the **ticker icon** in the top-left corner of the widget.
Market Depth is available for crypto instruments from **70+ supported exchanges**.
***
## Widget Structure
The Market Depth widget combines two types of market data:
* **Depth data** — resting bid and ask liquidity in the order book
* **Flow data** — recent executed trades and trade clusters
The available elements depend on the selected mode: **Depth** or **Flow**.
### Main Elements
* **Price ladder**
* The vertical scale with price levels
* Updates in real time as the market moves
* **Bids**
* Buy orders, shown in green
* Represent demand below or near the current price
* **Asks**
* Sell orders, shown in red
* Represent supply above or near the current price
* **Liquidity bars**
* Horizontal bars at each price level
* Show how much volume is resting on bids and asks
* **Volume labels**
* Numeric size values displayed directly on the ladder
* **Spread**
* The distance between the best bid and best ask
* Represents the nearest executable buy/sell gap
* **Cumulative depth curve**
* A stepped line showing how liquidity builds up further away from the spread
* Useful for spotting larger liquidity walls
* **Trade clusters** *(Flow mode)*
* Grouped executed trades displayed inside the widget
* Help show where buying or selling activity is actually taking place
***
## Choosing an Instrument
To change the instrument:
1. Click the **ticker icon** in the top-left corner of the widget
2. Select the crypto market you want to open
3. Choose an available exchange or trading venue
Market Depth currently supports order book data from **70+ crypto exchanges**, allowing you to compare liquidity and order flow across different venues.
***
## Display Modes
The widget supports two viewing modes:
* **Depth**
* **Flow**
### Depth Mode
**Depth** mode focuses on the **current state of the order book**.
It provides a clean and structured view of:
* Bid and ask ladders
* Price levels
* Liquidity bars
* Volume at each level
* Cumulative depth (optional)
This mode is designed for analyzing:
* where liquidity is currently placed
* support and resistance formed by order walls
* overall market structure based on resting orders
Use **Depth mode** when you want a clear snapshot of **supply and demand in the book**, without execution noise.
***
### Flow Mode
**Flow** mode adds **real-time trade execution data** on top of the order book.
In addition to standard depth, it displays:
* Recent trades (executed orders)
* Aggregated trade prints
* Trade clusters (visualized as candles inside the widget)
* Filters for trade size and activity
#### What the candles in the center represent
The candles shown in the middle of the widget represent **trade flow clusters** — grouped executions over a short time interval.
They are **not standard chart candles**.
Instead, they show:
* where trades were executed relative to the spread
* intensity of buying vs selling activity
* short-term reaction of price to order flow
* **Green candles** → aggressive buyers (market buys)
* **Red candles** → aggressive sellers (market sells)
This allows you to analyze:
* whether liquidity is being absorbed or respected
* where actual trading activity is concentrated
* how execution flow interacts with visible order book levels
***
### Depth vs Flow — When to Use
* Use **Depth mode** when:
* you analyze liquidity structure
* you look for support/resistance from order walls
* you need a clean and stable view
* Use **Flow mode** when:
* you want to track real-time executions
* you analyze buyer/seller aggression
* you combine liquidity with trade activity
***
## Depth and Flow Settings
Open **Market Depth Settings** to switch between modes and adjust the widget behavior.
The available settings depend on the selected mode.
### General
* **Depth / Flow**
* Switch between the two display modes:
* **Depth** — shows resting bid and ask liquidity
* **Flow** — adds executed trade activity and trade clusters
* **Bid/Ask Ratio** *(Depth mode)*
* Shows the balance between bid and ask liquidity
* **Show Empty Rows** *(Depth mode)*
* Displays price levels even when no orders are currently available at those levels
* **Price Step**
* Groups price levels by step multiplier
* Example: `x10` aggregates price levels into larger steps for a cleaner view
* **Font Size**
* Changes the size of ladder labels and volume values
* **Auto-centered**
* Keeps the spread area centered automatically
### Volume
* **Volume Bars**
* Show or hide horizontal liquidity bars
* **Volume Scale**
* Controls how volume bars are scaled
* Example: **Linear**
* **Cumulative Volume**
* Enables the stepped cumulative depth curve
### Trades *(Flow mode)*
* **Display Type**
* Changes how executed trades are displayed inside the Flow view
* **Aggregation**
* Groups executed trades into larger prints
* Helps reduce noise in fast-moving markets
* **Volume Filter**
* Hides executed trades below the selected volume threshold
### Clusters *(Flow mode)*
* **Period**
* Defines the time interval used for trade cluster visualization
* Example: `5m`
* **Skip Empty Clusters**
* Hides cluster intervals without meaningful trade activity
### Reset to Default
Use **Reset to Default** to restore the widget settings to their default configuration.
***
## Top-Right Controls
In the top-right corner of the widget, you can find quick controls for depth navigation and price aggregation.
### Bring Spread Back to the Center
Click the **centering icon** to bring the spread back to the center.
Use it when:
* you manually scrolled away from the current price
* the active spread is no longer visible in the middle of the widget
* you want to quickly refocus on the live market
### Price Step Control
Next to the centering button, you can adjust the **price step** directly from the widget header.
This control includes:
* **minus (-)** — decrease the step
* **current value** (for example `0.01`) — shows the active price increment
* **plus (+)** — increase the step
This lets you control how detailed the ladder is:
* **smaller step** → more detailed price levels
* **larger step** → more aggregated view with less noise
Use a smaller step for precise short-term reading.\
Use a larger step when you want a cleaner overview of liquidity distribution.
***
## How to Read Market Depth
Use the Order Book to interpret short-term market structure:
* **Large bid walls** can act as support
* **Large ask walls** can act as resistance
* **Thin liquidity** can lead to faster moves
* **Imbalance between bids and asks** can indicate directional pressure
Keep in mind that the book is dynamic. Orders can appear, shift, or disappear quickly.
***
## Practical Use Cases
### Identify Liquidity Zones
Look for large concentrations of resting orders.
These often define short-term reaction levels.
### Watch the Spread
A tight spread usually reflects better liquidity.
A wider spread may indicate thinner conditions or higher uncertainty.
### Combine Liquidity and Executions
In **Flow mode**, compare:
* where liquidity is resting
* where trades are actually executing
This can help confirm whether visible liquidity is being respected, absorbed, or aggressively traded through.
### Fine-Tune Entry Timing
Use the order book to improve execution around key price levels, especially in fast intraday conditions.