OPEN-SOURCE SCRIPT
Aggiornato Volume Profile XL

**Volume Profile XL — Overview**
Volume Profile XL shows *where* trading activity concentrated across price, rather than just when it happened. It divides price into horizontal bins and draws a sideways histogram: the longer a row, the more volume traded at that price. This reveals the levels the market accepted (heavy rows) and the levels it passed through quickly (thin rows), plus three key reference prices — the POC and the Value Area boundaries.
**The two ways it can display**
- **Per Day (Historical)** — the default. It draws a separate profile over each of the last several periods, sitting on top of that period's candles. This lets you see how accepted price shifted from one day to the next.
- **Combined** — one single profile built from a fixed number of recent bars, drawn off to one side of price. This gives a clean, current read of fair value across the recent move without splitting it by day.
**The three reference markers on every profile**
- **POC (Point of Control)** — the single price with the most volume; the profile's center of gravity.
- **VAH / VAL (Value Area High / Low)** — the top and bottom of the price band containing the chosen percentage of volume. Price inside this band is "in balance"; price leaving it signals the market is exploring new territory.
---
**Mode settings (top of the panel)**
- **Profile Mode** — switches between Per Day and Combined, as described above.
- **Split Up/Down Volume** — when on, each row is colored in two parts, showing how much of that level's volume came from up-closing versus down-closing bars, so you can read buying vs. selling pressure within a level. When off, each row is a single color based on whichever side dominated. Turning it off also halves the drawing load, which lets you display roughly twice as many days at the same detail — the main lever when you want more history on screen.
**Calculation settings**
- **Number of Rows** — how finely price is sliced. More rows means more detail but, in Per Day mode, fewer days fit on screen at once. Fewer rows means a coarser profile but more history.
- **Value Area %** — the share of volume the Value Area captures. Seventy percent is the long-standing market convention; raising or lowering it widens or narrows the VAH–VAL band.
**Per Day (Historical) settings**
- **Period** — whether each profile covers a Day, a Week, or a Month.
- **Historical Lookback (Days)** — how many periods back to draw. If you request more than the screen can hold, it automatically shows as many as fit rather than erroring.
- **Profile Width (% of period)** — how much of each period's horizontal space the widest row fills. Lower values make slimmer, less overlapping profiles; higher values make bolder ones.
**Combined settings**
- **Lookback Bars** — how many recent bars feed the single combined profile.
- **Placement** — draws the profile to the Left or Right of current price.
- **Max Profile Width** — the on-screen length of the busiest row; controls the overall size of the histogram.
- **Gap From Price** — spacing between the profile and the candles.
**Colors & Lines settings**
- **Up Volume / Down Volume** — the two histogram colors.
- **Show POC** and **POC Color / POC Line Style** — toggle the Point of Control line and set its color and style (Solid, Dashed, or Dotted).
- **Show Value Area** and **VA Color / VA Line Style** — toggle the Value Area lines and set their color and style.
- **Label Size** — the size of the POC, VAH, and VAL price tags, from Tiny to Huge.
---
**How to use it in practice**
- **Read the shape first.** Fat rows are magnets where price tends to stall; thin rows and gaps are fast zones price tends to slice through.
- **Watch behavior at the edges.** Price stalling at VAH or VAL and turning back suggests balance and a move toward the POC. Price pushing through an edge and *holding* there suggests acceptance and a possible trend in that direction.
- **Compare day to day (Per Day mode).** Overlapping value areas across days point to a sideways, balancing market; value areas stepping steadily up or down point to a trend. Where today opens relative to yesterday's Value Area is one of the most useful tells for whether the session is likely to rotate or run.
- **Use Combined for the big picture.** When you want one clean map of the current support and resistance shelves rather than a day-by-day breakdown, switch to Combined and place it on whichever side keeps your price action clear.
**A note on the data**
The profile is built from each bar's price range and volume, which is the standard approach for this kind of tool on this platform. It's a close approximation of the true volume-at-price distribution, not a tick-by-tick reconstruction, so treat the levels as high-quality reference points rather than exact measurements.
Volume Profile XL shows *where* trading activity concentrated across price, rather than just when it happened. It divides price into horizontal bins and draws a sideways histogram: the longer a row, the more volume traded at that price. This reveals the levels the market accepted (heavy rows) and the levels it passed through quickly (thin rows), plus three key reference prices — the POC and the Value Area boundaries.
**The two ways it can display**
- **Per Day (Historical)** — the default. It draws a separate profile over each of the last several periods, sitting on top of that period's candles. This lets you see how accepted price shifted from one day to the next.
- **Combined** — one single profile built from a fixed number of recent bars, drawn off to one side of price. This gives a clean, current read of fair value across the recent move without splitting it by day.
**The three reference markers on every profile**
- **POC (Point of Control)** — the single price with the most volume; the profile's center of gravity.
- **VAH / VAL (Value Area High / Low)** — the top and bottom of the price band containing the chosen percentage of volume. Price inside this band is "in balance"; price leaving it signals the market is exploring new territory.
---
**Mode settings (top of the panel)**
- **Profile Mode** — switches between Per Day and Combined, as described above.
- **Split Up/Down Volume** — when on, each row is colored in two parts, showing how much of that level's volume came from up-closing versus down-closing bars, so you can read buying vs. selling pressure within a level. When off, each row is a single color based on whichever side dominated. Turning it off also halves the drawing load, which lets you display roughly twice as many days at the same detail — the main lever when you want more history on screen.
**Calculation settings**
- **Number of Rows** — how finely price is sliced. More rows means more detail but, in Per Day mode, fewer days fit on screen at once. Fewer rows means a coarser profile but more history.
- **Value Area %** — the share of volume the Value Area captures. Seventy percent is the long-standing market convention; raising or lowering it widens or narrows the VAH–VAL band.
**Per Day (Historical) settings**
- **Period** — whether each profile covers a Day, a Week, or a Month.
- **Historical Lookback (Days)** — how many periods back to draw. If you request more than the screen can hold, it automatically shows as many as fit rather than erroring.
- **Profile Width (% of period)** — how much of each period's horizontal space the widest row fills. Lower values make slimmer, less overlapping profiles; higher values make bolder ones.
**Combined settings**
- **Lookback Bars** — how many recent bars feed the single combined profile.
- **Placement** — draws the profile to the Left or Right of current price.
- **Max Profile Width** — the on-screen length of the busiest row; controls the overall size of the histogram.
- **Gap From Price** — spacing between the profile and the candles.
**Colors & Lines settings**
- **Up Volume / Down Volume** — the two histogram colors.
- **Show POC** and **POC Color / POC Line Style** — toggle the Point of Control line and set its color and style (Solid, Dashed, or Dotted).
- **Show Value Area** and **VA Color / VA Line Style** — toggle the Value Area lines and set their color and style.
- **Label Size** — the size of the POC, VAH, and VAL price tags, from Tiny to Huge.
---
**How to use it in practice**
- **Read the shape first.** Fat rows are magnets where price tends to stall; thin rows and gaps are fast zones price tends to slice through.
- **Watch behavior at the edges.** Price stalling at VAH or VAL and turning back suggests balance and a move toward the POC. Price pushing through an edge and *holding* there suggests acceptance and a possible trend in that direction.
- **Compare day to day (Per Day mode).** Overlapping value areas across days point to a sideways, balancing market; value areas stepping steadily up or down point to a trend. Where today opens relative to yesterday's Value Area is one of the most useful tells for whether the session is likely to rotate or run.
- **Use Combined for the big picture.** When you want one clean map of the current support and resistance shelves rather than a day-by-day breakdown, switch to Combined and place it on whichever side keeps your price action clear.
**A note on the data**
The profile is built from each bar's price range and volume, which is the standard approach for this kind of tool on this platform. It's a close approximation of the true volume-at-price distribution, not a tick-by-tick reconstruction, so treat the levels as high-quality reference points rather than exact measurements.
Note di rilascio
**Updates to Volume Profile XL**Here's what changed across the recent round of edits, grouped by area.
**Title**
- Removed the short title, so the chart legend now displays the full name **Volume Profile XL** everywhere.
**Mode group (top of settings)**
- **Profile Mode** defaults to **Per Day (Historical)**.
- **Split Up/Down Volume** was moved up here, sitting directly under Profile Mode, since it's a structural choice rather than a color one.
**Per Day (Historical) settings**
- **Historical Lookback (Days)** defaults to **5** — how many periods back the indicator draws.
**Combined settings**
- **Placement** defaults to **Left**, so the single combined profile sits to the left of price.
**Colors & Lines settings**
- **POC Line Style** added under POC Color — choose Solid, Dashed, or Dotted for the Point of Control line.
- **VA Line Style** added under VA Color — same Solid / Dashed / Dotted choice for the Value Area lines.
- **Show Labels** added — a checkbox that turns all the POC/VAH/VAL price tags on or off.
- **Label Size** added — a dropdown to size those tags from Tiny to Huge.
- **Label Bar Offset** added below Label Size, defaulted to **2** — nudges the price tags sideways by that many bars so they clear the profile and candles without moving the lines themselves.
**Net effect**
- You now have full control over how the reference lines look (color and style), whether and how large the labels appear and how far they sit from the profile, and the layout defaults are tuned for the per-day historical view you're using most.
Note di rilascio
Added POC & VA Line Width input controls.Note di rilascio
Tool tips added to inputs.No change to logic or functionality.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.