Indicator

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, variant 0 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 label field combines A (absorption, a breakout against the consolidation’s delta) or P (a breakout with it), then C or E. Example: AC is 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: weak to see more of them, strong to 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 low to high, from start, 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: true after a selling phase), just beyond the bar’s extreme. variant 0 and 1 are 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 in C) marks the consolidation’s reference level, nearer the breakout; the extreme line (extreme, label ending in E) 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, projectionBars bars at most.
  • levelMode places the two lines, from farthest from the breakout (conservative) to closest (aggressive).
  • The four sensitivities go from weak (more signals) to strong (fewer, more pronounced ones).
  • label: A (absorption) when the breakout goes against the consolidation’s delta, P when it goes with it, then C (control) or E (extreme). side gives the sign of that delta, up the 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 its end).
  • While it is the latest one, a slowdown can still change: its anchor bar (bar, start), its price, its direction (up) and visible. 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: false and usually end that way (in confirmed mode they then arrive directly with visible: false). Show only visible: true.
  • <kind> is the drawing type and <weekSunday> the YYYY-MM-DD date 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 their end), 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.

Subscribe message
{
  "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.

ParameterTypeRoleDefaultAllowed valuesUnitDescription
absorptionchoiceComputationmediumweak · medium · strong—Sensitivity of the control and extreme lines: weak (more lines), medium or strong (fewer lines, after the most pronounced consolidations).
accelerationchoiceComputationmediumweak · medium · strong—Acceleration sensitivity: weak (more signals), medium or strong (fewer, more pronounced signals).
exhaustionchoiceComputationmediumweak · medium · strong—Exhaustion sensitivity: weak (more signals), medium or strong (fewer, more pronounced signals).
levelModechoiceComputationconservativeconservative · medium · aggressive—Placement of the control and extreme lines, from farthest from the breakout (conservative) to closest (aggressive).
projectionBarsintegerComputation101 to 1,000barsMaximum length of the control and extreme lines, in bars; a line stops earlier when price closes through it.
slowdownchoiceComputationmediumweak · medium · strong—Slowdown sensitivity: weak (more signals), medium or strong (fewer, more pronounced signals).
timeframeintegerComputation601 · 5 · 10 · 15 · 30 · 60 · 120 · 180 · 300 · 600 · 900 · 1800 · 3600 · 7200 · 10800 · 14400 · 86400secondsBar 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.

FieldUnitHow to read it
drawing.bartimestamp (ns) · stringStart of the anchor bar: the reference of start and end.
drawing.startbars · numberOffset from bar, in timeframe-second bars, to a tenth; can be negative. Time: bar + start × timeframe × 10⁹.
drawing.endbars · numberOffset 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>.

FieldTypeUnitPresentDescription
kindstring · acceleration | exhaustion | slowdown | control | extreme—alwaysType: acceleration (rectangle), exhaustion and slowdown (triangles), control and extreme (lines). It is also the first segment of the id.
activeboolean—sometimesRectangle or line still extended to the right.
barstringtimestamp (ns)alwaysStart of the anchor bar.
endnumberbarssometimesEnd 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.
highintegertickssometimesTop of a rectangle.
labelstring · AC | PC | AE | PE—sometimesLine: 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.
lowintegertickssometimesBottom of a rectangle.
priceintegertickssometimesPrice 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.
sidestring · buy | sell—sometimesLine: the side that dominated the consolidation, buy (buyers) or sell (sellers).
startnumberbarsalwaysStart 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).
upboolean—alwaysBullish 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.
variantinteger—sometimesExhaustion: 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.
visibleboolean—alwaysfalse: 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.

Final object
{
  "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
  }
}
Object in progress
{
  "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
  }
}
Object in progress
{
  "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"
  }
}
Object in progress
{
  "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"
  }
}
Final object
{
  "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
  }
}
Final object
{
  "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
JSON
{
  "$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
JSON
{
  "$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"
  ]
}