Indicator

Fathom Zones

Directional effort zones on range bars, with an EMA of the closes.

At a glance

Identifier
effort-zones
Objects received
bar, ema, zone
Historical cost
1 compute unit per trade

What the indicator shows

  • A buy zone marks a move where buyers pushed price up with conviction; a sell zone, one where sellers pushed it down. On the Fathom chart, buy zones are blue and sell zones coral.
  • The range bars and the EMA of their closes are published with the zones, to put them in the context of the trend.

How to use it

  • When price comes back into a zone, watch how it reacts: a buy zone often acts as support, a sell zone as resistance.
  • Place the zone against the EMA: a buy zone above the EMA goes with the trend, and so does a sell zone below it.
  • A zone ends when price closes through it: the level did not hold.
  • rangeTicks sets the size of the range bars: larger bars give fewer bars per session, smaller ones a finer reading.

How to read and draw it

  • Range bars of rangeTicks ticks: each bar spans at most rangeTicks ticks from its low to its high. A new bar also opens at every session open (18:00 New York time). Bars are numbered from 0 from the start of the week.
  • A zone is left by a strong directional move: a buy (buy) zone by a buying move, a sell (sell) zone by a selling one. Draw it as a rectangle from low to high; both can be a half tick.
  • The zone’s start is the index of the bar that created it: the rectangle begins after the move it marks. start and end are range bar indices, not timestamps: draw the zone from the start timestamp of bar bar:<weekSunday>:<start> up to but not including bar end.
  • The three object kinds have no field telling them apart in data: read the id prefix (bar:, ema:, zone:). <weekSunday> is the YYYY-MM-DD date of the week’s Sunday reopen; the index of a bar or an EMA value is the last segment of its id.

When it updates

  • Each range bar is sent once, final, when it closes, with its EMA value once the EMA has started (after the first bars of the week).
  • A zone is sent in progress as soon as it is created, then final (active: false, with its end) on the first of these events: price closes through it (below its bottom for a buy zone, above its top for a sell zone), it reaches its maximum length, or a new session opens (18:00 New York time). A zone can end on the very bar that creates it.
  • The snapshot keeps the last 32 final objects of all kinds together: the more numerous bars and EMA values can leave no room for any final zone, the bars of an older active zone may be missing, and the limit can split a bar from its EMA value (an ema without its bar). To place every zone, start before them (from: { time }, or a history query).
  • Weekly reset: on the first trade of the Sunday reopen (18:00 New York time), the week’s last bar is sent, zones still in progress are sent final (active: false, with their end), then bars, indices and the EMA start over; nothing carries over to the new week.

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": "effort-zones",
  "instrument": "NQ.front",
  "indicator": "effort-zones",
  "params": {
    "rangeTicks": 74
  },
  "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.

The Default column gives the generic default, used by the tickers without a default of their own, then each ticker that has its own value, such as CL 14. Ticker defaults 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
rangeTicksintegerComputation40 · CL 14 · ES 7 · GC 26 · HG 4 · NQ 74 · RTY 10 · SI 16 · YM 154 to 400ticksSize of the range bars, in ticks.

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
bar.idstring · bar:<weekSunday>:<index><index> is the range bar’s position in the week, from 0: the unit of the zones’ start and end.
bar.starttimestamp (ns) · stringTime of the range bar’s first trade: where to draw the bar, and the zones that start or end on it.
zone.startbars · integerIndex of the range bar that created the zone, not a timestamp: read the start of that bar to place it in time.
zone.endbars · integerIndex of the first range bar after the zone: draw up to, not including, that bar. Absent while the zone is active.

bar sent final

Finished range bar. <weekSunday>: YYYY-MM-DD date of the week’s Sunday reopen; <index>: number of the bar from the start of the week (0, 1, 2…), read from the id (data has no index field).

id format: bar:<weekSunday>:<index>.

FieldTypeUnitPresentDescription
closeintegerticksalwaysClose.
highintegerticksalwaysHigh.
lowintegerticksalwaysLow.
openintegerticksalwaysOpen.
startstringtimestamp (ns)alwaysTimestamp of the bar’s first trade. To place a zone in time, read the start of the bar whose index equals the zone’s start (or end); the bar of the end is only published when it closes.

ema sent final

EMA value at the close of bar <index> (the same index as in that bar’s id).

id format: ema:<weekSunday>:<index>.

FieldTypeUnitPresentDescription
valuenumberticksalwaysEMA of the closes, at the close of bar <index>. No ema object exists for the first bars of the week.

zone sent in progress

