HVN Marker — Free Bookmap Addon

User Guide

HVN Marker — Complete Guide

⚠ WARNING — READ BEFORE INSTALLING

This is a FREE addon. No support of any kind is provided — no questions asked.

By downloading, installing, or using this addon, you acknowledge and agree to:

No Support: You are solely responsible for installing, configuring, troubleshooting, and getting this addon working.
No Guaranteed Updates: The developer may or may not release updates at their sole discretion.
Data Accuracy: If your data feed disconnects or Bookmap restarts, the volume profile will be incomplete and detected levels may be inaccurate. Verify all data independently before making trading decisions.
No Liability: The developer is not liable for any financial losses, missed trades, incorrect data, software conflicts, or damages of any kind.
No Warranty: Provided "as-is" without warranty of any kind.
Third-Party Disclaimer: Bookmap is not responsible for this addon. Bookmap support will not assist with it.
Assumption of Risk: You assume all risk associated with installation and use.

BACK UP ALL DATA AND SETTINGS BEFORE INSTALLING — USE AT YOUR OWN RISK

Overview

The High Volume Node Marker is a free Bookmap addon that automatically detects and marks High Volume Nodes (HVNs) on your chart in real time using Cloud Notes.

It scans the session volume profile, identifies every price level that qualifies as a local high within a configurable distance, and outputs each HVN as a labeled Cloud Note with an optional horizontal line. Nodes appear, move, and disappear dynamically as the volume profile develops throughout the session.

Requirements

Bookmap with Cloud Notes enabled (Digital+, Global, or Global+ plan)
Cloud Notes must be configured to poll a local HTTP URL
Windows, macOS, or Linux

Installation

Download the hvn-marker.jar file.
Open Bookmap and go to Settings → Configure add-ons.
Click Add and select the folder where you downloaded or placed the addon.
Enable the addon by checking the box next to its name.
The High Volume Node Marker settings panel will appear on the right side.

Settings Reference

Session

Setting	Description
Session Type	Globex (18:00 ET), RTH (09:30 ET), or Custom. Determines when the volume profile starts collecting.
Start Hour / Minute	Only editable when Session Type is Custom. Sets the session start time in Eastern Time.
Auto-Reset	When enabled, the volume profile and all HVN markers automatically clear and restart at each session boundary.

Filters

Setting	Description
Min Distance (pts)	A price level must have the highest volume within this many points on both sides to qualify as a HVN. Default: 5.
Min Volume	Ignore levels with volume below this threshold. Set to 0 to disable. Useful for filtering out low-activity levels.

Cloud Notes Server

Setting	Description
Address	The IP address the built-in HTTP server binds to. Default: `127.0.0.1`
Port	The port number. Default: `8002`. Change if another addon is using the same port.
URL	The full URL to paste into Bookmap's Cloud Notes settings. Shown as read-only for easy copying.

Appearance

Setting	Description
Label	The text shown on each Cloud Note marker. Default: "HVN"
Text Color	Foreground color of the label text. Click to open a color picker.
BG Color	Background color of the Cloud Note. Default: `#00aaff` (blue)
Draw Line	When checked, a horizontal price line is drawn at each detected node.

Setting Up Cloud Notes

In Bookmap, open Cloud Notes settings.
Add a new Cloud Notes source with the URL shown in the addon's settings panel (e.g. http://127.0.0.1:8002/hvn_levels.csv).
Cloud Notes polls approximately every 1 minute. Detected nodes will appear after the first poll.
The addon updates its internal data every second, but Cloud Notes only refreshes at its own polling interval.

Note: After changing settings or first loading the addon, it may take longer than 60 seconds for levels to appear. Cloud Notes may briefly display "Unavailable" — this is normal and typically resolves within a few minutes.

How HVN Detection Works

The addon builds a cumulative volume profile from every trade during the current session. On each update interval, it scans all price levels and identifies those that qualify as high volume nodes:

A price level qualifies as a HVN if its volume is higher than every other level within the configured Min Distance on both sides.
If Min Volume is set above 0, any level with volume below that threshold is skipped entirely.
All qualifying levels are output as Cloud Notes entries with the configured label, colors, and optional horizontal line.
As the session progresses and more trades occur, nodes will shift, appear, and disappear as the volume profile evolves.

Using Multiple Addons

If you run both the HVN Marker and LVN Marker at the same time, each must use a different port. The defaults are:

HVN Marker: port 8002
LVN Marker: port 8003

Add both URLs as separate Cloud Notes sources in Bookmap to see both HVN and LVN markers on the same chart.

Troubleshooting

Issue	Solution
No markers on chart	Confirm Cloud Notes is enabled and the URL matches the one in the addon settings. Wait at least 60 seconds.
Cloud Notes shows "Unavailable"	This is normal after changing settings or first loading. Wait a few minutes. If it persists, verify the URL and port.
Port already in use	Change the port in Cloud Notes Server settings and click Save Settings. Update the URL in Bookmap's Cloud Notes.
Markers disappeared	If Auto-Reset is on, markers clear at session boundaries. If Bookmap restarted, the volume profile resets.
Stale markers after update	Delete the old .jar from build/libs before rebuilding. Close and reopen Bookmap completely.

High Volume Node Marker