FREE ADDON · v1.02

Stats by Target, live inside Bookmap.

A free Bookmap addon that shows Tom B.'s "Stats by Target" touch-probability table in its own movable window. Live levels, dual stats, automatic 12:1 banner, full session backfill.

Version 1.02 Bookmap Simplified API ProGuard-obfuscated jar

A representative view of the addon's own window — sorted nearest-to-price first, hits drop to the bottom with the time they printed.

TLAB Stats — Complete Guide

⚠ WARNING — READ BEFORE INSTALLING

This is a FREE addon, provided as-is.

By downloading, installing, or using TLAB Stats, you acknowledge and agree to:

  • No support of any kind beyond bug reports. You are solely responsible for installing, configuring, and operating this addon. Please consult the User Manual, or try ChatGPT / Claude / Gemini for configuration questions. If direct help is needed, a paid 1-on-1 session is available. Bug reports are welcome at [email protected] — they are addressed when they reach the author. No support is provided by SDES for "how do I" questions, none by TraderLab, none by Tom B., and none by Bookmap.
  • No Guaranteed Updates: The developer may or may not release updates at their sole discretion.
  • Data Accuracy: If Bookmap's backfill does not reach an earlier part of the session, the addon's reconstruction of that period may be incomplete. Verify all data independently before making trading decisions.
  • Not a Trading Signal: The probabilities shown are historical descriptive statistics, not predictions. Context supersedes statistics — no exceptions.
  • 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. The jar is proprietary, ProGuard-obfuscated, and free to use inside Bookmap — but may not be copied, modified, decompiled, reverse engineered, or reused. See the licence.
  • Third-Party Disclaimer: Bookmap is not responsible for this addon. Bookmap support will not assist with it. TraderLab and Tom B. are not responsible for this addon — it ports a published probability table for personal study, and is not endorsed by either.
  • 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

TLAB Stats is a self-contained Bookmap addon that displays Tom B.'s "Stats by Target" touch-probability table for the current session — in its own movable window, not buried inside Bookmap's add-on dialog.

It tracks 17 reference levels per session — overnight, Initial Balance (and its 1.5× / 2.0× extensions), and prior-day levels — and shows for each:

  • Its historical hit probability for today's day type (the Stat %);
  • Your own auto-tracked empirical hit rate (the My %);
  • A proximity meter — how close price is to it right now;
  • Whether price has hit it today, and at what time.

An automatic 12:1 stat banner watches for a new daily extreme made between 12-1 PM CST outside the prior day's range, and qualifies as a caution strip when it triggers. Tom B.'s observed rates for that scenario: ~71% to break that extreme again, ~86% to come within a point of it.

