Get Value
Get Value reads a named channel from any upstream node and exposes it as a standalone series. It auto-discovers all available numeric channels and supports an offset to retrieve historical values — with optional null-skipping for sparse series.
How It Works
- 1
Scans the upstream node's resultData and builds a list of all numeric array channels (open, high, low, close, volume from OHLCVT sources, or any named number array).
- 2
Selects the active channel (defaults to the first available). You can change it in the node's property panel.
- 3
Applies the offset: value = channel[len − 1 − offset]. With skipNulls=true, the offset counts only non-null elements (useful for sparse indicator outputs).
- 4
The per-bar series (values/timestamps) is a shifted copy of the channel: values[i] = channel[i − offset]. This lets downstream nodes plot and compare lagged data.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
| channel | string | '' (auto) | Name of the data channel to read. Defaults to the first available channel. OHLCVT names: 'open', 'high', 'low', 'close', 'volume'. |
| offset | number | 0 | Number of bars back from the most recent bar. 0 = current bar, 1 = previous bar. |
| skipNulls | boolean | false | When true, offset counts only non-null values. Useful for reading the Nth most recent valid result from a sparse indicator. |
Inputs & Outputs
| Port | Type | Description |
|---|---|---|
| Input | ||
| input | any node | Any upstream node with resultData containing numeric arrays or OHLCVT data. |
| Outputs | ||
| value | number | null | Scalar: the channel value at the requested offset from the end of the series. |
| values | (number | null)[] | Full windowed series: values[i] = channel[i − offset]. Nulls fill positions where i − offset < 0. |
| timestamps | number[] | Current-bar timestamps (not the source bar timestamps), preserving alignment. |
| channel | string | The active channel name (mirrored for display). |
| availableChannels | string[] | All discovered numeric channel names for the property panel dropdown. |
| markerTimestamp | number | null | Timestamp of the source bar at the offset position — useful for placing chart markers at the referenced bar. |
Use Cases
Scalar display in the UI
Attach Get Value to any indicator node and set offset = 0 to display the current bar's value as a numeric readout in a dashboard widget, without needing to plot the full series.
Lagged comparison
Use two Get Value nodes on the same indicator with offset = 0 and offset = 1, then subtract them in a Math Subtract node. This gives the bar-over-bar change without a custom Shift node.
Channel selection for multi-output indicators
Indicators like Bollinger Bands expose multiple channels (upper, middle, lower). Use one Get Value per channel to route each band independently to different downstream nodes.