Quick Start
Get VPOC Migration Pro running on your chart in under 2 minutes.
- In Bookmap, go to Configure add-ons on your chart and check VPOC Migration Pro to enable it.
- Open the addon settings. Under Session, select Globex (18:00) or RTH (09:30) depending on your session. Click Save Settings.
- Copy the URL from the Cloud Notes Server panel (e.g.,
http://127.0.0.1:8001/vpoc_levels.csv).
- Right-click on your chart, select Cloud Notes, paste the URL, set download interval to 1 minute, and click Save.
- Wait up to 1 minute. VPOC levels will appear in your notes panel and as horizontal lines on the chart.
The addon backfills historical data when loaded, so your VPOC levels are accurate from session start even if you load it mid-session.
How It Works
The addon builds a volume profile from every trade, identifies the price level with the highest volume (VPOC), and tracks every time it migrates to a new level.
When VPOC shifts to a new price, the old level is classified as a Naked VPOC — a level where VPOC once resided but price has not returned to since. If price later revisits that level, it becomes a Tested VPOC.
This matters because Naked VPOCs represent untested fair value — significant support/resistance levels in Auction Market Theory. The market tends to return to these levels.
Three Level Types
| Level | Meaning | Default Color |
|---|
| Current VPOC | The active highest-volume price this session | Green |
| Tested VPOC | Prior VPOC that price has revisited | Gray |
| Naked VPOC | Prior VPOC that price has NOT returned to | Magenta |
Direction Arrows
Each Tested and Naked level includes a direction indicator showing which way VPOC migrated when it left that level:
Naked VPOC 1 ^ (14:32) — VPOC migrated upward from this level at 14:32 ET
Tested VPOC 1 v (15:10) — VPOC migrated downward from this level at 15:10 ET
A cluster of ^ arrows means VPOC was trending higher (bullish migration). A sequence of v means bearish migration. Mixed arrows indicate rotation.
Visit Numbering
When VPOC returns to a price level it has previously occupied during the session, the visit number increments. This tells you how many times fair value has settled at that price:
Naked VPOC 1 ^ (10:15) — first time VPOC left this price
Naked VPOC 2 ^ (11:30) — VPOC returned to this price and left again (second visit)
VPOC 3 — VPOC is currently at this price for the third time this session
A high visit count at a single price indicates strong agreement on fair value — the market keeps returning there. This is useful for post-session analysis and journaling. Visit numbering can be toggled on or off in the Appearance settings.
Settings Reference
Session
Session TypeQuick preset: Globex (18:00) for overnight session, RTH (09:30) for regular trading hours, or Custom to set any time.
Start Hour / MinuteThe session start time in Eastern Time (ET). Locked when using Globex or RTH presets, editable in Custom mode.
Auto-ResetWhen enabled, the addon automatically clears the volume profile and starts a new session when the session boundary is crossed (every 24 hours from your start time). The old session log is saved before resetting.
Save SettingsSaves all settings and reloads the addon with backfill. Use this after changing any setting.
Filters
Dwell Time FilterWhen enabled, a VPOC shift is only registered if the new VPOC holds for the specified number of seconds. This eliminates noise when two price levels have similar volume and VPOC flickers between them. Default: 30 seconds.
Max Levels ShownLimits how many Tested/Naked levels appear in Cloud Notes. Older levels are still tracked internally for naked/tested detection but won't clutter your chart. Default: 20.
Cloud Notes Server
AddressThe IP address the built-in HTTP server listens on. Default: 127.0.0.1 (localhost). Change only if you have a specific network setup.
PortThe port number. Default: 8001. Change if this port conflicts with another application.
URLThe full URL to paste into Bookmap's Cloud Notes configuration. Click the field to select and copy it.
The Cloud Notes download interval in Bookmap controls how often levels update on the chart. Set it to 1 minute for the fastest updates.
Appearance
Chart Line ColorThe color of the VPOC indicator line drawn on the heatmap. Click the color swatch to open a color picker.
Show Direction (^v)When enabled, appends ^ (up) or v (down) to each Tested/Naked label showing which direction VPOC migrated.
Show Visit Number (1,2,3..)When enabled, appends a visit count to every level label — including the Current VPOC. Shows how many times VPOC has occupied that price this session. Useful for data export and post-session analysis. Default: on.
Notes
Configure each of the three level types independently.
| Column | Description |
|---|
| Label | The text that appears in Cloud Notes for this level type. Customize to match your terminology (e.g., "DVPOC", "VHVN", "V-HVN"). |
| Text | Foreground (text) color of the note. Click to change. |
| BG | Background color of the note. Click to change. |
| Show | Toggle visibility of this level type in Cloud Notes output. |
| Line | Toggle whether a horizontal line is drawn on the chart for this level type. |
Tested and Naked labels automatically get the visit number, migration direction, and time appended, e.g., "VHVN 2 ^ (14:32)". The Current VPOC also shows its visit number when enabled, e.g., "VPOC 3".
Alerts
VPOC ShiftsTrigger a sound and/or voice alert when VPOC migrates to a new price level. Voice announces the label name and direction (e.g., "DVPOC moved up").
Naked TouchedTrigger a sound and/or voice alert when price revisits a Naked VPOC level, converting it to Tested. Voice announces the label name (e.g., "VHVN touched").
CooldownMinimum seconds between alerts. Prevents alert stacking during rapid VPOC shifts or multiple naked touches. Default: 5 seconds. Set to 0 to disable.
Voice alerts use Windows Text-to-Speech via PowerShell. They run in background threads and do not block Bookmap. Sound alerts and all other features work on any platform.
Session Log
Enable Session LogWhen enabled, all VPOC migrations, naked touches, and session events are logged to a text file for post-session review and journaling.
Log PathFile path for the session log. The file is appended to (not overwritten), so all sessions accumulate in one file. Default: C:\BookMap Indicators\vpoc_session_log.txt
Each session entry includes a header with date and session time, timestamped events, and a summary showing total shifts, naked count, tested count, and final VPOC price.
About
Displays version number, developer info, and contact details.
Session Log Example
When session logging is enabled, the log file records every event with timestamps:
===
[email protected] | 2026-04-06 | 18:00 ET ===
2026-04-06 18:00:01 | SESSION START
2026-04-06 18:14:22 | INITIAL VPOC | 6585.75
2026-04-06 18:46:10 | VPOC SHIFT ^ | 6585.75 -> 6576.00
2026-04-06 18:48:33 | VPOC SHIFT v | 6576.00 -> 6585.75
2026-04-06 19:15:08 | NAKED TOUCHED | 6576.00
2026-04-06 19:30:45 | VPOC SHIFT ^ | 6585.75 -> 6580.75
2026-04-06 03:10:12 | VPOC SHIFT ^ | 6580.75 -> 6612.00
--- 6 shifts | 3 naked | 3 tested | Final: 6626.00 ---
FAQ
Why don't the Cloud Notes update instantly?
Bookmap polls the Cloud Notes URL at the interval you set (minimum 1 minute). The addon's internal data updates every 5 seconds, but the chart notes only refresh on each poll. The VPOC indicator line on the heatmap updates in real time.
Can I use this with any data provider?
Yes. The addon uses trade data which is available from all providers — Rithmic, CQG, dxFeed, TM.Lite, Interactive Brokers, and others.
What happens if I load the addon mid-session?
The addon backfills historical trade data from session start, so VPOC levels are calculated accurately even if you connect late.
Can I run this on multiple charts?
Yes, but each instance needs a different HTTP port. Change the port in the Cloud Notes Server settings for each chart (e.g., 8001, 8002, 8003).
What does the Dwell Time Filter do exactly?
During periods where two price levels have very similar volume, VPOC can flicker between them rapidly. The dwell filter requires the new VPOC to hold for X seconds before registering the shift. This eliminates false migrations and keeps your levels clean.
Do alerts work on Mac/Linux?
Sound alerts (system beep) work everywhere. Voice alerts use Windows PowerShell Text-to-Speech and are Windows-only.