Fathom Zones
Directional effort zones on range bars, with an EMA of the closes.
At a glance
- Identifier
effort-zones- 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.
rangeTickssets 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
rangeTicksticks: each bar spans at mostrangeTicksticks 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 fromlowtohigh; both can be a half tick. - The zone’s
startis the index of the bar that created it: the rectangle begins after the move it marks.startandendare range bar indices, not timestamps: draw the zone from thestarttimestamp of barbar:<weekSunday>:<start>up to but not including barend. - The three object kinds have no field telling them apart in
data: read theidprefix (bar:,ema:,zone:).<weekSunday>is theYYYY-MM-DDdate of the week’s Sunday reopen; the index of a bar or an EMA value is the last segment of itsid.
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 itsend) 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
emawithout itsbar). 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 theirend), 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.
{
"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.
| Parameter | Type | Role | Default | Allowed values | Unit | Description |
|---|---|---|---|---|---|---|
rangeTicks | integer | Computation | 40 · CL 14 · ES 7 · GC 26 · HG 4 · NQ 74 · RTY 10 · SI 16 · YM 15 | 4 to 400 | ticks | Size 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.
| Field | Unit | How to read it |
|---|---|---|
bar.id | string · bar:<weekSunday>:<index> | <index> is the range bar’s position in the week, from 0: the unit of the zones’ start and end. |
bar.start | timestamp (ns) · string | Time of the range bar’s first trade: where to draw the bar, and the zones that start or end on it. |
zone.start | bars · integer | Index of the range bar that created the zone, not a timestamp: read the start of that bar to place it in time. |
zone.end | bars · integer | Index 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>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
close | integer | ticks | always | Close. |
high | integer | ticks | always | High. |
low | integer | ticks | always | Low. |
open | integer | ticks | always | Open. |
start | string | timestamp (ns) | always | 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. |
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>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
value | number | ticks | always | EMA 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>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
active | boolean | — | always | true while the zone is extended; false once it is final. |
end | integer | bars | sometimes | 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. |
high | number | ticks | always | Top of the zone; can be a half tick. |
low | number | ticks | always | Bottom of the zone; can be a half tick. |
side | string · buy | sell | — | always | Direction of the move that left the zone: buy for a buying move, sell for a selling move. |
start | integer | bars | always | Index 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.
{
"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
}
}{
"sub": "effort-zones",
"cursor": "20720.13.1",
"t": "upsert",
"id": "ema:2026-09-20:902",
"final": true,
"ts": "1790208003437668629",
"data": {
"value": 123080.58563442338
}
}{
"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
}
}{
"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
{
"$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
{
"$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"
]
}
]
}