Fathom Opening
Opening range of the regular session, breakout zones and price projections.
At a glance
- Identifier
opening-range- Objects received
range,zone,projection,statistics- Historical cost
- 1 compute unit per trade
What the indicator shows
- ORH and ORL: the high and low of the first
openingMinutesminutes after the product’s regular open, New York time: 09:30 for NQ, ES, RTY and YM, 09:00 for CL and NG, 08:20 for GC, ZB and ZN, 08:25 for SI and 08:10 for HG. ORM: their midpoint. - After a breakout: pullback zones in the breakout direction, and three price projections:
Protection,Ext. 1andExt. 2.
How to use it
- The breakout often sets the tone for the day: follow its direction until the breakout is cancelled, which removes its projections.
- The projections are targets for the breakout:
Protectiona first, conservative one,Ext. 1andExt. 2two farther ones. Targets, not guarantees. - Zones left in the breakout direction are pullback zones if price comes back to them.
- 60 minutes is the Initial Balance; a shorter duration gives a tighter frame, set earlier.
How to read and draw it
- The range is tracked trade by trade from the regular open to the regular open +
openingMinutes:high(ORH),low(ORL) and their midpoint ORM = (high + low) / 2. - From the end of the range until the session close (17:00 New York time), a
timeframe-second bar closing beyond the range sets the breakout direction. If price comes back far enough into the range, the breakout is cancelled: its projections are removed. - Zones (
zones): pullback zones left in the breakout direction, published when the bar that leaves them closes. - Projections (
projections): three price targets beyond the range, in the breakout direction, rounded to the tick. They follow the breakout as the session unfolds:Protection, a first, conservative target, for a breakout that does not go far;Ext. 1andExt. 2, two extension targets,Ext. 2the farther one. Draw each as a horizontal line atpriceuntil it is removed. - Real time and history give the same projections, and every contract of a product gets the same ones.
- The four object kinds are told apart by their
idprefix (range:,zone:,proj:,statistics:);<session>is the session’sYYYY-MM-DDclosing date.
When it updates
- The range is sent in progress while it forms, then final; it is removed at the next session.
- A zone is sent in progress when the bar that creates it closes, then final when price closes through it, or at the end of the session: that final version arrives at the 18:00 reopen. Zones are never removed: final zones of previous sessions can still appear in a snapshot.
- The projections and the
statisticsobject stay in progress: they are sent again withfinal: falseon every change, then removed (remove) when the breakout is cancelled or at the next session; they never have afinal: trueversion. Inconfirmedmode they never arrive: only theirremovedoes (ignore it). - When no projections are available for a session, its
statistics:<session>object reportsSTATISTICS_UNAVAILABLEinstead. - Reset at every session open (18:00 New York time): the previous session’s range and projections are removed, and its zones still in progress are ended.
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": "opening-range",
"instrument": "NQ.front",
"indicator": "opening-range",
"params": {
"extendBars": 10,
"openingMinutes": 60,
"projections": true,
"timeframe": 300,
"zones": true
},
"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 |
|---|---|---|---|---|---|---|
extendBars | integer | Computation | 10 | 1 to 500 | bars | Initial zone length, in bars; a zone stays active beyond it, until price closes through it or until the next session. |
openingMinutes | integer | Computation | 60 | 1 to 240 | minutes | Length of the opening range from the product’s regular open, in minutes (60 = Initial Balance). |
projections | boolean | Computation | true | true · false | — | Publish price projections after the range breakout. |
timeframe | integer | Computation | 300 | 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. |
zones | boolean | Computation | true | true · false | — | Publish pullback zones in the direction of the range breakout. |
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 |
|---|---|---|
range.bar | timestamp (ns) · string | Start of the bar where the range began. |
zone.bar | timestamp (ns) · string | Start of the bar that created the zone: the reference of start and end. |
zone.start | bars · number | Offset from bar, in timeframe-second bars: always -0.4. |
zone.end | bars · number | Offset from bar, in the same unit: start + extendBars while the zone is active, then where the final zone stops. |
projection.id | string · proj:<session>:<protection|ext-1|ext-2> | No timestamp: <session> is the session’s closing date. A projection is a price for the rest of that session. |
range sent in progress
Range; in progress while it forms, final afterwards, removed at the next session.
id format: range:<session>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
bar | string | timestamp (ns) | always | Start of the bar where the range began. |
high | integer | ticks | always | High (ORH). |
low | integer | ticks | always | Low (ORL); midpoint ORM = (high + low) / 2. |
zone sent in progress
Zone; in progress while it is active.
id format: zone:<session>:<ordinal>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
active | boolean | — | always | true while the zone holds; false once it is final. |
bar | string | timestamp (ns) | always | Start of the bar that created the zone. |
end | number | bars | always | End of the zone, in the same unit as start: start + extendBars while the zone is active (a drawing length, not an expiry), then the index of the bar that closed through it, or, at the end of the session, the index of its last bar. |
high | integer | ticks | always | Top of the zone. |
low | integer | ticks | always | Bottom of the zone. |
side | string · buy | sell | — | always | Direction of the range breakout. |
start | number | bars | always | Start of the zone, in timeframe-second bars relative to bar (0 = start of bar): always -0.4: the zone is drawn starting 0.4 bar before the bar that created it. 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). |
projection sent in progress
Session projection; its price follows the breakout direction and can change as the breakout unfolds. Never final: sent again with final: false on every change, then removed when the breakout is cancelled or at the next session.
id format: proj:<session>:<protection|ext-1|ext-2>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
label | string · Protection | Ext. 1 | Ext. 2 | — | always | Protection: a first, conservative target, for a breakout that does not go far; Ext. 1 and Ext. 2: two extension targets, Ext. 2 the farther one. Compare these labels exactly, or read the last segment of the id: protection, ext-1 and ext-2. |
price | integer | ticks | always | Projected price. |
statistics sent in progress
Reports that no projections are available for the session. Never final: removed at the next session.
id format: statistics:<session>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
status | string · STATISTICS_UNAVAILABLE | — | always | Always STATISTICS_UNAVAILABLE: projections are requested, but none are available for this session. |
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": "opening-range",
"cursor": "20725.90491.0",
"t": "upsert",
"id": "range:2026-09-29",
"final": false,
"ts": "1790688600000013873",
"data": {
"bar": "1790688600000000000",
"high": 122835,
"low": 122835
}
}{
"sub": "opening-range",
"cursor": "20725.184477.0",
"t": "upsert",
"id": "range:2026-09-29",
"final": true,
"ts": "1790692200001343757",
"data": {
"bar": "1790688600000000000",
"high": 122902,
"low": 122182
}
}{
"sub": "opening-range",
"cursor": "20725.282679.0",
"t": "upsert",
"id": "proj:2026-09-29:protection",
"final": false,
"ts": "1790700300027064573",
"data": {
"label": "Protection",
"price": 121941
}
}{
"sub": "opening-range",
"cursor": "20725.314433.0",
"t": "upsert",
"id": "zone:2026-09-29:0",
"final": false,
"ts": "1790704500048856567",
"data": {
"side": "sell",
"high": 122157,
"low": 122155,
"active": true,
"bar": "1790704200000000000",
"start": -0.4,
"end": 9.6
}
}{
"sub": "opening-range",
"cursor": "20725.324561.0",
"t": "upsert",
"id": "zone:2026-09-29:0",
"final": true,
"ts": "1790705100158348217",
"data": {
"side": "sell",
"high": 122157,
"low": 122155,
"active": false,
"bar": "1790704200000000000",
"start": -0.4,
"end": 2
}
}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/opening-range/params.json",
"type": "object",
"additionalProperties": false,
"properties": {
"extendBars": {
"description": "Initial zone length, in bars; a zone stays active beyond it, until price closes through it or until the next session.",
"type": "integer",
"default": 10,
"minimum": 1,
"maximum": 500
},
"openingMinutes": {
"description": "Length of the opening range from the product’s regular open, in minutes (60 = Initial Balance).",
"type": "integer",
"default": 60,
"minimum": 1,
"maximum": 240
},
"projections": {
"description": "Publish price projections after the range breakout.",
"type": "boolean",
"default": true
},
"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": 300,
"enum": [
1,
5,
10,
15,
30,
60,
120,
180,
300,
600,
900,
1800,
3600,
7200,
10800,
14400,
86400
]
},
"zones": {
"description": "Publish pullback zones in the direction of the range breakout.",
"type": "boolean",
"default": true
}
}
}data field schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://fathomcharts.com/schemas/opening-range/data.json",
"anyOf": [
{
"title": "range",
"type": "object",
"additionalProperties": false,
"properties": {
"bar": {
"description": "Start of the bar where the range began.",
"type": "string",
"pattern": "^[0-9]+$"
},
"high": {
"description": "High (ORH).",
"type": "integer"
},
"low": {
"description": "Low (ORL); midpoint ORM = (high + low) / 2.",
"type": "integer"
}
},
"required": [
"bar",
"high",
"low"
]
},
{
"title": "zone",
"type": "object",
"additionalProperties": false,
"properties": {
"active": {
"description": "`true` while the zone holds; `false` once it is final.",
"type": "boolean"
},
"bar": {
"description": "Start of the bar that created the zone.",
"type": "string",
"pattern": "^[0-9]+$"
},
"end": {
"description": "End of the zone, in the same unit as `start`: `start` + `extendBars` while the zone is active (a drawing length, not an expiry), then the index of the bar that closed through it, or, at the end of the session, the index of its last bar.",
"type": "number"
},
"high": {
"description": "Top of the zone.",
"type": "integer"
},
"low": {
"description": "Bottom of the zone.",
"type": "integer"
},
"side": {
"description": "Direction of the range breakout.",
"type": "string",
"enum": [
"buy",
"sell"
]
},
"start": {
"description": "Start of the zone, in `timeframe`-second bars relative to `bar` (0 = start of `bar`): always `-0.4`: the zone is drawn starting 0.4 bar before the bar that created it. 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"
}
},
"required": [
"side",
"high",
"low",
"active",
"bar",
"start",
"end"
]
},
{
"title": "projection",
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"description": "`Protection`: a first, conservative target, for a breakout that does not go far; `Ext. 1` and `Ext. 2`: two extension targets, `Ext. 2` the farther one. Compare these labels exactly, or read the last segment of the `id`: `protection`, `ext-1` and `ext-2`.",
"type": "string",
"enum": [
"Protection",
"Ext. 1",
"Ext. 2"
]
},
"price": {
"description": "Projected price.",
"type": "integer"
}
},
"required": [
"label",
"price"
]
},
{
"title": "statistics",
"type": "object",
"additionalProperties": false,
"properties": {
"status": {
"description": "Always `STATISTICS_UNAVAILABLE`: projections are requested, but none are available for this session.",
"const": "STATISTICS_UNAVAILABLE"
}
},
"required": [
"status"
]
}
]
}