Indicator

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 openingMinutes minutes 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. 1 and Ext. 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: Protection a first, conservative one, Ext. 1 and Ext. 2 two 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. 1 and Ext. 2, two extension targets, Ext. 2 the farther one. Draw each as a horizontal line at price until 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 id prefix (range:, zone:, proj:, statistics:); <session> is the session’s YYYY-MM-DD closing 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 statistics object stay in progress: they are sent again with final: false on every change, then removed (remove) when the breakout is cancelled or at the next session; they never have a final: true version. In confirmed mode they never arrive: only their remove does (ignore it).
  • When no projections are available for a session, its statistics:<session> object reports STATISTICS_UNAVAILABLE instead.
  • 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.

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

ParameterTypeRoleDefaultAllowed valuesUnitDescription
extendBarsintegerComputation101 to 500barsInitial zone length, in bars; a zone stays active beyond it, until price closes through it or until the next session.
openingMinutesintegerComputation601 to 240minutesLength of the opening range from the product’s regular open, in minutes (60 = Initial Balance).
projectionsbooleanComputationtruetrue · false—Publish price projections after the range breakout.
timeframeintegerComputation3001 · 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.
zonesbooleanComputationtruetrue · 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.

FieldUnitHow to read it
range.bartimestamp (ns) · stringStart of the bar where the range began.
zone.bartimestamp (ns) · stringStart of the bar that created the zone: the reference of start and end.
zone.startbars · numberOffset from bar, in timeframe-second bars: always -0.4.
zone.endbars · numberOffset from bar, in the same unit: start + extendBars while the zone is active, then where the final zone stops.
projection.idstring · 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>.

FieldTypeUnitPresentDescription
barstringtimestamp (ns)alwaysStart of the bar where the range began.
highintegerticksalwaysHigh (ORH).
lowintegerticksalwaysLow (ORL); midpoint ORM = (high + low) / 2.

zone sent in progress

Zone; in progress while it is active.

id format: zone:<session>:<ordinal>.

FieldTypeUnitPresentDescription
activeboolean—alwaystrue while the zone holds; false once it is final.
barstringtimestamp (ns)alwaysStart of the bar that created the zone.
endnumberbarsalwaysEnd 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.
highintegerticksalwaysTop of the zone.
lowintegerticksalwaysBottom of the zone.
sidestring · buy | sell—alwaysDirection of the range breakout.
startnumberbarsalwaysStart 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>.

FieldTypeUnitPresentDescription
labelstring · Protection | Ext. 1 | Ext. 2—alwaysProtection: 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.
priceintegerticksalwaysProjected 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>.

FieldTypeUnitPresentDescription
statusstring · STATISTICS_UNAVAILABLE—alwaysAlways 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.

Object in progress
{
  "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
  }
}
Final object
{
  "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
  }
}
Object in progress
{
  "sub": "opening-range",
  "cursor": "20725.282679.0",
  "t": "upsert",
  "id": "proj:2026-09-29:protection",
  "final": false,
  "ts": "1790700300027064573",
  "data": {
    "label": "Protection",
    "price": 121941
  }
}
Object in progress
{
  "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
  }
}
Final object
{
  "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
JSON
{
  "$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
JSON
{
  "$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"
      ]
    }
  ]
}