Vantom
Documentation

Vantom reference

Everything you need to set up, navigate, and get the most out of Vantom’s detection and reasoning pipeline.

01 / Getting Started

Getting Started

Prerequisites

  • macOS — Apple Silicon or Intel
  • Flutter SDK not required — ships as a native .app

First launch

Vantom walks you through connecting your trading accounts on first run. You’ll link one brokerage — Webull or Robinhood — and one charting platform: TradingView, Finviz, or thinkorswim.

Each connection runs in an isolated browser view. Vantom captures the session, not your credentials.

Live market data

Vantom connects to live market data automatically — no API keys or external accounts needed.

Asset classSourceIncluded on
CryptoBinanceAll plans
US EquitiesAlpacaPro
ForexFinnhubPro

On the free plan, the detection engine and AI reasoning run fully on crypto data. Upgrade to Pro to enable equities and forex across all your tabs.

02 / Using Vantom

Using Vantom

Opening a ticker

Press ⌘T to open search. Type any symbol, ETF, index, or query. Navigate results with and confirm with Enter. Each result opens as a new tab.

Tab management

ActionShortcut
New tab (search)⌘T
Jump to tab 1–9⌘1 … ⌘9
Cycle tabs forwardOption + Tab
Cycle tabs backwardOption + Shift + Tab
Confirm tab switchRelease Option
Cancel tab switchEsc

Views inside a tab

Each tab has three views. Panels can be stacked and resized with draggable dividers.

ViewShortcutWhat it shows
Portal⌘BWebull quote page for the active ticker
Chart⌘GTradingView charting interface
Insights⌘NAI verdict panel — toggle open/closed

Insights panel

Each insight card shows the detected pattern, a confidence score from 1–10, and — when the AI has reasoned over it — a full verdict with entry type and price, invalidation level, price target, written thesis, and key risks.

Cards can be Pinned (kept across sessions) or Dismissed. OS-level desktop notifications fire for high-confidence setups when price is actively approaching the zone. Notification threshold is adjustable in Settings.

Settings

Reach settings from the gear icon in the title bar. ⌘D opens the dev menu. Currently exposes:

  • Theme selection — 7 options, changes live
  • Session management — sign out clears cookies and stored sessions
03 / Understanding Signals

Understanding Signals

Vantom’s detection engine looks for three market events on every closing candle.

Fair Value Gap

A price inefficiency created when a candle moves so aggressively it skips over a range entirely, leaving an unfilled gap between the prior candle’s edge and the following candle’s edge. Active gaps represent zones where price may return to seek liquidity.

FVGs have three states: active (untouched), partial (price entered but didn’t close it), filled (discarded).

Liquidity Sweep

A move where price briefly pierces through a cluster of equal swing highs or lows — triggering stop orders — then reverses back. The reversal is the signal: it shows the move was absorption, not breakout.

Break of Structure

A candle close beyond the most recent confirmed swing high (bullish) or swing low (bearish). Signals that prior market structure has given way and momentum is committed.

How they combine

When multiple signals appear within the same price zone, Vantom treats them as a single setup and scores them together. The more signals that align, the higher the score — and the higher the score, the more likely the setup reaches the AI reasoning layer.

The highest-conviction setups — when all three signal types cluster in the same zone — are the only ones that trigger an AI-generated verdict.

Reading a verdict

Every AI verdict Vantom produces contains:

FieldDescription
DirectionBullish or bearish
Confidence1 to 10
EntryLimit, market, or stop, with exact price and zone bounds
InvalidationThe level that proves the thesis wrong
TargetThe price objective
ThesisA written explanation of why the setup is valid
Key risksSpecific reasons the setup could fail

Verdicts are stored locally and queryable by ticker and date.