KEGEL 1.618 Fibonacci & Sequential Suite v5Auto Fib levels based off market structure shifts / 1.618 is always the key level / various other goodies for boys including some Wyckoff, OB, FVG's and maybe some sequential for extra spice.
Indicator
Volumenprofile
HTF Profile Projection | Rainbow MatrixGENERAL OVERVIEW
HTF Profile Projection is a live higher-timeframe X-ray. It takes the current, still-forming candle of a higher timeframe (for example the 4H or Daily candle) and projects it to the right of live price, then fills it with a horizontal profile that shows what is happening INSIDE that candle: where volume is concentrating, where buyers or sellers are dominating each price zone, and where price moved through empty space.
The goal is to let a trader read the internal structure of the higher-timeframe candle without leaving the current chart. Instead of seeing the 4H candle as a single block, you see its anatomy — the price levels that hold the most activity, the zones controlled by buyers versus sellers, and the thin gaps the candle ran through quickly. Every bar in the profile is built from real chart-bar data accumulated since the higher-timeframe candle opened, not drawn manually.
WHAT IS THE THEORY BEHIND THIS INDICATOR?
A higher-timeframe candle is a summary. A single 4H or Daily candle compresses hours of two-sided auction into one open, high, low, and close — and in doing so it hides where the volume actually traded and which side was in control at each price. Two candles with an identical body and identical range can have completely different internal structures: one built on heavy buying absorbed near the lows, the other on distribution near the highs. The standard candle cannot show that difference.
Most tools that try to surface this are built around the wrong constraint. Single-timeframe volume profiles describe the visible range, not the live higher-timeframe candle. Intrabar dissection tools that read true sub-candle data depend on functions that require additional data subscriptions and will not load on standard plans.
HTF Profile Projection takes a different route: it accumulates the chart's own bars since the higher-timeframe candle opened, and distributes each bar's activity across the price range it actually traversed. This reconstructs the internal volume and directional balance of the forming higher-timeframe candle using only standard data feeds — and projects it forward as a single, readable object.
The practical value: when price returns to a higher-timeframe candle later, the levels that mattered inside it — the high-volume node, the buyer- or seller-dominated zones, the empty imbalance gaps — are common revisit and reaction areas. Seeing them while the candle is still forming gives structural context that the candle body alone cannot.
HTF PROFILE PROJECTION FEATURES
The indicator includes these main components: a projected higher-timeframe candle, a range-spread movement profile, automatic resolution, a buy/sell dominance read, imbalance zones, a Point of Control marker, and a live info panel. Multilingual interface and full visual customization.
PROJECTED HTF CANDLE
🔹 What It Does
Reads the live, still-forming higher-timeframe candle and draws it (body + wicks) to the right of live price, color-coded by its direction. The horizontal profile attaches inside its price range.
🔹 Method
The higher-timeframe OHLCV is read via request.security() with lookahead=barmerge.lookahead_off, so no future information is used. The candle and its profile update in real time as the higher-timeframe bar forms — the intended live behavior — and reset cleanly when a new higher-timeframe period opens. If the chart timeframe is at or above the selected higher timeframe, the profile is hidden and a guard note is shown, because one chart bar covering the whole period cannot produce a meaningful internal read.
RANGE-SPREAD MOVEMENT PROFILE
🔹 What It Does
Splits the higher-timeframe candle's range into horizontal price buckets and fills each with the activity that occurred there.
🔹 Method
Since the higher-timeframe candle opened, each chart bar's volume and signed direction are accumulated, then distributed across every bucket the bar's low–high range spans — not dumped at a single midpoint. This range-spread approach makes both the per-zone volume and the per-zone buy/sell balance reflect where price actually traded inside the candle, rather than collapsing onto one level.
AUTOMATIC RESOLUTION
🔹 What It Does
The number of price buckets is chosen automatically from volatility. The higher-timeframe range is divided by the average chart-candle size (ATR), so each fraction of the profile corresponds to roughly one typical move of the chart timeframe.
🔹 Why It Matters
Calmer markets produce a finer profile; volatile markets produce a coarser one. The resolution matches the instrument and timeframe automatically, bounded between 4 and 50 buckets to keep the chart readable.
BUY/SELL DOMINANCE (DELTA MODE)
🔹 What It Does
In Delta mode (the default), each zone is colored by which side dominated: green for net buyers, red for net sellers, and gray for balanced zones where heavy two-way trade produced no clear winner. Bar length shows the magnitude of the imbalance.
🔹 Method
Each chart bar is classified by the sign of close versus open and contributes its volume as signed activity (+ for an up bar, − for a down bar). The net per zone is a direction-based proxy for buy/sell pressure, computed locally on standard data feeds — it is not exchange order-flow data, which Pine cannot access without additional subscriptions.
🔹 Volume Mode
Switching Source Metric to Volume colors the profile by a cold-to-hot intensity gradient instead, showing how much traded at each price regardless of direction.
IMBALANCE ZONES
🔹 What It Does
Price zones with little or no activity render distinctly. A contiguous run of empty buckets marks an imbalance — a price range the higher-timeframe candle moved through quickly with little participation.
🔹 Why It Matters
These gaps are not drawn as separate boxes; they emerge from the ABSENCE of activity in the profile. They are common revisit targets, since price often returns to fill ranges it previously skipped.
POINT OF CONTROL MARKER
🔹 What It Does
A horizontal marker tags the dominant bucket — the price level with the most activity (Volume mode) or the strongest net dominance (Delta mode). A label reports that level's share of the period's total.
LIVE INFO PANEL
🔹 What It Shows
A compact corner panel reports the higher timeframe in use, the percentage of the period elapsed, the Point of Control price, the number of imbalance zones, and the total higher-timeframe volume. When the chart-timeframe guard is active, the panel collapses to a single notice so the user always gets feedback.
🔹 Customization
The panel can be placed in any of the four chart corners and rendered in several font sizes. The display language is controlled by the System Language input.
HOW TO USE
This indicator is not a signal generator. It is a structural X-ray: it shows the internal anatomy of the forming higher-timeframe candle.
🔹 Setup
Set the Higher Timeframe input above your current chart timeframe (for example chart 15m, HTF 4H). The forward candle appears to the right of live price. If the chart timeframe is at or above the HTF, the profile hides and the guard note appears.
🔹 Reading Delta Mode (default)
Green zones mark prices where buyers dominated, red where sellers dominated, gray where the auction was balanced. The Point of Control marks the most decisive level inside the candle.
🔹 Reading Volume Mode
The rainbow profile shows where the most volume traded. Long bars are high-activity nodes; gaps are low-volume imbalance zones.
🔹 Tactical Reading
◇ A high-activity node is a price the higher timeframe has accepted — a common reaction level on revisit.
◇ A buyer- or seller-dominated zone shows which side controlled that price during the period.
◇ An imbalance gap is a range price ran through quickly — a frequent magnet for later revisits.
INPUTS EXPLAINED
🔹 System Language
Display language for the panel and labels. Options: English (default), Português, Español, Русский, 中文 (Chinese).
🔹 Higher Timeframe
The higher timeframe to project. Must be above the chart timeframe.
🔹 Show Forward HTF Candle
Toggle for the projected candle body and wicks.
🔹 Auto-Resolution ATR Length
Lookback for the average chart-candle size used to pick the bucket count.
🔹 Source Metric
Volume (intensity gradient) or Delta (buy/sell dominance, default).
🔹 Projection Offset / Profile Width
Position and maximum horizontal length of the profile to the right of price.
🔹 Spike Threshold / Imbalance Threshold
Controls for what counts as a high-activity node and what counts as an empty/imbalance zone.
🔹 Palette Mode
Intensity (cold-to-hot) or Bull-Bear (dominance coloring, default).
🔹 Profile Transparency / Show POC Marker
Visual styling for the profile and the Point of Control line.
🔹 Info Panel / Position / Font Size
Toggle, corner, and size for the live panel.
IMPORTANT NOTES
HTF Profile Projection works on any chart timeframe below the selected higher timeframe. It is built for liquid instruments with reliable volume data: crypto perpetual contracts, large-cap equities, futures, major forex pairs. On low-volume instruments the profile becomes less reliable.
This is a real-time tool. The forming higher-timeframe candle and its profile update intra-period by design; the profile resets when a new higher-timeframe period opens. It uses only request.security() and chart-bar accumulation, so it runs on standard data feeds without footprint() or request.security_lower_tf().
Pine Script v6. Open-source under Mozilla Public License 2.0.
UNIQUENESS
HTF Profile Projection is unique in how it unifies three reads into one object. Most higher-timeframe context tools stack separate features: a candle outline, fair-value-gap rectangles, and volume-spike markers. This indicator merges them — the forward higher-timeframe candle and its volume-by-price profile are a single object. High-activity zones appear as the profile's longest bars; imbalance zones are not drawn at all, they emerge from the absence of activity in the profile. The buy/sell dominance read is reconstructed from chart-bar direction and distributed across each bar's true price range, so it reflects where the auction was actually contested — and it does this on standard data feeds, without the order-flow subscriptions that comparable intrabar tools require. The combination of a live forward-projected candle, automatic volatility-matched resolution, range-spread accumulation, and dominance-versus-balance coloring produces a structural read that behaves differently from single-timeframe volume profiles and from static fair-value-gap tools.
Indicator
Dynamic Supports + Volume Profile (Smart Time Selector)This indicator is an "All-in-One" tool designed to simplify Market Structure and Volume analysis on higher timeframes (especially Daily charts).
Its main innovation is the **Unique Period Selector**, which automatically adjusts 5 internal parameters (tolerance, pivot sensitivity, resolution, and historical depth) with a single click.
**🛠️ MAIN FEATURES:**
1. **Automatic Engine (1-5 Years):**
* Forget about manually setting pivot lengths or "Lookback".
* Select **"1 Year"**: The script scans for fast pivots and recent volume for *Swing Trading*.
* Select **"5 Years"**: The script filters noise and shows only "Rock-Solid" structures (Historical S/R) for *Long Term Investing*.
2. **"Merged" Support & Resistance (S/R):**
* The script detects Pivot Highs/Lows.
* **Fusion Logic:** If price bounces multiple times in the same zone (within calculated tolerance), the script updates the existing line instead of drawing a new one. It extends the line and counts the touches (e.g., "S (4)" means a Support validated 4 times).
* **Clean Chart:** Avoids visual noise.
3. **Lateral Volume Profile (VP):**
* Displays volume distribution to the right of the current price.
* **Orange POC (Point of Control):** Marks the exact price level with the highest trading volume in the selected period.
**🚀 HOW TO USE (STRATEGY):**
Best used on the **Daily Timeframe (1D)**:
* **Scenario 1: Mean Reversion**
* If price moves far from the **Orange POC**, look for it to act as a magnet.
* Enter when price touches a **Green Line (Support)** that aligns with a high volume node.
* **Scenario 2: Breakout**
* If price breaks a **Red Line (Resistance)** aggressively and the volume above is thin (low volume nodes), the move tends to be fast due to lack of friction.
* **Scenario 3: Multi-Timeframe Analysis**
* Use "5 Years" to mark your long-term zones.
* Switch to "1 Year" for tactical entries.
**🎨 VISUAL SETTINGS:**
* **Green Lines:** Demand Zones (Supports).
* **Red Lines:** Supply Zones (Resistances).
* **Dotted Orange Line:** POC (Fair Value).
* **Blue Bars:** Volume Profile.
**Disclaimer / Descargo:**
This script is designed for educational and analytical purposes on the daily timeframe. Use it to identify zones of interest, not as automatic buy/sell signals.
Indicator
LibVeloLibrary "LibVelo"
This library provides a sophisticated framework for **Velocity
Profile (Flow Rate)** analysis. It measures the physical
speed of trading at specific price levels by relating volume
to the time spent at those levels.
## Core Concept: Market Velocity
Unlike Volume Profiles, which only answer "how much" traded,
Velocity Profiles answer "how fast" it traded.
It is calculated as:
`Velocity = Volume / Duration`
This metric (contracts per second) reveals hidden market
dynamics invisible to pure Volume or TPO profiles:
1. **High Velocity (Fast Flow):**
* **Aggression:** Initiative buyers/sellers hitting market
orders rapidly.
* **Liquidity Vacuum:** Price slips through a level because
order book depth is thin (low resistance).
2. **Low Velocity (Slow Flow):**
* **Absorption:** High volume but very slow price movement.
Indicates massive passive limit orders ("Icebergs").
* **Apathy:** Little volume over a long time. Lack of
interest from major participants.
## Architecture: Triple-Engine Composition
To ensure maximum performance while offering full statistical
depth for all metrics, this library utilises **object
composition** with a lazy evaluation strategy:
#### Engine A: The Master (`vpVol`)
* **Role:** Standard Volume Profile.
* **Purpose:** Maintains the "ground truth" of volume distribution,
price buckets, and ranges.
#### Engine B: The Time Container (`vpTime`)
* **Role:** specialized container for time duration (in ms).
* **Hack:** It repurposes standard volume arrays (specifically
`aBuy`) to accumulate time duration for each bucket.
#### Engine C: The Calculator (`vpVelo`)
* **Role:** Temporary scratchpad for derived metrics.
* **Purpose:** When complex statistics (like Value Area or Skewness)
are requested for **Velocity**, this engine is assembled
on-demand to leverage the full statistical power of `LibVPrf`
without rewriting complex algorithms.
---
**DISCLAIMER**
This library is provided "AS IS" and for informational and
educational purposes only. It does not constitute financial,
investment, or trading advice.
The author assumes no liability for any errors, inaccuracies,
or omissions in the code. Using this library to build
trading indicators or strategies is entirely at your own risk.
As a developer using this library, you are solely responsible
for the rigorous testing, validation, and performance of any
scripts you create based on these functions. The author shall
not be held liable for any financial losses incurred directly
or indirectly from the use of this library or any scripts
derived from it.
create(buckets, rangeUp, rangeLo, dynamic, valueArea, allot, estimator, cdfSteps, split, trendLen)
Construct a new `Velo` controller, initializing its engines.
Parameters:
buckets (int) : series int Number of price buckets ≥ 1.
rangeUp (float) : series float Upper price bound (absolute).
rangeLo (float) : series float Lower price bound (absolute).
dynamic (bool) : series bool Flag for dynamic adaption of profile ranges.
valueArea (int) : series int Percentage for Value Area (1..100).
allot (series AllotMode) : series AllotMode Allocation mode `Classic` or `PDF` (default `PDF`).
estimator (series PriceEst enum from AustrianTradingMachine/LibBrSt/1) : series PriceEst PDF model for distribution attribution (default `Uniform`).
cdfSteps (int) : series int Resolution for PDF integration (default 20).
split (series SplitMode) : series SplitMode Buy/Sell split for the master volume engine (default `Classic`).
trendLen (int) : series int Look‑back for trend factor in dynamic split (default 3).
Returns: Velo Freshly initialised velocity profile.
method clone(self)
Create a deep copy of the composite profile.
Namespace types: Velo
Parameters:
self (Velo) : Velo Profile object to copy.
Returns: Velo A completely independent clone.
method clear(self)
Reset all engines and accumulators.
Namespace types: Velo
Parameters:
self (Velo) : Velo Profile object to clear.
Returns: Velo Cleared profile (chaining).
method merge(self, srcVolBuy, srcVolSell, srcTime, srcRangeUp, srcRangeLo, srcVolCvd, srcVolCvdHi, srcVolCvdLo)
Merges external data (Volume and Time) into the current profile.
Automatically handles resizing and re-bucketing if ranges differ.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
srcVolBuy (array) : array Source Buy Volume bucket array.
srcVolSell (array) : array Source Sell Volume bucket array.
srcTime (array) : array Source Time bucket array (ms).
srcRangeUp (float) : series float Upper price bound of the source data.
srcRangeLo (float) : series float Lower price bound of the source data.
srcVolCvd (float) : series float Source Volume CVD final value.
srcVolCvdHi (float) : series float Source Volume CVD High watermark.
srcVolCvdLo (float) : series float Source Volume CVD Low watermark.
Returns: Velo `self` (chaining).
method addBar(self, offset)
Main data ingestion. Distributes Volume and Time to buckets.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
offset (int) : series int Offset of the bar to add (default 0).
Returns: Velo `self` (chaining).
method setBuckets(self, buckets)
Sets the number of buckets for the profile.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
buckets (int) : series int New number of buckets.
Returns: Velo `self` (chaining).
method setRanges(self, rangeUp, rangeLo)
Sets the price range for the profile.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
rangeUp (float) : series float New upper price bound.
rangeLo (float) : series float New lower price bound.
Returns: Velo `self` (chaining).
method setValueArea(self, va)
Set the percentage of volume/time for the Value Area.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
va (int) : series int New Value Area percentage (0..100).
Returns: Velo `self` (chaining).
method getBuckets(self)
Returns the current number of buckets in the profile.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
Returns: series int The number of buckets.
method getRanges(self)
Returns the current price range of the profile.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
Returns:
rangeUp series float The upper price bound of the profile.
rangeLo series float The lower price bound of the profile.
method getArrayBuyVol(self)
Returns the internal raw data array for **Buy Volume** directly.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
Returns: array The internal array for buy volume.
method getArraySellVol(self)
Returns the internal raw data array for **Sell Volume** directly.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
Returns: array The internal array for sell volume.
method getArrayTime(self)
Returns the internal raw data array for **Time** (in ms) directly.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
Returns: array The internal array for time duration.
method getArrayBuyVelo(self)
Returns the internal raw data array for **Buy Velocity** directly.
Automatically executes _assemble() if data is dirty.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
Returns: array The internal array for buy velocity.
method getArraySellVelo(self)
Returns the internal raw data array for **Sell Velocity** directly.
Automatically executes _assemble() if data is dirty.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
Returns: array The internal array for sell velocity.
method getBucketBuyVol(self, idx)
Returns the **Buy Volume** of a specific bucket.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
idx (int) : series int The index of the bucket.
Returns: series float The buy volume.
method getBucketSellVol(self, idx)
Returns the **Sell Volume** of a specific bucket.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
idx (int) : series int The index of the bucket.
Returns: series float The sell volume.
method getBucketTime(self, idx)
Returns the raw accumulated time (in ms) spent in a specific bucket.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
idx (int) : series int The index of the bucket.
Returns: series float The time in milliseconds.
method getBucketBuyVelo(self, idx)
Returns the **Buy Velocity** (Aggressive Buy Flow) of a bucket.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
idx (int) : series int The index of the bucket.
Returns: series float The buy velocity in .
method getBucketSellVelo(self, idx)
Returns the **Sell Velocity** (Aggressive Sell Flow) of a bucket.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
idx (int) : series int The index of the bucket.
Returns: series float The sell velocity in .
method getBktBnds(self, idx)
Returns the price boundaries of a specific bucket.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
idx (int) : series int The index of the bucket.
Returns:
up series float The upper price bound of the bucket.
lo series float The lower price bound of the bucket.
method getPoc(self, target)
Returns Point of Control (POC) information for the specified target metric.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns:
pocIdx series int The index of the POC bucket.
pocPrice series float The mid-price of the POC bucket.
method getVA(self, target)
Returns Value Area (VA) information for the specified target metric.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns:
vaUpIdx series int The index of the upper VA bucket.
vaUpPrice series float The upper price bound of the VA.
vaLoIdx series int The index of the lower VA bucket.
vaLoPrice series float The lower price bound of the VA.
method getMedian(self, target)
Returns the Median price for the specified target metric distribution.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns:
medianIdx series int The index of the bucket containing the median.
medianPrice series float The median price.
method getAverage(self, target)
Returns the weighted average price (VWAP/TWAP) for the specified target.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns:
avgIdx series int The index of the bucket containing the average.
avgPrice series float The weighted average price.
method getStdDev(self, target)
Returns the standard deviation for the specified target distribution.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns: series float The standard deviation.
method getSkewness(self, target)
Returns the skewness for the specified target distribution.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns: series float The skewness.
method getKurtosis(self, target)
Returns the excess kurtosis for the specified target distribution.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns: series float The excess kurtosis.
method getSegments(self, target)
Returns the fundamental unimodal segments for the specified target metric.
Calculates on-demand if the target is 'Velocity' and data changed.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns: matrix A 2-column matrix where each row is an pair.
method getCvd(self, target)
Returns Cumulative Volume/Velo Delta (CVD) information for the target metric.
Namespace types: Velo
Parameters:
self (Velo) : Velo The profile object.
target (series Metric) : Metric The data aspect to analyse (Volume, Time, Velocity).
Returns:
cvd series float The final delta value.
cvdHi series float The historical high-water mark of the delta.
cvdLo series float The historical low-water mark of the delta.
Velo
Velo Composite Velocity Profile Controller.
Fields:
_vpVol (VPrf type from AustrianTradingMachine/LibVPrf/2) : LibVPrf.VPrf Engine A: Master Volume source.
_vpTime (VPrf type from AustrianTradingMachine/LibVPrf/2) : LibVPrf.VPrf Engine B: Time duration container (ms).
_vpVelo (VPrf type from AustrianTradingMachine/LibVPrf/2) : LibVPrf.VPrf Engine C: Scratchpad for velocity stats.
_aTime (array) : array Pointer alias to `vpTime.aBuy` (Time storage).
_valueArea (series float) : int Percentage of total volume to include in the Value Area (1..100)
_estimator (series PriceEst enum from AustrianTradingMachine/LibBrSt/1) : LibBrSt.PriceEst PDF model for distribution attribution.
_allot (series AllotMode) : AllotMode Attribution model (Classic or PDF).
_cdfSteps (series int) : int Integration resolution for PDF.
_isDirty (series bool) : bool Lazy evaluation flag for vpVelo.
Library
LibVPrfLibrary "LibVPrf"
This library provides an object-oriented framework for volume
profile analysis in Pine Script®. It is built around the `VProf`
User-Defined Type (UDT), which encapsulates all data, settings,
and statistical metrics for a single profile, enabling stateful
analysis with on-demand calculations.
Key Features:
1. **Object-Oriented Design (UDT):** The library is built around
the `VProf` UDT. This object encapsulates all profile data
and provides methods for its full lifecycle management,
including creation, cloning, clearing, and merging of profiles.
2. **Volume Allocation (`AllotMode`):** Offers two methods for
allocating a bar's volume:
- **Classic:** Assigns the entire bar's volume to the close
price bucket.
- **PDF:** Distributes volume across the bar's range using a
statistical price distribution model from the `LibBrSt` library.
3. **Buy/Sell Volume Splitting (`SplitMode`):** Provides methods
for classifying volume into buying and selling pressure:
- **Classic:** Classifies volume based on the bar's color (Close vs. Open).
- **Dynamic:** A specific model that analyzes candle structure
(body vs. wicks) and a short-term trend factor to
estimate the buy/sell share at each price level.
4. **Statistical Analysis (On-Demand):** Offers a suite of
statistical metrics calculated using a "Lazy Evaluation"
pattern (computed only when requested via `get...` methods):
- **Central Tendency:** Point of Control (POC), VWAP, and Median.
- **Dispersion:** Value Area (VA) and Population Standard Deviation.
- **Shape:** Skewness and Excess Kurtosis.
- **Delta:** Cumulative Volume Delta, including its
historical high/low watermarks.
5. **Structural Analysis:** Includes a parameter-free method
(`getSegments`) to decompose a profile into its fundamental
unimodal segments, allowing for modality detection (e.g.,
identifying bimodal profiles).
6. **Dynamic Profile Management:**
- **Auto-Fitting:** Profiles set to `dynamic = true` will
automatically expand their price range to fit new data.
- **Manipulation:** The resolution, price range, and Value Area
of a dynamic profile can be changed at any time. This
triggers a resampling process that uses a **linear
interpolation model** to re-bucket existing volume.
- **Assumption:** Non-dynamic profiles are fixed and will throw
a `runtime.error` if `addBar` is called with data
outside their initial range.
7. **Bucket-Level Access:** Provides getter methods for direct
iteration and analysis of the raw buy/sell volume and price
boundaries of each individual price bucket.
---
**DISCLAIMER**
This library is provided "AS IS" and for informational and
educational purposes only. It does not constitute financial,
investment, or trading advice.
The author assumes no liability for any errors, inaccuracies,
or omissions in the code. Using this library to build
trading indicators or strategies is entirely at your own risk.
As a developer using this library, you are solely responsible
for the rigorous testing, validation, and performance of any
scripts you create based on these functions. The author shall
not be held liable for any financial losses incurred directly
or indirectly from the use of this library or any scripts
derived from it.
create(buckets, rangeUp, rangeLo, dynamic, valueArea, allot, estimator, cdfSteps, split, trendLen)
Construct a new `VProf` object with fixed bucket count & range.
Parameters:
buckets (int) : series int number of price buckets ≥ 1
rangeUp (float) : series float upper price bound (absolute)
rangeLo (float) : series float lower price bound (absolute)
dynamic (bool) : series bool Flag for dynamic adaption of profile ranges
valueArea (int) : series int Percentage of total volume to include in the Value Area (1..100)
allot (series AllotMode) : series AllotMode Allocation mode `classic` or `pdf` (default `classic`)
estimator (series PriceEst enum from AustrianTradingMachine/LibBrSt/1) : series LibBrSt.PriceEst PDF model when `model == PDF`. (deflault = 'uniform')
cdfSteps (int) : series int even #sub-intervals for Simpson rule (default 20)
split (series SplitMode) : series SplitMode Buy/Sell determination (default `classic`)
trendLen (int) : series int Look‑back bars for trend factor (default 3)
Returns: VProf freshly initialised profile
method clone(self)
Create a deep copy of the volume profile.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object to copy
Returns: VProf A new, independent copy of the profile
method clear(self)
Reset all bucket tallies while keeping configuration intact.
Namespace types: VProf
Parameters:
self (VProf) : VProf profile object
Returns: VProf cleared profile (chaining)
method merge(self, srcABuy, srcASell, srcRangeUp, srcRangeLo, srcCvd, srcCvdHi, srcCvdLo)
Merges volume data from a source profile into the current profile.
If resizing is needed, it performs a high-fidelity re-bucketing of existing
volume using a linear interpolation model inferred from neighboring buckets,
preventing aliasing artifacts and ensuring accurate volume preservation.
Namespace types: VProf
Parameters:
self (VProf) : VProf The target profile object to merge into.
srcABuy (array) : array The source profile's buy volume bucket array.
srcASell (array) : array The source profile's sell volume bucket array.
srcRangeUp (float) : series float The upper price bound of the source profile.
srcRangeLo (float) : series float The lower price bound of the source profile.
srcCvd (float) : series float The final Cumulative Volume Delta (CVD) value of the source profile.
srcCvdHi (float) : series float The historical high-water mark of the CVD from the source profile.
srcCvdLo (float) : series float The historical low-water mark of the CVD from the source profile.
Returns: VProf `self` (chaining), now containing the merged data.
method addBar(self, offset)
Add current bar’s volume to the profile (call once per realtime bar).
classic mode: allocates all volume to the close bucket and classifies
by `close >= open`. PDF mode: distributes volume across buckets by the
estimator’s CDF mass. For `split = dynamic`, the buy/sell share per
price is computed via context-driven piecewise s(u).
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
offset (int) : series int To offset the calculated bar
Returns: VProf `self` (method chaining)
method setBuckets(self, buckets)
Sets the number of buckets for the volume profile.
Behavior depends on the `isDynamic` flag.
- If `dynamic = true`: Works on filled profiles by re-bucketing to a new resolution.
- If `dynamic = false`: Only works on empty profiles to prevent accidental changes.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
buckets (int) : series int The new number of buckets
Returns: VProf `self` (chaining)
method setRanges(self, rangeUp, rangeLo)
Sets the price range for the volume profile.
Behavior depends on the `dynamic` flag.
- If `dynamic = true`: Works on filled profiles by re-bucketing existing volume.
- If `dynamic = false`: Only works on empty profiles to prevent accidental changes.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
rangeUp (float) : series float The new upper price bound
rangeLo (float) : series float The new lower price bound
Returns: VProf `self` (chaining)
method setValueArea(self, valueArea)
Set the percentage of volume for the Value Area. If the value
changes, the profile is finalized again.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
valueArea (int) : series int The new Value Area percentage (0..100)
Returns: VProf `self` (chaining)
method getBktBuyVol(self, idx)
Get Buy volume of a bucket.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
idx (int) : series int Bucket index
Returns: series float Buy volume ≥ 0
method getBktSellVol(self, idx)
Get Sell volume of a bucket.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
idx (int) : series int Bucket index
Returns: series float Sell volume ≥ 0
method getBktBnds(self, idx)
Get Bounds of a bucket.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
idx (int) : series int Bucket index
Returns:
up series float The upper price bound of the bucket.
lo series float The lower price bound of the bucket.
method getPoc(self)
Get POC information.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
Returns:
pocIndex series int The index of the Point of Control (POC) bucket.
pocPrice. series float The mid-price of the Point of Control (POC) bucket.
method getVA(self)
Get Value Area (VA) information.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object
Returns:
vaUpIndex series int The index of the upper bound bucket of the Value Area.
vaUpPrice series float The upper price bound of the Value Area.
vaLoIndex series int The index of the lower bound bucket of the Value Area.
vaLoPrice series float The lower price bound of the Value Area.
method getMedian(self)
Get the profile's median price and its bucket index. Calculates the value on-demand if stale.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object.
Returns:
medianIndex series int The index of the bucket containing the Median.
medianPrice series float The Median price of the profile.
method getVwap(self)
Get the profile's VWAP and its bucket index. Calculates the value on-demand if stale.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object.
Returns:
vwapIndex series int The index of the bucket containing the VWAP.
vwapPrice series float The Volume Weighted Average Price of the profile.
method getStdDev(self)
Get the profile's volume-weighted standard deviation. Calculates the value on-demand if stale.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object.
Returns: series float The Standard deviation of the profile.
method getSkewness(self)
Get the profile's skewness. Calculates the value on-demand if stale.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object.
Returns: series float The Skewness of the profile.
method getKurtosis(self)
Get the profile's excess kurtosis. Calculates the value on-demand if stale.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object.
Returns: series float The Kurtosis of the profile.
method getSegments(self)
Get the profile's fundamental unimodal segments. Calculates on-demand if stale.
Uses a parameter-free, pivot-based recursive algorithm.
Namespace types: VProf
Parameters:
self (VProf) : VProf The profile object.
Returns: matrix A 2-column matrix where each row is an pair.
method getCvd(self)
Cumulative Volume Delta (CVD) like metric over all buckets.
Namespace types: VProf
Parameters:
self (VProf) : VProf Profile object.
Returns:
cvd series float The final Cumulative Volume Delta (Total Buy Vol - Total Sell Vol).
cvdHi series float The running high-water mark of the CVD as volume was added.
cvdLo series float The running low-water mark of the CVD as volume was added.
VProf
VProf Bucketed Buy/Sell volume profile plus meta information.
Fields:
buckets (series int) : int Number of price buckets (granularity ≥1)
rangeUp (series float) : float Upper price range (absolute)
rangeLo (series float) : float Lower price range (absolute)
dynamic (series bool) : bool Flag for dynamic adaption of profile ranges
valueArea (series int) : int Percentage of total volume to include in the Value Area (1..100)
allot (series AllotMode) : AllotMode Allocation mode `classic` or `pdf`
estimator (series PriceEst enum from AustrianTradingMachine/LibBrSt/1) : LibBrSt.PriceEst Price density model when `model == PDF`
cdfSteps (series int) : int Simpson integration resolution (even ≥2)
split (series SplitMode) : SplitMode Buy/Sell split strategy per bar
trendLen (series int) : int Look‑back length for trend factor (≥1)
maxBkt (series int) : int User-defined number of buckets (unclamped)
aBuy (array) : array Buy volume per bucket
aSell (array) : array Sell volume per bucket
cvd (series float) : float Final Cumulative Volume Delta (Total Buy Vol - Total Sell Vol).
cvdHi (series float) : float Running high-water mark of the CVD as volume was added.
cvdLo (series float) : float Running low-water mark of the CVD as volume was added.
poc (series int) : int Index of max‑volume bucket (POC). Is `na` until calculated.
vaUp (series int) : int Index of upper Value‑Area bound. Is `na` until calculated.
vaLo (series int) : int Index of lower value‑Area bound. Is `na` until calculated.
median (series float) : float Median price of the volume distribution. Is `na` until calculated.
vwap (series float) : float Profile VWAP (Volume Weighted Average Price). Is `na` until calculated.
stdDev (series float) : float Standard Deviation of volume around the VWAP. Is `na` until calculated.
skewness (series float) : float Skewness of the volume distribution. Is `na` until calculated.
kurtosis (series float) : float Excess Kurtosis of the volume distribution. Is `na` until calculated.
segments (matrix) : matrix A 2-column matrix where each row is an pair. Is `na` until calculated.
Library