Zone; in progress while it is active. <startIndex> is its start.

id format: zone:<weekSunday>:<startIndex>.

FieldTypeUnitPresentDescription
activeboolean—alwaystrue while the zone is extended; false once it is final.
endintegerbarssometimesIndex of the first range bar after the zone (not a timestamp): draw the zone up to but not including bar end. That bar is only published when it closes; at the end of the week, end is the index that would follow the week’s last bar, which no bar carries. Absent while the zone is active.
highnumberticksalwaysTop of the zone; can be a half tick.
lownumberticksalwaysBottom of the zone; can be a half tick.
sidestring · buy | sell—alwaysDirection of the move that left the zone: buy for a buying move, sell for a selling move.
startintegerbarsalwaysIndex of the range bar that created the zone, counted from the start of the week like the index of bar ids (not a timestamp).

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": "effort-zones",
  "cursor": "20720.13.0",
  "t": "upsert",
  "id": "bar:2026-09-20:902",
  "final": true,
  "ts": "1790208003437668629",
  "data": {
    "start": "1790207538998759005",
    "open": 123060,
    "high": 123083,
    "low": 123010,
    "close": 123010
  }
}
Final object
{
  "sub": "effort-zones",
  "cursor": "20720.13.1",
  "t": "upsert",
  "id": "ema:2026-09-20:902",
  "final": true,
  "ts": "1790208003437668629",
  "data": {
    "value": 123080.58563442338
  }
}
Object in progress
{
  "sub": "effort-zones",
  "cursor": "20720.139771.2",
  "t": "upsert",
  "id": "zone:2026-09-20:1161",
  "final": false,
  "ts": "1790257346870977547",
  "data": {
    "side": "sell",
    "high": 122388,
    "low": 122322,
    "active": true,
    "start": 1161
  }
}
Final object
{
  "sub": "effort-zones",
  "cursor": "20720.145758.2",
  "t": "upsert",
  "id": "zone:2026-09-20:1161",
  "final": true,
  "ts": "1790257597237211485",
  "data": {
    "side": "sell",
    "high": 122388,
    "low": 122322,
    "active": false,
    "start": 1161,
    "end": 1168
  }
}

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/effort-zones/params.json",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "rangeTicks": {
      "description": "Size of the range bars, in ticks.",
      "type": "integer",
      "default": 40,
      "minimum": 4,
      "maximum": 400
    }
  }
}
data field schema
JSON
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://fathomcharts.com/schemas/effort-zones/data.json",
  "anyOf": [
    {
      "title": "bar",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "close": {
          "description": "Close.",
          "type": "integer"
        },
        "high": {
          "description": "High.",
          "type": "integer"
        },
        "low": {
          "description": "Low.",
          "type": "integer"
        },
        "open": {
          "description": "Open.",
          "type": "integer"
        },
        "start": {
          "description": "Timestamp of the bar’s first trade. To place a zone in time, read the `start` of the bar whose index equals the zone’s `start` (or `end`); the bar of the `end` is only published when it closes.",
          "type": "string",
          "pattern": "^[0-9]+$"
        }
      },
      "required": [
        "start",
        "open",
        "high",
        "low",
        "close"
      ]
    },
    {
      "title": "ema",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "value": {
          "description": "EMA of the closes, at the close of bar `<index>`. No `ema` object exists for the first bars of the week.",
          "type": "number"
        }
      },
      "required": [
        "value"
      ]
    },
    {
      "title": "zone",
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "active": {
          "description": "`true` while the zone is extended; `false` once it is final.",
          "type": "boolean"
        },
        "end": {
          "description": "Index of the first range bar after the zone (not a timestamp): draw the zone up to but not including bar `end`. That bar is only published when it closes; at the end of the week, `end` is the index that would follow the week’s last bar, which no bar carries. Absent while the zone is active.",
          "type": "integer"
        },
        "high": {
          "description": "Top of the zone; can be a half tick.",
          "type": "number"
        },
        "low": {
          "description": "Bottom of the zone; can be a half tick.",
          "type": "number"
        },
        "side": {
          "description": "Direction of the move that left the zone: `buy` for a buying move, `sell` for a selling move.",
          "type": "string",
          "enum": [
            "buy",
            "sell"
          ]
        },
        "start": {
          "description": "Index of the range bar that created the zone, counted from the start of the week like the index of bar `id`s (not a timestamp).",
          "type": "integer"
        }
      },
      "required": [
        "side",
        "high",
        "low",
        "active",
        "start"
      ]
    }
  ]
}