Sweeps Indicator

What Is the Sweeps Indicator add-on?

Sweeps is an on-chart indicator that shows and highlights areas with large volumes of trade over short time periods. Sweeps are the result of aggressor buyers’ or sellers’ activity at key levels.

In other words, it shows where large resting sell limit orders (sometimes iceberg orders) are breached by large buying aggressors and vice versa, where large buy limit orders are breached by large selling aggressors.

Configuration

Traders can configure the Sweeps Indicator settings separately for each instrument, helping you customize your Bookmap trading experience.

Almost every element of the Sweeps Indicator is configurable, with traders being able to configure the time frame, price levels, and the minimum size. If within the time period the instrument's traded volume for the number of price levels was greater than the minimum size, the Sweeps Indicator will add a mark to the chart.

Buys and sells are calculated separately, and traders can enter their own values into the “time”, “size” and ‘price levels’ fields to customize their Sweeps Indicator charts.

Automation Feature

Ticking the “Automatic mode” checkbox allows you to have the minimum size setting update automatically, although while automated it cannot be manually edited (You can disable automatic mode to manually edit it again).

This minimum size is updated based on a calculation of the standard deviation (SD) of traded volume for the last x minutes, where x is the value of the “SD interval” field which traders can configure.

The “SD multiplier” slider allows you to adjust the number of detections. The larger its value is - the fewer detections will be on the chart. This allows traders to configure exactly how large their minimum size setting should be when automated, in comparison to market movements.

Customizable Alerts

If the “Sound alert” checkbox is ticked, you will get a sound notification every time a new group of indicator marks is added to the active chart, allowing you to keep a finger on the market whilst doing other things.

The “Telegram” checkbox enables text notifications in your Telegram application. The trigger rule and the text for these notifications is the same as for sound alerts, but you need to configure your Telegram notifications before enabling, see corresponding section of the manual below.

You can adjust the notification text according to your preferences by editing the corresponding text field. The “?” button will show you the list of possible templates you use for the sound type, the “Reset” button will reset the notification text to default, and the “Test alert” button will play test sound notifications based on your current notification settings, helping you identify if they will be useful or not before relying on them during trading.

You can also customize sound alerts via the “File” -> “Alerts” -> “Sound alerts” window. This fully duplicates all functionality of the sound alerts panel of the add-on configuration, and allows you to manage alerts from different add-ons all in one place.

Clicking the “Configure alerts” button will open the sound alerts configuration panel for the corresponding alert.

If you remove an alert from the list, you can add it back by enabling sound alerts in the Sweeps indicator configuration. The “Add alert” button in the general “Sound Alerts” window does not work for the Sweeps indicator currently.

Telegram Notifications Guide

To start getting Telegram notifications from your add-on, you need to implement the following steps:

1. Getting Started

   Install the Telegram Desktop application https://desktop.telegram.org/ and create an account.

   You can also use either web or mobile versions of Telegram, but we recommend using the desktop version for a better user experience during the configuration process - this can then be linked to and used on the mobile version once configured.

2. Create a Telegram bot

   Open the following link in your Telegram application: https://t.me/BotFather, and then follow these instructions.

   • Send “/start” message to start working with the bots management bot.
   • Send “/newbot” message to create a new bot.
   • Choose a name for your bot by sending it as a new message.
   • Choose a username for your bot by sending it as a new message. Username should be unique and must end in “bot”.
   • When your bot is successfully created, you will get a message with an access token for this bot. Copy this access token to the Sweeps indicator -> Telegram Configuration -> Token

3. Obtain the Chat ID where you want to get notifications

   • Enter the Telegram account for which you want to get notifications.
   • Open the following link inside of Telegram: https://t.me/get_id_bot.
   • Send “/start” message to start working with the bot.
   • Receive your chat ID via the bot's response.
   • Copy this chat ID into Sweeps indicator -> Telegram Configuration -> Chat ID

4. Start a conversation with your bot

   Open the link https://t.me/your-bot?start=subscribe inside of Telegram. In this link “your-bot” is a placeholder for the username of your bot - make sure you change it accordingly! Next, Send “/start” message to start a conversation with your bot.

5. Run A Test

   Click the “Test” button on the Telegram configuration panel inside Bookmap to make sure that everything is configured properly. You should receive a test notification message in Telegram from your bot if everything is OK, or an error message describing the problem otherwise.

6. Enable Telegram notifications

   Finally, you must enable Telegram notifications by checking the “Telegram” checkbox on the add-on alerts configuration panel.

Visual settings

The visual settings of the Sweeps Indicator are the same across all instruments it is added to, meaning traders can quickly change their visual settings for Sweeps across all their instruments.

The visual settings panel is collapsed by default, and you need to click the drop-down arrow (“v” button) to expand it.

The Sweeps Indicator visual settings panel looks like this:

Checking the “Show icons” checkbox will show all sweeps icons on the heatmap, with some offset from where trade occured on the chart.

Checking the “Show volume” checkbox allows you to display absorbed volume numbers on the chart nearby to the sweep icons. If several icons of the same side (buys or sells) are close to each other, only one icon with an aggregated total volume for all of them will be shown on the chart.

The “Icons size” slider allows traders to select their preferred icon size in pixels.

Traders can configure the “Icons offset” slider to select how far away the icons will be displayed from their corresponding trade dots (in pixels).

The “Offset line width” slider allows traders to set the width of the dotted offset lines which connect the indicator icons to trade dots.

Aggressive buyers and sellers color settings indicate the color with which the aggressive buyers and sellers sweeps are marked on the chart.

Traders can change the color of icons and text using a color picker, or preset colors. These can also be reset to default at any time using the refresh button.

The “Icon color” shows the color of indicator icons, trade dots, and lines.

The “Text color” shows the color of the text on the icons.

The “Background” color allows you to choose the background color for all the icons.

The “Horizontal aggregation” slider sets the minimum horizontal distance in pixels between the icons before they start aggregating.

The “Vertical aggregation” slider sets the minimum vertical distance in pixels between the icons before they start aggregating.

Disabling of both Horizontal and Vertical aggregations is possible. Please note that it may result in too many icons on the chart, which may make them unreadable and cause performance issues. For this reason we do not recommend disabling this feature, especially with large amounts of data.

Toggling the “Show trade dots” checkbox allows you to show/hide all trade dots created by the indicator across all instruments.

The “Dots size” slider allows you to select the indicator's trade dots size in pixels.

The “Dots shape” drop-down menu allows you to choose the shape of the indicator’s trade dots, which can be either round or rectangular.

Interaction with icons

Right-click on any Sweeps indicator icon on the chart to open the pop-up menu with the indicator configuration.

Using the left mouse button, drag any Sweeps indicator icon on the chart up or down to change the vertical distance between all the indicator icons and the corresponding trade dots which the icons are representing (“Icons offset” parameter).

Notes

• The Sweeps indicator supports all instruments/platforms, including futures, stocks, and crypto.

• The backfill data that is provided by dxFeed (and some other connections) is aggregated. Therefore, the granularity for such instruments is insufficient to show Sweeps correctly, meaning detections on backfill data may differ from real-time data.

• The volume traded during a short time frame is different between instruments, and on the same instrument at different times. So if you set the threshold manually, you may need to adjust it.

• Need help? Join our Discord channel, or contact us at support@bookmap.com.

Sweeps Indicator FAQ

I do not see any dots, how can I check that the indicator works?

Sweeps are shown only when the traded volume is greater than the threshold you have set in your settings. If you see trades and still do not see any sweeps icons, go to your Sweeps Indicator configuration and set a smaller minimum size. To confirm everything is working, we recommend selecting a minimum possible value before increasing to a more suitable minimum size.

If this doesn’t work, disable all other add-ons and then go to the visual components and hide all chart elements. If this also does not fix the problem, please contact us at support@bookmap.com or via our Discord channel.

What is the difference between the Sweeps indicator and the current Volume Bubbles on the chart?

In total volume mode, the regular trade bubbles show both buyers and sellers aggressors combined. It is not necessarily one-sided (aggressor buyers or aggressor sellers), and it is also not necessarily on several price levels, nor across a short time frame.

Delta mode simply shows the difference between buyer and seller aggressors. The volume is not necessarily traded over a short time or on several price levels.

In comparison, trade volume bubbles on the Sweeps Indicator specifically highlight large volume over short time periods, are always across multiple price levels, and shows buyers and seller separately, meaning they could always be one-sided.

What is the difference between the Sweeps indicator and the Absorption indicator?

The Absorption Indicator applies the traded size threshold to each price level separately, while the Sweeps Indicator applies the traded size threshold to all price levels as one. As well as this, the Sweeps Indicator displays marks on the chart only if trades happened on at least X different price levels (configured by you).

Is the Sweeps Indicator part of Bookmap, or will it be an additional purchase?

The Sweeps Indicator is available as part of the Bookmap Global+ package.

Known issues

1. Sweeps indicator "Sound alert" settings disappear when switching between add-ons in the "Configure alerts" window. If it happens, just close the window and open it back to restore the functionality.

2. While you can remove Sweeps indicator alerts from the list in the “Sound alerts” window, you can not add them back using the “Add alert” button. The only way to add a deleted alert back is to enable it again in the add-on configuration window or to restart the add-on.

We are going to fix the above issues in future, until then you may use the described workarounds.

Installation

The latest version of the Sweeps Indicator requires the latest build of Bookmap 7.4 b11 or higher. Bookmap 7.4 has a new way of installing add-ons. For more information, please visit this page.

To install the Sweeps Indicator, simply get Bookmap 7.4 and install it from the Add-ons Manager.