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: barto separate each bar’s value area. The chart defaults toscope: 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, whoseidis 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.
{
"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.
| Parameter | Type | Role | Default | Allowed values | Unit | Description |
|---|---|---|---|---|---|---|
scope | choice | Computation | session | session · 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. |
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. |
valueAreaPercent | integer | Computation | 70 | 1 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.
| Field | Unit | How to read it |
|---|---|---|
values.id | string · <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>.
| Field | Type | Unit | Present | Description |
|---|---|---|---|---|
poc | integer | ticks | always | POC of the profile (the session’s up to this bar, or this bar’s alone, per scope). |
sd | number | ticks | always | 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). |
vah | integer | ticks | always | Value area high (VAH). |
val | integer | ticks | always | Value area low (VAL). |
vwap | number | ticks | always | VWAP 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.
{
"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
{
"$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
{
"$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"
]
}