OPEN-SOURCE SCRIPT
Liquidity Volume Matrix
Liquidity Volume Matrix (LVM)
Liquidity Volume Matrix is a volume-validated liquidity analysis indicator designed to help traders study where resting liquidity may exist, how price reacts around those levels, and whether a sweep is supported by volume and directional pressure.
This is an indicator, not a trading strategy. It does not place orders, does not provide backtest results, and does not claim that any signal will produce a profitable trade. Its purpose is to organize liquidity, volume profile, and net-volume information directly on the chart so traders can make their own analysis.
What the indicator does
Liquidity Volume Matrix combines four main components:
1. Liquidity Levels
The script detects confirmed swing highs and swing lows using pivot logic. Swing highs are treated as potential Buy-Side Liquidity (BSL) above price, while swing lows are treated as potential Sell-Side Liquidity (SSL) below price.
BSL represents areas where buy stops or breakout liquidity may exist above price.
SSL represents areas where sell stops or downside liquidity may exist below price.
The indicator extends these levels forward until they are swept, broken, removed, or recolored depending on the user settings.
2. Volume-Validated Liquidity Pools
Each liquidity level can be evaluated using resting volume around that price zone. The script scans a configurable lookback window and measures volume around each liquidity level using a percentage-based price band.
The level can be classified as:
HIGH — stronger relative volume around the level
MED — moderate relative volume around the level
LOW — weaker relative volume around the level
This grading is not a trade signal. It is only a contextual reading of how much historical volume has interacted with that price area.
3. Liquidity Sweeps
The script marks two types of liquidity sweeps:
SSL Sweep
A sell-side liquidity sweep occurs when price trades below a sell-side liquidity level and then closes back above that level. This means price took liquidity below a prior swing low and rejected lower prices.
BSL Sweep
A buy-side liquidity sweep occurs when price trades above a buy-side liquidity level and then closes back below that level. This means price took liquidity above a prior swing high and rejected higher prices.
The script can optionally require:
Volume confirmation
Delta / net-volume agreement
Next-bar confirmation
When next-bar confirmation is enabled, the label appears only after the following candle confirms the sweep direction. For example, an SSL Sweep is confirmed when the next candle closes above the sweep candle’s high. A BSL Sweep is confirmed when the next candle closes below the sweep candle’s low.
Sweep labels are not automatic buy or sell signals. They identify liquidity events that traders may choose to study with their own trend, risk, and confirmation methods.
4. Internal Volume Profile
The indicator builds an internal rolling volume profile using the selected lookback period. It divides the recent price range into bins and distributes volume across those bins based on candle overlap.
The profile displays:
POC — Point of Control
The price area with the highest estimated volume within the selected profile range.
VAH — Value Area High
The upper boundary of the value area.
VAL — Value Area Low
The lower boundary of the value area.
Value Area
The price range containing the selected percentage of total profile volume, commonly set to 70%.
Liquidity Voids / LVN
Low-volume areas where the profile volume is below the selected threshold relative to the POC bin.
The profile is an internal approximation built from available chart volume and candle ranges. It is not intended to exactly replicate exchange-native volume profile tools.
Net Volume / Delta Logic
The script includes a pressure reading based on net volume.
When possible, it uses lower-timeframe volume delta through TradingView’s volume delta function. If lower-timeframe delta is not available, the script falls back to a candle-based proxy using the candle close location inside the high-low range.
The dashboard shows:
Smoothed Pressure
An EMA-smoothed reading of net volume.
Current Bar Net Vol
The current bar’s estimated net volume.
Delta Source
Shows whether the reading comes from intrabar data or from the candle proxy.
Because not all symbols provide the same quality of volume or intrabar data, users should treat delta and net-volume readings as contextual information, not as exact order-flow data.
Dashboard
The dashboard summarizes the most important live information:
Smoothed Pressure
Current Bar Net Vol
Nearest BSL Above
Nearest SSL Below
POC
Value Area
Current Zone
Last Sweep
Main Focus
The Main Focus field is not a trading recommendation. It is a contextual guide showing where the next important liquidity or value-area reaction may occur.
Settings explained
Liquidity Levels
Pivot Lookback
Controls how many bars are used on each side to confirm a swing high or swing low. Higher values produce fewer but stronger levels. Lower values produce more levels but may increase noise.
Level Source
Allows levels to be created from candle wicks or closing prices. Wicks are more sensitive to liquidity grabs. Close-based levels are more conservative.
Max Levels Kept
Controls how many liquidity levels remain on the chart.
Keep Swept Levels
When enabled, swept levels remain on the chart in a different color. When disabled, swept levels are removed.
Tag Resting Volume on Levels
Displays estimated volume around each liquidity level together with a HIGH / MED / LOW grade.
Resting-Volume Lookback
Controls how far back the script scans when measuring volume around a liquidity level.
Level Volume Band
Controls the price band around each level used for volume accumulation.
HIGH grade / MED grade
Controls how the script classifies the relative volume around each liquidity level.
Liquidity Sweeps
Show Sweep Signals
Turns sweep labels on or off.
Confirm Sweep Next Bar
Requires confirmation from the candle after the sweep before printing the sweep label.
Require Volume Confirmation
Requires the sweep candle to have a volume spike.
Sweep Volume Spike
Defines how large the sweep candle volume must be compared with its recent average.
Sweep Volume Average Length
Defines the volume average used for sweep confirmation.
Require Delta Agreement
Requires net-volume direction to agree with the sweep type.
Remove Levels on Break
Removes a level when price closes through it instead of only sweeping it.
Volume Profile
Show Volume Profile
Turns the internal rolling profile on or off.
Profile Lookback
Controls how many recent bars are included in the profile.
Profile Bins
Controls the resolution of the profile. Higher values create more detailed bins but can make the chart busier.
Value Area %
Defines how much of total volume is included in the value area.
Profile Width
Controls the horizontal width of the profile bars.
Profile Offset
Controls how far the profile is placed from the most recent candle.
Draw POC / VAH / VAL Lines
Displays the Point of Control and value area boundaries.
Highlight Liquidity Voids
Highlights low-volume areas.
Void Threshold
Defines how low volume must be relative to the POC bin for a zone to be treated as a liquidity void.
Net Volume / Delta
Delta Source
Auto mode uses intrabar volume delta when available. Candle proxy mode estimates net volume from candle structure.
Use Custom Lower Timeframe
Allows the user to manually select the lower timeframe used for intrabar delta.
Pressure Smoothing Length
Controls the EMA smoothing length applied to net volume.
Dashboard
Show Dashboard
Shows or hides the dashboard.
Position
Controls dashboard location.
Text Size
Controls dashboard text size.
Colors & Style
Buy-Side Liquidity
Color for BSL levels above price.
Sell-Side Liquidity
Color for SSL levels below price.
Swept / Broken Level
Color for levels after they are swept or broken.
SSL Sweep Confirmation
Color for confirmed sell-side sweeps.
BSL Sweep Confirmation
Color for confirmed buy-side sweeps.
POC Line / POC Text
Color for the Point of Control.
Value Area / Profile
Color for the profile and value-area components.
Liquidity Void
Color for LVN / liquidity void areas.
Visual Clarity
Highlight Nearest BSL / SSL
Emphasizes the nearest active liquidity level above and below price.
Nearest Level Width
Controls the thickness of the nearest active levels.
Dim Far Levels
Makes non-nearest levels lighter to reduce clutter.
Level Label Mode
Controls whether labels appear on all levels, nearest levels only, short labels only, or not at all.
Show Volume Text Only On Nearest
Keeps volume text only on the nearest active BSL and SSL to avoid label overlap.
Profile Visual Strength
POC Line Width
Controls how visible the POC line is.
POC Box Transparency
Controls the strength of the profile bar at the POC.
Value Area Transparency
Controls the opacity of the value area profile bars.
Other Profile Transparency
Controls the opacity of profile bars outside the value area.
Void Zone Transparency
Controls the opacity of liquidity void zones.
How to use this indicator
One practical workflow is:
1. Identify the nearest BSL above price and SSL below price.
2. Check whether price is trading inside, above, or below the value area.
3. Watch how price reacts when it reaches BSL, SSL, POC, VAH, or VAL.
4. Treat confirmed sweeps as liquidity events, not as standalone entries.
5. Use your own market structure, trend, risk management, and confirmation process before making any trading decision.
For example:
If price sweeps SSL and closes back above the level, this may show that downside liquidity was taken and rejected. The user can then study whether market structure, volume, and risk location support a bullish idea.
If price sweeps BSL and closes back below the level, this may show that upside liquidity was taken and rejected. The user can then study whether market structure, volume, and risk location support a bearish idea.
Important limitations
This indicator does not predict future price movement.
Liquidity levels are based on confirmed pivots, which means they appear only after the required number of bars has passed.
Volume profile calculations are internal approximations based on available chart data.
Delta may come from intrabar data or from a candle-based proxy depending on symbol and timeframe availability.
Sweep labels are not buy or sell signals.
The indicator should not be used alone for trade execution.
Different symbols, timeframes, and data providers may produce different volume and delta behavior.
Recommended use
Liquidity Volume Matrix is best used as a decision-support tool for discretionary market analysis. It may be useful for traders who study liquidity, stop runs, sweep reactions, volume profile context, POC reactions, value area behavior, and low-volume zones.
It is designed for visual market context, not automated trading, not guaranteed signal generation, and not financial advice.
Alerts
The script includes alerts for:
Confirmed SSL Sweep
Confirmed BSL Sweep
Any confirmed liquidity sweep
New Buy-Side Liquidity
New Sell-Side Liquidity
These alerts notify the user that a liquidity event or new liquidity level has appeared. They do not instruct the user to buy or sell.
Originality and purpose
Liquidity Volume Matrix combines liquidity-level mapping, volume validation, sweep confirmation, internal volume profile, value-area context, liquidity void detection, and net-volume pressure into one chart-based tool.
The purpose of combining these components is to reduce the need to read liquidity, profile, and volume pressure separately. The script attempts to show where liquidity may rest, whether that liquidity was swept, whether volume supported the event, and where price is trading relative to POC and value area.
This makes the script a contextual liquidity and volume map rather than a simple signal marker.
Liquidity Volume Matrix is a volume-validated liquidity analysis indicator designed to help traders study where resting liquidity may exist, how price reacts around those levels, and whether a sweep is supported by volume and directional pressure.
This is an indicator, not a trading strategy. It does not place orders, does not provide backtest results, and does not claim that any signal will produce a profitable trade. Its purpose is to organize liquidity, volume profile, and net-volume information directly on the chart so traders can make their own analysis.
What the indicator does
Liquidity Volume Matrix combines four main components:
1. Liquidity Levels
The script detects confirmed swing highs and swing lows using pivot logic. Swing highs are treated as potential Buy-Side Liquidity (BSL) above price, while swing lows are treated as potential Sell-Side Liquidity (SSL) below price.
BSL represents areas where buy stops or breakout liquidity may exist above price.
SSL represents areas where sell stops or downside liquidity may exist below price.
The indicator extends these levels forward until they are swept, broken, removed, or recolored depending on the user settings.
2. Volume-Validated Liquidity Pools
Each liquidity level can be evaluated using resting volume around that price zone. The script scans a configurable lookback window and measures volume around each liquidity level using a percentage-based price band.
The level can be classified as:
HIGH — stronger relative volume around the level
MED — moderate relative volume around the level
LOW — weaker relative volume around the level
This grading is not a trade signal. It is only a contextual reading of how much historical volume has interacted with that price area.
3. Liquidity Sweeps
The script marks two types of liquidity sweeps:
SSL Sweep
A sell-side liquidity sweep occurs when price trades below a sell-side liquidity level and then closes back above that level. This means price took liquidity below a prior swing low and rejected lower prices.
BSL Sweep
A buy-side liquidity sweep occurs when price trades above a buy-side liquidity level and then closes back below that level. This means price took liquidity above a prior swing high and rejected higher prices.
The script can optionally require:
Volume confirmation
Delta / net-volume agreement
Next-bar confirmation
When next-bar confirmation is enabled, the label appears only after the following candle confirms the sweep direction. For example, an SSL Sweep is confirmed when the next candle closes above the sweep candle’s high. A BSL Sweep is confirmed when the next candle closes below the sweep candle’s low.
Sweep labels are not automatic buy or sell signals. They identify liquidity events that traders may choose to study with their own trend, risk, and confirmation methods.
4. Internal Volume Profile
The indicator builds an internal rolling volume profile using the selected lookback period. It divides the recent price range into bins and distributes volume across those bins based on candle overlap.
The profile displays:
POC — Point of Control
The price area with the highest estimated volume within the selected profile range.
VAH — Value Area High
The upper boundary of the value area.
VAL — Value Area Low
The lower boundary of the value area.
Value Area
The price range containing the selected percentage of total profile volume, commonly set to 70%.
Liquidity Voids / LVN
Low-volume areas where the profile volume is below the selected threshold relative to the POC bin.
The profile is an internal approximation built from available chart volume and candle ranges. It is not intended to exactly replicate exchange-native volume profile tools.
Net Volume / Delta Logic
The script includes a pressure reading based on net volume.
When possible, it uses lower-timeframe volume delta through TradingView’s volume delta function. If lower-timeframe delta is not available, the script falls back to a candle-based proxy using the candle close location inside the high-low range.
The dashboard shows:
Smoothed Pressure
An EMA-smoothed reading of net volume.
Current Bar Net Vol
The current bar’s estimated net volume.
Delta Source
Shows whether the reading comes from intrabar data or from the candle proxy.
Because not all symbols provide the same quality of volume or intrabar data, users should treat delta and net-volume readings as contextual information, not as exact order-flow data.
Dashboard
The dashboard summarizes the most important live information:
Smoothed Pressure
Current Bar Net Vol
Nearest BSL Above
Nearest SSL Below
POC
Value Area
Current Zone
Last Sweep
Main Focus
The Main Focus field is not a trading recommendation. It is a contextual guide showing where the next important liquidity or value-area reaction may occur.
Settings explained
Liquidity Levels
Pivot Lookback
Controls how many bars are used on each side to confirm a swing high or swing low. Higher values produce fewer but stronger levels. Lower values produce more levels but may increase noise.
Level Source
Allows levels to be created from candle wicks or closing prices. Wicks are more sensitive to liquidity grabs. Close-based levels are more conservative.
Max Levels Kept
Controls how many liquidity levels remain on the chart.
Keep Swept Levels
When enabled, swept levels remain on the chart in a different color. When disabled, swept levels are removed.
Tag Resting Volume on Levels
Displays estimated volume around each liquidity level together with a HIGH / MED / LOW grade.
Resting-Volume Lookback
Controls how far back the script scans when measuring volume around a liquidity level.
Level Volume Band
Controls the price band around each level used for volume accumulation.
HIGH grade / MED grade
Controls how the script classifies the relative volume around each liquidity level.
Liquidity Sweeps
Show Sweep Signals
Turns sweep labels on or off.
Confirm Sweep Next Bar
Requires confirmation from the candle after the sweep before printing the sweep label.
Require Volume Confirmation
Requires the sweep candle to have a volume spike.
Sweep Volume Spike
Defines how large the sweep candle volume must be compared with its recent average.
Sweep Volume Average Length
Defines the volume average used for sweep confirmation.
Require Delta Agreement
Requires net-volume direction to agree with the sweep type.
Remove Levels on Break
Removes a level when price closes through it instead of only sweeping it.
Volume Profile
Show Volume Profile
Turns the internal rolling profile on or off.
Profile Lookback
Controls how many recent bars are included in the profile.
Profile Bins
Controls the resolution of the profile. Higher values create more detailed bins but can make the chart busier.
Value Area %
Defines how much of total volume is included in the value area.
Profile Width
Controls the horizontal width of the profile bars.
Profile Offset
Controls how far the profile is placed from the most recent candle.
Draw POC / VAH / VAL Lines
Displays the Point of Control and value area boundaries.
Highlight Liquidity Voids
Highlights low-volume areas.
Void Threshold
Defines how low volume must be relative to the POC bin for a zone to be treated as a liquidity void.
Net Volume / Delta
Delta Source
Auto mode uses intrabar volume delta when available. Candle proxy mode estimates net volume from candle structure.
Use Custom Lower Timeframe
Allows the user to manually select the lower timeframe used for intrabar delta.
Pressure Smoothing Length
Controls the EMA smoothing length applied to net volume.
Dashboard
Show Dashboard
Shows or hides the dashboard.
Position
Controls dashboard location.
Text Size
Controls dashboard text size.
Colors & Style
Buy-Side Liquidity
Color for BSL levels above price.
Sell-Side Liquidity
Color for SSL levels below price.
Swept / Broken Level
Color for levels after they are swept or broken.
SSL Sweep Confirmation
Color for confirmed sell-side sweeps.
BSL Sweep Confirmation
Color for confirmed buy-side sweeps.
POC Line / POC Text
Color for the Point of Control.
Value Area / Profile
Color for the profile and value-area components.
Liquidity Void
Color for LVN / liquidity void areas.
Visual Clarity
Highlight Nearest BSL / SSL
Emphasizes the nearest active liquidity level above and below price.
Nearest Level Width
Controls the thickness of the nearest active levels.
Dim Far Levels
Makes non-nearest levels lighter to reduce clutter.
Level Label Mode
Controls whether labels appear on all levels, nearest levels only, short labels only, or not at all.
Show Volume Text Only On Nearest
Keeps volume text only on the nearest active BSL and SSL to avoid label overlap.
Profile Visual Strength
POC Line Width
Controls how visible the POC line is.
POC Box Transparency
Controls the strength of the profile bar at the POC.
Value Area Transparency
Controls the opacity of the value area profile bars.
Other Profile Transparency
Controls the opacity of profile bars outside the value area.
Void Zone Transparency
Controls the opacity of liquidity void zones.
How to use this indicator
One practical workflow is:
1. Identify the nearest BSL above price and SSL below price.
2. Check whether price is trading inside, above, or below the value area.
3. Watch how price reacts when it reaches BSL, SSL, POC, VAH, or VAL.
4. Treat confirmed sweeps as liquidity events, not as standalone entries.
5. Use your own market structure, trend, risk management, and confirmation process before making any trading decision.
For example:
If price sweeps SSL and closes back above the level, this may show that downside liquidity was taken and rejected. The user can then study whether market structure, volume, and risk location support a bullish idea.
If price sweeps BSL and closes back below the level, this may show that upside liquidity was taken and rejected. The user can then study whether market structure, volume, and risk location support a bearish idea.
Important limitations
This indicator does not predict future price movement.
Liquidity levels are based on confirmed pivots, which means they appear only after the required number of bars has passed.
Volume profile calculations are internal approximations based on available chart data.
Delta may come from intrabar data or from a candle-based proxy depending on symbol and timeframe availability.
Sweep labels are not buy or sell signals.
The indicator should not be used alone for trade execution.
Different symbols, timeframes, and data providers may produce different volume and delta behavior.
Recommended use
Liquidity Volume Matrix is best used as a decision-support tool for discretionary market analysis. It may be useful for traders who study liquidity, stop runs, sweep reactions, volume profile context, POC reactions, value area behavior, and low-volume zones.
It is designed for visual market context, not automated trading, not guaranteed signal generation, and not financial advice.
Alerts
The script includes alerts for:
Confirmed SSL Sweep
Confirmed BSL Sweep
Any confirmed liquidity sweep
New Buy-Side Liquidity
New Sell-Side Liquidity
These alerts notify the user that a liquidity event or new liquidity level has appeared. They do not instruct the user to buy or sell.
Originality and purpose
Liquidity Volume Matrix combines liquidity-level mapping, volume validation, sweep confirmation, internal volume profile, value-area context, liquidity void detection, and net-volume pressure into one chart-based tool.
The purpose of combining these components is to reduce the need to read liquidity, profile, and volume pressure separately. The script attempts to show where liquidity may rest, whether that liquidity was swept, whether volume supported the event, and where price is trading relative to POC and value area.
This makes the script a contextual liquidity and volume map rather than a simple signal marker.
開源腳本
秉持TradingView一貫精神，這個腳本的創作者將其設為開源，以便交易者檢視並驗證其功能。向作者致敬！您可以免費使用此腳本，但請注意，重新發佈代碼需遵守我們的社群規範。
免責聲明
這些資訊和出版物並非旨在提供，也不構成TradingView提供或認可的任何形式的財務、投資、交易或其他類型的建議或推薦。請閱讀使用條款以了解更多資訊。
免責聲明
這些資訊和出版物並非旨在提供，也不構成TradingView提供或認可的任何形式的財務、投資、交易或其他類型的建議或推薦。請閱讀使用條款以了解更多資訊。