Indicator

Fathom Profile

POC, value area, VWAP and standard deviation of the session or of each bar.

At a glance

Identifier
session-profile
Objects received
values
Historical cost
1 compute unit per trade

What the indicator shows

  • POC: the most traded price.
  • Value area (VAH / VAL): the range around the POC holding valueAreaPercent% of volume, 70% with the generic defaults.
  • VWAP and standard deviation: the volume-weighted average price, and how spread out prices are around it.
  • The chart draws POC, VAH, VAL and VWAP as steps, with the value area shaded. Profile publishes these values, not a volume-by-price histogram.
  • The illustration uses scope: bar to separate each bar’s value area. The chart defaults to scope: session, which accumulates the session’s volume.

How to use it

  • Inside the value area, the market accepts price; outside it, the market rejects it or looks for a new balance.
  • With scope: session, follow the POC as it migrates: it shows which way the market is building value.
  • With scope: bar, see where each bar traded.

How it is computed

  • scope: "session" measures the session’s profile, accumulated from the open up to this bar, to follow how the session’s values shift; scope: "bar" measures each bar’s profile alone, to see where each bar traded.
  • The POC is the highest-volume price. On a tie within a bar, the footprint rule applies: the lowest of the tied prices at or above the open, otherwise the highest of those below it. With scope: "session", each closed bar adds its volume price by price, in that same order (from its open up to its high, then down from below the open to its low): a price becomes the POC as soon as its session volume strictly exceeds the POC’s. On a tie, the first price to reach that volume keeps the POC; it can be a price traded in this bar rather than the previous POC.
  • The value area is built tick by tick from the POC: at each step, it extends to the busier neighbouring price, above or below, downward on a tie (a price with no volume counts as 0), until it holds at least valueAreaPercent% of the volume. It never goes beyond the profile’s lowest and highest prices, and always takes at least one step, even when the POC alone holds enough volume.
  • The standard deviation is the volume-weighted standard deviation of prices, with a Bessel correction on volume: √(Σ v·(p − VWAP)² / (V − 1)), where V is the profile’s total volume.

When it updates

  • One final point per finished timeframe-second bar, sent when it closes, whose id is the start of the bar. The values hold at the bar’s end but are placed at its start: draw them as steps (each value from its bar’s start to the next one), not as a line through the bar starts.
  • Reset at every session open, at 18:00 New York time (full session, not only the RTH session). The computation, and the replay over history, begin at the start of the trading week (origin: week); the week’s last bar gets its values on the first trade of the Sunday reopen.

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": "session-profile",
  "instrument": "NQ.front",
  "indicator": "session-profile",
  "params": {
    "scope": "session",
    "timeframe": 300,
    "valueAreaPercent": 70
  },
  "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
scopechoiceComputationsessionsession · bar—Which volume profile is measured: the session’s, accumulated from the open up to this bar (session), or this bar’s alone (bar). Each value is a separate stream: open two subscriptions to get both.
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.
valueAreaPercentintegerComputation701 to 100%Share of the volume contained in the value area.

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
values.idstring · <barStartNs>Start of the bar; the values hold at its close. Draw them as steps, each value from its bar’s start to the next one.

values sent final

Values at the close of the bar.

id format: <barStartNs>.

FieldTypeUnitPresentDescription
pocintegerticksalwaysPOC of the profile (the session’s up to this bar, or this bar’s alone, per scope).
sdnumberticksalwaysVolume-weighted standard deviation of prices, with a Bessel correction on volume (√(Σ v·(p − VWAP)² / (V − 1)), V = total volume), to draw bands around the VWAP (vwap ± n × sd).
vahintegerticksalwaysValue area high (VAH).
valintegerticksalwaysValue area low (VAL).
vwapnumberticksalwaysVWAP of the profile (session or bar, per scope).

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": "session-profile",
  "cursor": "20720.0.0",
  "t": "upsert",
  "id": "1790207700000000000",
  "final": true,
  "ts": "1790208000058746563",
  "data": {
    "poc": 123076,
    "vah": 123177,
    "val": 122990,
    "vwap": 123131.51652638057,
    "sd": 63.49728844602092
  }
}

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/session-profile/params.json",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "scope": {
      "description": "Which volume profile is measured: the session’s, accumulated from the open up to this bar (`session`), or this bar’s alone (`bar`). Each value is a separate stream: open two subscriptions to get both.",
      "type": "string",
      "default": "session",
      "enum": [
        "session",
        "bar"
      ]
    },
    "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
      ]
    },
    "valueAreaPercent": {
      "description": "Share of the volume contained in the value area.",
      "type": "integer",
      "default": 70,
      "minimum": 1,
      "maximum": 100
    }
  }
}
data field schema
JSON
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://fathomcharts.com/schemas/session-profile/data.json",
  "title": "values",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "poc": {
      "description": "POC of the profile (the session’s up to this bar, or this bar’s alone, per `scope`).",
      "type": "integer"
    },
    "sd": {
      "description": "Volume-weighted standard deviation of prices, with a Bessel correction on volume (√(Σ v·(p − VWAP)² / (V − 1)), V = total volume), to draw bands around the VWAP (`vwap` ± n × `sd`).",
      "type": "number"
    },
    "vah": {
      "description": "Value area high (VAH).",
      "type": "integer"
    },
    "val": {
      "description": "Value area low (VAL).",
      "type": "integer"
    },
    "vwap": {
      "description": "VWAP of the profile (session or bar, per `scope`).",
      "type": "number"
    }
  },
  "required": [
    "poc",
    "vah",
    "val",
    "vwap",
    "sd"
  ]
}