TLAB Stats is self-contained — it needs no other software. All it asks of you is six numbers a day (yesterday's RTH levels) in a small CSV that ships with the jar.

Requirements

  • Bookmap (the addon targets the Simplified API; built against Bookmap 7.x).
  • The addon jar: tlab-stats-v1.02.jar (download below).
  • The CSV template: prior_day_levels.csv (download below).
  • Windows, macOS, or Linux — anywhere Bookmap runs.

Installation

In a hurry? Grab the Quick Start PDF — one page, install + first-trade.
  1. Download two files from this page — tlab-stats-v1.02.jar (the addon) and prior_day_levels.csv (the daily-levels template).
  2. Save prior_day_levels.csv to your home folder (Windows: C:\Users\<your-name>\). The addon looks there by default — keep it there and you don't need to touch any setting. Want it elsewhere? Save it anywhere, then set the path in step 4.
  3. Install the jar in Bookmap: Settings → Configure add-ons → Add → select tlab-stats-v1.02.jar. Then tick TLAB Stats - Stats by Target.
  4. (Optional) If you saved the CSV anywhere other than your home folder, open the addon's settings panel in the same dialog and set Daily levels CSV to the file's full path.
  5. Edit prior_day_levels.csv in Notepad — replace the six sample values with today's prior-day RTH numbers (P High, P Low, P Close, P VPOC, P VAH, P VAL). Save the file. The addon watches it and reloads instantly.

The TLAB Stats window opens automatically once Bookmap sees the first trade. If you close it, reopen it with Open TLAB Stats window in the add-on's settings panel.

Updating to a new version: untick TLAB Stats → RemoveAdd the new tlab-stats-v*.jar → tick it again. Bookmap locks the old jar while it is loaded, so it must be removed first. The current version number is shown at the bottom of the window.

First-Time Setup — the daily CSV

TLAB Stats self-generates almost everything, but it cannot know yesterday's RTH levels — those must be supplied. Download prior_day_levels.csv from the Downloads section, place it alongside the jar (or anywhere — set the path in the add-on settings) and replace the six values with today's prior-day numbers:

P High,7512.50
P Low,7488.25
P Close,7501.00
P VPOC,7499.50
P VAH,7505.75
P VAL,7494.00
  • Names are case- and space-insensitive (P High, pHI, phigh all work).
  • P Mid is derived automatically (midpoint of P High and P Low).
  • Lines beginning with # are comments.
  • Edit it in Notepad, not Excel — Excel reformats CSV files.
  • The addon watches the file and reloads it the moment you save. There is also a Reload CSV button in the window.
If the prior-day rows in the window look wrong, it is almost always because the CSV still has the template's sample numbers. Replace them.

Overnight levels and the Initial Balance are self-generated from backfilled trades and do not need to be in the CSV. (The CSV has optional commented-out lines for them, used only as a fallback if Bookmap's backfill cannot reach the overnight session.)

The Window — a walkthrough

Toolbar

  • Day typeAuto-detect, or force a column: HIR / LIR / HOR / LOR / In Range / Out of Range. This selects which probability column drives every number in the window.
  • Always on top — keep the window above other windows.
  • Reload CSV — re-read the daily CSV immediately.

Header

The instrument, the classified open type, the gap from prior close, the prior-day range, and the live price.

Levels table

Every tracked level, sorted nearest-to-price first; levels already hit drop to the bottom. Each row has five columns:

ColumnMeaning
99%/63%Dual stat — historical Stat % / your tracked My %
●●●○○○○○Proximity meter — how close price is to the level
ONHLevel name
7507.75Level price
▼1.42% or 09:32:23Distance from price — or, if hit, the green hit time

Next Up

The five nearest un-hit levels — where price is most likely to go next, ranked purely by proximity.

Hit Sequence

A numbered log of every level hit this RTH session, in order, with the time and an up/down arrow.

Footer

Live summary: 4 / 17 levels hit · column: HOR · history: 12 sessions · 14:11:06 ET, with the version number on the very bottom line.

Dual Stats — Stat % / My %

Each level shows two numbers, e.g. IBH  99%/63%:

  • Stat % (first number) — the historical "Stats by Target" probability for the current day type. For a paired level (IBH/IBL, ONH/ONL, pVAH/pVAL, pHigh/pLow, the IB 1.5× and 2.0× pairs) this is the "either of the pair gets hit" rate. Once the sibling level is tagged, it flips to the "both hit" rate — so the number updates as the session develops. Example: before either IB extreme is hit, IBH and IBL both show ~99%; once IBH is hit, IBL drops to the ~24% "both hit" rate.
  • My % (second number) — your own empirical hit rate, tracked automatically per instrument (see Personal stats below). Shows - until enough sessions have been recorded. Personal-stat tracking is optional and can be turned off.

The Proximity Meter

The 8-dot meter (●●●○○○○○) shows how close price is to that level:

  • A full meter ≈ price is almost on the level;
  • An empty meter ≈ the level is 40+ points away;
  • Each dot ≈ 5 points.

A hit level shows a full green meter.

Day-Type Classification

At the RTH open the addon classifies the day from the opening price against the prior-day levels:

  • Open above P HighHOR (High Out of Range, gap up)
  • Open below P LowLOR (Low Out of Range, gap down)
  • Open in range, ≥ P CloseHIR (High In Range)
  • Open in range, < P CloseLIR (Low In Range)

The result selects the probability column for every level in the window. Before the open (or with no CSV loaded) the All-days column is used. You can override the classification at any time with the Day type toolbar control.

The 12:1 Stat Banner

A fully automatic caution strip that sits below the price line. It arms when the day prints a new daily high or low between 12-1 PM CST (the 13:00–14:00 ET window) outside the prior day's range — Tom B.'s "12:1 stat":

  • ~71% to break that extreme again;
  • ~86% to come within a point of it.

The banner is fully automatic — the addon evaluates the rule itself. It stays hidden until the stat triggers, reads forming while the 12-1 PM CST window is still open, and after 1 PM CST self-resolves to QUALIFIED  ·  DO NOT FADE (recommended) if a new daily extreme printed in that window outside the prior day's range, or to not qualified if it stayed inside. It is an observation, never a row in the levels table, and clears at the next session.

Backfill — attach any time

TLAB Stats uses Bookmap's Simplified API, which delivers a data clock and backfilled historical trades. When you attach the addon — even at midday — Bookmap replays the session through it with the original timestamps, so:

  • A level hit at 10:00 is shown as hit and stamped 10:00;
  • The Initial Balance (09:30–10:30) rebuilds itself;
  • The overnight levels and today's open are reconstructed.

You do not have to run the addon all session. Backfill covers however much history Bookmap has loaded for that chart — normally the whole session. If an early stretch looks missing, scroll the chart back to load more history and it fills in.

Personal Stats — the history file

When personal-stat tracking is enabled, the addon records every live session it runs to a per-instrument file:

BmStats_history_<instrument>.csv

One row per session: date, dayType, then 1/0 for each level. This is what powers the second number in the dual stat. The rate shown is the overall rate until a day-type bucket has at least 10 sessions, after which that bucket switches to its day-type-specific rate.

Backfilled past days are not recorded — only sessions you actually ran live — so the personal stat is a true forward record. The history folder is configurable in the settings panel (default: your home directory). Turn the whole feature off to run Stat %-only with no history file written.

The 17 Tracked Levels

GroupLevelsSource
OvernightONH, ONL, ON VPOC, ON Midself-generated
Initial BalanceIBH, IBL, IBH 1.5, IBL 1.5, IBH 2.0, IBL 2.0self-generated
Prior dayP High, P Low, P Close, P VPOC, P VAH, P VAL, P Middaily CSV (P Mid derived)

IB extensions are projections of the IB range from the opposite IB extreme: IBH 1.5 = IBL + 1.5 × (IBH − IBL), and so on.

IB levels are tracked from 10:30 — the IB forms during 09:30–10:30, so a level can only be "hit" once that window has closed. Overnight and prior-day levels are tracked from the 09:30 open. An optional 30-minute IB (IBH 30 / IBL 30) can be enabled in the settings panel as additional reference lines.

Settings Reference

SettingDefaultMeaning
Daily levels CSVprior_day_levels.csvPath to the daily CSV. Watched — saves reload instantly.
Session open / close09:30 / 16:00 ETThe RTH window the addon classifies and tracks against.
IB window (minutes)60Length of the Initial Balance from the session open.
Show the 30-minute IBoffAdds IBH 30 / IBL 30 reference lines.
Hit tolerance (ticks)0Slack added before a level counts as hit.
Hit soundoffOptional alert on a live hit. Presets: Beep / Ding / Chime / Bell / Buzz. Test button included. Silent during backfill.
Track personal statsonTurn off to run Stat %-only with no history file written.
History folderhome directoryWhere BmStats_history_*.csv is written.

The day type, always-on-top, and window position persist automatically through Bookmap.

Troubleshooting

SymptomCause / fix
Prior-day rows show odd pricesThe CSV still has the template's sample numbers — replace them with today's.
Overnight / IB levels blankBackfill did not reach that part of the session — scroll the chart back to load more history, or fill the optional CSV lines.
A second, blank window appearedShould not happen — the window opens lazily and is single-instance. If it does, please report it.
Window didn't openIt opens on the first trade. Use Open TLAB Stats window in the add-on's settings panel, or wait for a trade.
Numbers seem one day staleUpdate the CSV; it is yesterday's data, not today's.
Bookmap won't let me replace the jarUntick TLAB Stats and Remove it first — Bookmap locks the file while loaded.

Distribution & Licence

TLAB Stats is hosted here on sdes.dev and mirrored on GitHub at SeanDavid-stack/TLAB-STATS-BM-public. The jar is ProGuard-obfuscated and the source code is not part of this distribution. The addon is free to use inside Bookmap but is proprietary — the jar may not be copied, modified, decompiled, reverse engineered, or fed to an AI to reproduce or decompile it. See the licence.

Get TLAB Stats

All files are hosted here on sdes.dev and mirrored on the public GitHub repo. Pick whichever you prefer — the contents are identical.

🪞 SDES.DEV is the primary host · GitHub is the canonical mirror

tlab-stats-v1.02.jar

The addon. ProGuard-obfuscated. ~25 KB.

⬇ Download .jar mirror: GitHub raw
📊

prior_day_levels.csv

Daily CSV template. Edit in Notepad.

⬇ Download CSV mirror: GitHub raw

Quick Start PDF

One-page install + first-trade cheatsheet.

⚡ Open Quick Start mirror: GitHub
📕

User Manual PDF

The complete walkthrough — printable.

📖 Open PDF manual also: .md version · GitHub
📜

Changelog

What's in v1.02.

📋 View changelog mirror: GitHub

Licence

Proprietary — free to use in Bookmap.

📃 Read licence mirror: GitHub

Public repo

Canonical mirror for the jar & docs.

View on GitHub → latest: commits on main