On-Balance Volume (OBV)
Popularized by Joseph Granville, On-balance Volume is a rolling accumulation of volume based on Close price direction. [Discuss] 💬
// C# usage syntax
IReadOnlyList<ObvResult> results =
bars.ToObv();Historical price bars requirements
You must have at least two historical price bars to cover the warmup periods; however, since this is a trendline, more is recommended.
bars is a collection of generic TBar historical price bars. It should have a consistent frequency (day, hour, minute, etc). See the Guide for more information.
Response
IReadOnlyList<ObvResult>- This method returns a time series of all available indicator values for the
barsprovided. - It always returns the same number of elements as there are in the historical price bars.
- It does not return a single incremental indicator value.
- The first period OBV will have a
0value since there's not enough data to calculate.
ObvResult
| property | description |
|---|---|
TimestampDateTime | Date from evaluated TBar |
Obvdouble | On-balance Volume |
🚩 Relative values only
Absolute values in OBV are somewhat meaningless. Use with caution.
Utilities
See Utilities and helpers for more information.
Chaining
Results can be further processed on Obv with additional chain-enabled indicators.
// example
var results = bars
.ToObv(..)
.ToRsi(..);This indicator must be generated from bars and cannot be generated from results of another chain-enabled indicator or method.
See Chaining indicators for more.
Streaming
Use the buffer-style List<T> when you need incremental calculations without a hub:
ObvList obvList = new();
// call from your WebSocket or SSE message handler
void OnBarReceived(IBar bar) => obvList.Add(bar);
// based on `ICollection<ObvResult>`; fills as the handler runs
IReadOnlyList<ObvResult> results = obvList;Subscribe to a BarHub for advanced streaming scenarios:
BarHub barHub = new();
ObvHub observer = barHub.ToObvHub();
// call from your WebSocket or SSE message handler
void OnBarReceived(IBar bar) => barHub.Add(bar);
// results fill as the handler runs
IReadOnlyList<ObvResult> results = observer.Results;See Buffer lists and Stream hubs for full usage guides.