Fathom Flow
Accelerations, exhaustions, slowdowns and absorption levels.
At a glance
- Identifier
flow-tracker- Objects received
drawing- Historical cost
- 1 compute unit per trade
What the indicator shows
- Exhaustion: a buying or selling phase runs out of steam (filled triangle on the Fathom chart). Its two readings,
variant0 and 1, are drawn the same way. - Slowdown: aggression fades near an extreme (hollow triangle on the Fathom chart).
- Acceleration: volume suddenly takes off (rectangle on the Fathom chart).
- Control (C) and extreme (E) lines, drawn when price leaves a consolidation: the control line marks its reference level, nearer the breakout, the extreme line its outer edge, opposite the breakout. On the Fathom chart, the control line is solid and the extreme line dotted.
- The
labelfield combines A (absorption, a breakout against the consolidation’s delta) or P (a breakout with it), then C or E. Example:ACis the control line after an absorption.
How to use it
- An acceleration in the direction of the move confirms it. An exhaustion or a slowdown near an extreme warns that it is losing strength, often before a reversal.
- After a consolidation, the control (C) and extreme (E) lines are reference levels to follow the breakout. A breakout marked A (
AC,AE) went against delta: the aggression was absorbed. - Tune each signal separately:
weakto see more of them,strongto keep only the most pronounced. - Do not show a drawing with
visible: false.
How to read and draw it
- Acceleration (rectangle): a sudden surge of activity. Draw it from
lowtohigh, fromstart, which can be before its anchor bar. It stays extended until price closes through it, or until it reaches its maximum length. - Exhaustion (filled triangle): a buying or selling phase runs out of steam. The triangle is placed on the opposite side of the phase (
up: trueafter a selling phase), just beyond the bar’s extreme.variant0and1are two independent exhaustion readings, drawn the same way; both can flag the same bar, at the same price: draw a single triangle there. - Slowdown (hollow triangle): aggression fades as price reaches a short-term low (bullish,
up: true) or high. - Consolidation lines: when price breaks out of a consolidation, two lines are drawn. The control line (
control, label ending inC) marks the consolidation’s reference level, nearer the breakout; the extreme line (extreme, label ending inE) marks its outer edge, on the side opposite the breakout. Both are levels to watch as price moves away from the consolidation or comes back to it. A line stays extended until price closes through it,projectionBarsbars at most. levelModeplaces the two lines, from farthest from the breakout (conservative) to closest (aggressive).- The four sensitivities go from
weak(more signals) tostrong(fewer, more pronounced ones). label:A(absorption) when the breakout goes against the consolidation’s delta,Pwhen it goes with it, thenC(control) orE(extreme).sidegives the sign of that delta,upthe breakout direction.
When it updates
- Each drawing is sent when its anchor bar (
bar) closes, sent again on every change, then sent final once it can no longer change: an exhaustion is final as soon as it is sent; a rectangle or a line, once it stops being extended (active: false, with itsend). - While it is the latest one, a slowdown can still change: its anchor bar (
bar,start), its price, its direction (up) andvisible. It becomes final when a new slowdown replaces it, or at the end of the week. - Most slowdowns are never shown: they are published with
visible: falseand usually end that way (inconfirmedmode they then arrive directly withvisible: false). Show onlyvisible: true. <kind>is the drawing type and<weekSunday>theYYYY-MM-DDdate of the week’s Sunday reopen. The ordinal is shared by all kinds: for a given kind, the numbers are not consecutive.- Weekly reset: on the first trade of the Sunday reopen (18:00 New York time), the week’s last bar is processed, rectangles and lines still extended stop (
active: false, with theirend), drawings still in progress are sent final and the readings start over.
Subscribe
The same params work in real time, on historical data and in exports. Parameters you omit take the defaults of the instrument’s ticker.
{
"t": "subscribe",
"sub": "flow-tracker",
"instrument": "NQ.front",
"indicator": "flow-tracker",
"params": {
"absorption": "medium",
"acceleration": "medium",
"exhaustion": "medium",
"levelMode": "conservative",
"projectionBars": 10,
"slowdown": "medium",
"timeframe": 60
},
"mode": "live",
"from": "live"
}Parameters
As soon as a parameter differs from its default on the instrument’s ticker, the subscription counts as a custom configuration. To change a parameter, open a new subscription.
Every ticker currently uses the generic defaults of the Default column. Defaults can be set per ticker and are regularly updated, ticker by ticker: an update changes the results of the subscriptions and queries that rely on them. A subscription whose parameters are all at its instrument’s defaults is not a custom configuration. Only explicit parameters keep a computation identical over time: pass them to keep the same results.
| Parameter | Type | Role | Default | Allowed values | Unit | Description |
|---|---|---|---|---|---|---|
absorption | choice | Computation | medium | weak · medium · strong | — | Sensitivity of the control and extreme lines: weak (more lines), medium or strong (fewer lines, after the most pronounced consolidations). |
acceleration | choice | Computation | medium | weak · medium · strong | — | Acceleration sensitivity: weak (more signals), medium or strong (fewer, more pronounced signals). |
exhaustion | choice | Computation | medium | weak · medium · strong | — | Exhaustion sensitivity: weak (more signals), medium or strong (fewer, more pronounced signals). |
levelMode | choice | Computation | conservative | conservative · medium · aggressive | — | Placement of the control and extreme lines, from farthest from the breakout (conservative) to closest (aggressive). |
projectionBars | integer | Computation | 10 | 1 to 1,000 | bars | Maximum length of the control and extreme lines, in bars; a line stops earlier when price closes through it. |
slowdown | choice | Computation | medium | weak · medium · strong | — | Slowdown sensitivity: weak (more signals), medium or strong (fewer, more pronounced signals). |
timeframe | integer | Computation | 60 | 1 · 5 · 10 · 15 · 30 · 60 · 120 · 180 · 300 · 600 · 900 · 1800 · 3600 · 7200 · 10800 · 14400 · 86400 | seconds | Bar duration in seconds: from 1 second (1) to 1 day (86400). Bars are counted from the product's session open (18:00 New York time for every current product): 4-hour bars start at 18:00, 22:00, 02:00 and so on, and a 1-day bar covers the whole session. |
Objects received
Each object keeps the same id from one update to the next. Its data is in the data field. Prices are in ticks: Prices and timestamps explains how to convert them.
An object sent in progress arrives with final: false, then again on every change, and each version fully replaces the previous one. Its description says when it ends: most objects end with a last version carrying final: true, and some are removed without one. An object sent final is sent once, with final: true.
Fields and units
Prices are in ticks (Prices and timestamps). Timestamps are nanoseconds since the Unix epoch, sent as strings: parse them as 64-bit integers. The fields below place the objects in time.
| Field | Unit | How to read it |
|---|---|---|
drawing.bar | timestamp (ns) · string | Start of the anchor bar: the reference of start and end. |
drawing.start | bars · number | Offset from bar, in timeframe-second bars, to a tenth; can be negative. Time: bar + start × timeframe × 10⁹. |
drawing.end | bars · number | Offset from bar where a final rectangle or line stops, in the same unit as start. |
drawing sent in progress
Drawing; in progress while it can still change.
id format: <kind>:<weekSunday>:<ordinal>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
kind | string · acceleration | exhaustion | slowdown | control | extreme | — | always | Type: acceleration (rectangle), exhaustion and slowdown (triangles), control and extreme (lines). It is also the first segment of the id. |
active | boolean | — | sometimes | Rectangle or line still extended to the right. |
bar | string | timestamp (ns) | always | Start of the anchor bar. |
end | number | bars | sometimes | End of the drawing, in the same unit as start (bars relative to bar, rounded to a tenth, can be fractional); present on final rectangles and lines. |
high | integer | ticks | sometimes | Top of a rectangle. |
label | string · AC | PC | AE | PE | — | sometimes | Line: A (absorption) when the consolidation breakout goes against its delta, P when it goes with it; then C for the control line, E for the extreme line. AC is the control line after an absorption. |
low | integer | ticks | sometimes | Bottom of a rectangle. |
price | integer | ticks | sometimes | Price of a triangle or a line. Exhaustion: just beyond the bar’s low (up: true) or high; slowdown: at the short-term low (up: true) or high. |
side | string · buy | sell | — | sometimes | Line: the side that dominated the consolidation, buy (buyers) or sell (sellers). |
start | number | bars | always | Start of the drawing, in timeframe-second bars relative to bar (0 = start of bar), rounded to a tenth: can be fractional or negative, a drawing can start before its anchor bar. Matching time, in nanoseconds: bar + start × timeframe × 10⁹, rounded to the nanosecond, in 64-bit integers (bar is in nanoseconds; timeframe, in seconds, comes from your parameters). |
up | boolean | — | always | Bullish direction: a buying acceleration, the exhaustion of a selling phase, a slowdown at a low, an upward consolidation breakout for a line. It can change on a slowdown in progress. |
variant | integer | — | sometimes | Exhaustion: 0 or 1, two independent exhaustion readings, drawn the same way. Both can flag the same bar, at the same price: draw a single triangle there. |
visible | boolean | — | always | false: the signal is not valid, do not show it. Only slowdowns use it, and most of them are never shown: a slowdown can switch between true and false while it is in progress, and most end with false (they then arrive that way in confirmed mode). |
Example messages
Messages as the WebSocket sends them to the subscription above, taken from a real NQ session. Historical data returns the same objects, with the same cursor, without the sub field.
The params of the subscription above are the current NQ ticker defaults, written out in full.
{
"sub": "flow-tracker",
"cursor": "20720.2457.0",
"t": "upsert",
"id": "exhaustion:2026-09-20:1101",
"final": true,
"ts": "1790209200076693991",
"data": {
"kind": "exhaustion",
"bar": "1790209140000000000",
"start": 0,
"price": 122953,
"up": true,
"visible": true,
"variant": 0
}
}{
"sub": "flow-tracker",
"cursor": "20720.3293.1",
"t": "upsert",
"id": "slowdown:2026-09-20:1104",
"final": false,
"ts": "1790209860030424303",
"data": {
"kind": "slowdown",
"bar": "1790209800000000000",
"start": 0,
"price": 122940,
"up": false,
"visible": true
}
}{
"sub": "flow-tracker",
"cursor": "20720.3454.0",
"t": "upsert",
"id": "control:2026-09-20:1105",
"final": false,
"ts": "1790209920141869579",
"data": {
"kind": "control",
"bar": "1790209860000000000",
"start": 0,
"price": 122927,
"up": true,
"visible": true,
"active": true,
"label": "AC",
"side": "sell"
}
}{
"sub": "flow-tracker",
"cursor": "20720.3454.1",
"t": "upsert",
"id": "extreme:2026-09-20:1106",
"final": false,
"ts": "1790209920141869579",
"data": {
"kind": "extreme",
"bar": "1790209860000000000",
"start": 0,
"price": 122913,
"up": true,
"visible": true,
"active": true,
"label": "AE",
"side": "sell"
}
}{
"sub": "flow-tracker",
"cursor": "20720.3770.0",
"t": "upsert",
"id": "slowdown:2026-09-20:1104",
"final": true,
"ts": "1790210280761988745",
"data": {
"kind": "slowdown",
"bar": "1790209800000000000",
"start": 0,
"price": 122940,
"up": false,
"visible": true
}
}{
"sub": "flow-tracker",
"cursor": "20720.4035.0",
"t": "upsert",
"id": "control:2026-09-20:1105",
"final": true,
"ts": "1790210520086671473",
"data": {
"kind": "control",
"bar": "1790209860000000000",
"start": 0,
"end": 10,
"price": 122927,
"up": true,
"visible": true,
"active": false,
"label": "AC",
"side": "sell"
}
}JSON schemas
To validate or type your data: the JSON schemas of the parameters and of data, also available from GET /v1/indicators. The SDKs can generate types from them. Rules that compare two parameters, such as a maximum of at least its minimum, and the two decimals of decimal parameters, are only in the parameter descriptions: the API checks them too.
Parameters schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://fathomcharts.com/schemas/flow-tracker/params.json",
"type": "object",
"additionalProperties": false,
"properties": {
"absorption": {
"description": "Sensitivity of the control and extreme lines: `weak` (more lines), `medium` or `strong` (fewer lines, after the most pronounced consolidations).",
"type": "string",
"default": "medium",
"enum": [
"weak",
"medium",
"strong"
]
},
"acceleration": {
"description": "Acceleration sensitivity: `weak` (more signals), `medium` or `strong` (fewer, more pronounced signals).",
"type": "string",
"default": "medium",
"enum": [
"weak",
"medium",
"strong"
]
},
"exhaustion": {
"description": "Exhaustion sensitivity: `weak` (more signals), `medium` or `strong` (fewer, more pronounced signals).",
"type": "string",
"default": "medium",
"enum": [
"weak",
"medium",
"strong"
]
},
"levelMode": {
"description": "Placement of the control and extreme lines, from farthest from the breakout (`conservative`) to closest (`aggressive`).",
"type": "string",
"default": "conservative",
"enum": [
"conservative",
"medium",
"aggressive"
]
},
"projectionBars": {
"description": "Maximum length of the control and extreme lines, in bars; a line stops earlier when price closes through it.",
"type": "integer",
"default": 10,
"minimum": 1,
"maximum": 1000
},
"slowdown": {
"description": "Slowdown sensitivity: `weak` (more signals), `medium` or `strong` (fewer, more pronounced signals).",
"type": "string",
"default": "medium",
"enum": [
"weak",
"medium",
"strong"
]
},
"timeframe": {
"description": "Bar duration in seconds: from 1 second (`1`) to 1 day (`86400`). Bars are counted from the product's session open (18:00 New York time for every current product): 4-hour bars start at 18:00, 22:00, 02:00 and so on, and a 1-day bar covers the whole session.",
"type": "integer",
"default": 60,
"enum": [
1,
5,
10,
15,
30,
60,
120,
180,
300,
600,
900,
1800,
3600,
7200,
10800,
14400,
86400
]
}
}
}data field schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://fathomcharts.com/schemas/flow-tracker/data.json",
"title": "drawing",
"type": "object",
"additionalProperties": false,
"properties": {
"kind": {
"description": "Type: acceleration (rectangle), exhaustion and slowdown (triangles), control and extreme (lines). It is also the first segment of the `id`.",
"type": "string",
"enum": [
"acceleration",
"exhaustion",
"slowdown",
"control",
"extreme"
]
},
"active": {
"description": "Rectangle or line still extended to the right.",
"type": "boolean"
},
"bar": {
"description": "Start of the anchor bar.",
"type": "string",
"pattern": "^[0-9]+$"
},
"end": {
"description": "End of the drawing, in the same unit as `start` (bars relative to `bar`, rounded to a tenth, can be fractional); present on final rectangles and lines.",
"type": "number"
},
"high": {
"description": "Top of a rectangle.",
"type": "integer"
},
"label": {
"description": "Line: `A` (absorption) when the consolidation breakout goes against its delta, `P` when it goes with it; then `C` for the control line, `E` for the extreme line. `AC` is the control line after an absorption.",
"type": "string",
"enum": [
"AC",
"PC",
"AE",
"PE"
]
},
"low": {
"description": "Bottom of a rectangle.",
"type": "integer"
},
"price": {
"description": "Price of a triangle or a line. Exhaustion: just beyond the bar’s low (`up: true`) or high; slowdown: at the short-term low (`up: true`) or high.",
"type": "integer"
},
"side": {
"description": "Line: the side that dominated the consolidation, `buy` (buyers) or `sell` (sellers).",
"type": "string",
"enum": [
"buy",
"sell"
]
},
"start": {
"description": "Start of the drawing, in `timeframe`-second bars relative to `bar` (0 = start of `bar`), rounded to a tenth: can be fractional or negative, a drawing can start before its anchor bar. Matching time, in nanoseconds: `bar` + `start` × `timeframe` × 10⁹, rounded to the nanosecond, in 64-bit integers (`bar` is in nanoseconds; `timeframe`, in seconds, comes from your parameters).",
"type": "number"
},
"up": {
"description": "Bullish direction: a buying acceleration, the exhaustion of a selling phase, a slowdown at a low, an upward consolidation breakout for a line. It can change on a slowdown in progress.",
"type": "boolean"
},
"variant": {
"description": "Exhaustion: `0` or `1`, two independent exhaustion readings, drawn the same way. Both can flag the same bar, at the same price: draw a single triangle there.",
"type": "integer"
},
"visible": {
"description": "`false`: the signal is not valid, do not show it. Only slowdowns use it, and most of them are never shown: a slowdown can switch between `true` and `false` while it is in progress, and most end with `false` (they then arrive that way in `confirmed` mode).",
"type": "boolean"
}
},
"required": [
"kind",
"bar",
"start",
"up",
"visible"
]
}