On every bar it rebuilds a volume profile of the last 200 bars, draws the value area as a band around the busiest price, and marks each close that rejects it, accepts outside it or comes back in.
Window 1 · from bar 300
Simulated 15-minute gold bars, not a real market, run through Value Envelope's default rules, simplified for the browser: a rolling profile of the last 200 bars, weighted by the model's volume, in rows 0.15 ATR tall, set once its first 200 bars have loaded and re-sized every 1,500. The chart draws the script's Clean view: the value band, the POC in its migration colour, and the event marks. Window 1 is the first simulated acceptance whose window starts at bar 300 or later, once the profile's 200 bars and the width rank's 100 have loaded; Another acceptance plays the next acceptances in order, whatever they do next.
| Time | Event | Prices |
|---|---|---|
| 08:30 | Window opens · ▼ LOWER VALUE · BALANCE | POC 4334.73 · VA 4301.10 – 4380.16 |
| 11:00 | REJ @VAL · a poke below the value low closed back inside | Low 4303.05 · VAL 4305.82 |
| 14:30 | ACC below · the third close in a row below value | Close 4278.70 · VA 4284.58 – 4344.76 |
| 17:15 | 80% ↑ to VAH · the second close in a row back inside, from below | Close 4290.62 · VA 4284.58 – 4344.76 |
Full Pine v6 source in Pine Pro Library. It draws on your chart; you place the trades.
One close outside value is a probe; the third in a row is acceptance, and two back inside end it.
80% ↑ to VAH: the second close in a row back inside. The script names it after the 80% rule; the name is not a chance.
The same simulated 15-minute gold, simplified rules: the replay's window 1, up close. The state words are the dashboard's own.
Above the VAH or below the VAL; a close on an edge counts as inside.
Three closes outside on one side, each against its own bar's value area.
Two closes back inside end it: the script marks 80% and leaves ACCEPTED (BALANCE, or COMPRESSED when value is tight).
While accepted, three closes beyond the far edge accept that side instead.
A bar that reaches past value and closes back is a rejection, but only as a first poke.
A drawn example, not the simulation: only the close and the closes before it change. Each verdict is the desk's own rule.
The high goes past the VAH, the close comes back to it or inside, and the bar before stayed at or under its VAH.
A wick outside counts for nothing; only closes build acceptance.
On a bar that could be both, acceptance comes first and no REJ prints.
While a side is accepted, no REJ prints at either edge.
From the busiest row, the two rows above and the two below compare, and the larger pair joins until seventy of every hundred units are inside.
A drawn profile of 100 units, not the simulation. Each step is the desk's own rule; it adds whole rows, so value can pass seventy.
The row with the most volume; on a tie, the one nearest the middle.
Two rows above against two below; at an end, what is left.
Equal pairs add the rows above.
Each row is 0.15 of ATR(50), set once 200 bars have loaded and re-sized every 1,500.
One file, the complete script, ready for TradingView's Pine Editor.
On a phone? Send this page to your desktop.
// ═══════════════════════════════════════════════════════════════════════════════// VALUE ENVELOPE — Market Profile Bands · Pine Script v6// "An envelope like VWAP bands — but the boundaries are the MARKET PROFILE's own value area."//// IDEA A r/pinescript request: dynamic bands built from market-profile boundaries instead// of a mean ± σ. Value moves; the bands follow VALUE, not an average.// RUNS ON any liquid chart, any timeframe. No volume on the feed? It becomes a TPO (time) profile.// STATUS testable draft — compiles clean · non-repainting by construction · a CONTEXT tool,// not a signal engine (see docs/build-report.md). Decision support, never a prediction.//// WHAT IT DRAWS — every bar, from a profile of the last N bars (or the current session):// POC line the price where the most volume traded = the magnet// Value band the Value Area (70% of volume) = the fair-price envelope ≈ "±1σ"// Extended a wider 90% band = the edge of what the market still accepts ≈ "±2σ"// Range the full profile high/low = the outermost envelope ≈ "±3σ"// WHAT IT READS — where price sits vs value · rejection / acceptance at the edges · the// "80% rule" re-entry · POC migration · value compression · profile shape (P / b / D)//// ENGINE an incremental volume-at-price histogram: each bar's volume is spread over the price// rows it touched; the bar leaving the window is subtracted. O(rows) per bar, so a// profile exists on EVERY bar (that is what makes the bands dynamic).//// …// ═══════════════════════════════════════════════════════════════════════════════//@version=6indicator("Value Envelope", "Value Env", overlay = true, max_labels_count = 50) // ─────────────────────────────────────────────────────────────────── INPUTS · profile enginegP = "Profile engine"inMode = input.string("Rolling", "Profile mode", options = ["Rolling", "Anchored"], group = gP, tooltip = "Rolling = the profile is rebuilt from the last N bars on EVERY bar — dynamic bands that glide with the market (the VWAP-band feel). Anchored = the profile restarts at each new day / week / month (like session VWAP) and grows through the period.", display = display.none)inLen = input.int(200, "Rolling window (bars)", minval = 20, maxval = 2000, group = gP,
No coding needed.
In Pine Pro Library: read it, change it, keep it.
An overlay: the band, the POC, the marks, a dashboard and a Co-Pilot.
Weighted by volume where the feed has it; one weight per bar where it has none.
The six events, two POC crosses and value compressed, on closed bars.
Advanced Volume Profile draws the histogram itself, splits each row by buying and selling inferred from the bars, and keeps past sessions' untested POCs on the chart.
Full Pine source / No subscription / 7-day refund before download
Value Envelope stays complete, its full source in Pine Pro Library.
The page, the films and the manual are open to everyone. The script's code is in Pine Pro Library: $49 once for every desk and every update, or as part of the Complete Suite. Sign in to copy or download.
No. It is the name of a trader's rule for a return into value. The script measures no chance, and neither do we.
The row height is set once your chart has loaded its first 200 bars and re-sized every 1,500, so a chart that starts on another bar draws different bands and some different marks. The film counts from its own run's first bar.
No measured edge. It describes where closes sit against value and places no trades. What can change the reading says where it stops.
The histogram itself, volume delta per row, naked POCs and absorption. Value Envelope stays complete either way.
We, ProEA Lab, build Value Envelope. The films run its rules, simplified, on simulated candles, not market data. Not financial advice.
Advanced Volume Profile · $49 · one payment
Get Volume Profile $49 →Value Envelope stays complete, its full source in Pine Pro Library.
Every rule, setting and check, one topic at a time.
Compare the same close with different volume in the calculation example.
Value Envelope · Pine Pro Library
A band shows where estimated trading activity gathers. Watch where candles finish: inside it, outside it, or back inside after a hold.
A chart-reading tool. It does not place trades.
Group activity by price.
The band and busiest-price line move with value.
Price inside, probing or accepted outside.
Value Envelope is a TradingView indicator in Pine Pro Library that estimates a volume value area and plots how that band changes over time. It marks the point of control and applies candle-close rules for acceptance, rejection and re-entry. Rolling and anchored modes use candle data rather than individual trades at each price.
No. It names a re-entry pattern, not a measured success rate. After accepted movement outside the band, the default rule requires two consecutive closes back inside. A broken sequence resets the count before the label can appear. Read acceptance and re-entry rules
Value Envelope retains each bar's calculated band so you can follow its movement over time. Volume Profile Lite redraws a histogram for the current selected window. Both estimate activity across price rows from candle data. Read how the band is calculated
Auto weighting falls back to one weight per candle when cumulative available volume is zero. This is an activity proxy, not actual volume or time spent at each price. An individual zero-volume candle does not trigger that fallback. Read the weighting settings
Press Play, or build the picture one step at a time. This is the idea behind a volume profile.
These candles show where price moved. The short columns below show how much activity came with each candle.
Illustrative prices. We use six candles, then add two, with fixed price rows. The real indicator’s default uses 200 candles. Activity at each price is estimated.
It gives your plan a location and a sequence to study. Decide your own entry, exit and loss limit. The band does not tell you which trade will win.
It means an area containing a chosen share of estimated activity—70% by default. It is not a valuation of the asset or proof that its price is fair. The busiest line can sit above or below the band’s middle.
Try the same idea three ways. The defaults need three closes outside, then two back inside.
The close is between the upper and lower edges. There is no accepted-outside state yet.
A return requires an earlier hold outside.
This lesson holds the band still so you can follow the counts. On your chart, each candle is compared with its own recalculated band. A close on either edge counts as inside.
The tool counts where a candle closes. A wick can enter the band while the close stays outside. Also, a return needs an earlier established hold—not just one candle outside.
Start with the band and the busiest-price line. Read the event labels after that.
The main activity area. VAH is its upper edge; VAL is its lower edge.
POC marks the busiest price row. It is not necessarily halfway between the edges.
ACC records a hold outside. 80% names the return rule. REJ marks a specific failed-edge test.
“80%” is the rule’s name, not a probability for your chart. It does not mean the opposite edge will be reached eight times out of ten.
This example recalculates the rolling band from fictional candles. Choose “Close back above”, then “More volume here”. Both keep the last close at 110, but the extra volume moves the band so that close is now inside. Earlier candles keep their own bands.
Price and volume both matter. Edit the same candle to recalculate its profile, then see whether its close completes acceptance or re-entry.
Each earlier candle keeps its own calculated bands. Only the rightmost candle is being edited.
The engine uses absolute price rows, a centre-nearest POC tie and two-row value expansion. Value covers 70 of 100 volume units; the extended area targets 90. Its current bounds are 87 to 100; the occupied range is 87 to 113.
The row height is 1, calibrated from ATR(50) and frozen for this epoch. POC migration reads flat, with a strict threshold of 1.59. POC placement gives shape P. These are calculated context, not orders.
Closes on VAH or VAL count as inside. Re-entry requires prior acceptance and consecutive inside closes. An interrupted count resets. Every historical close is compared with its own band; changing a count setting replays that same history.
Anchor resets, width-rank compression and alert delivery remain in the full manual. No session, feed or future-price simulator is implied here.
Illustrative inputs · changing a slider recalculates this example · no market feed
Copy once. Keep the full indicator. The code is in Pine Pro Library; no coding needed.
On a TradingView chart, open the Pine Editor and create a new indicator.
Replace the sample code with the source copied below.
Choose Add to chart, then save the script. Start with the default settings.
Copy the code as it is. No coding needed.
Rolling mode needs a full window behind it—200 candles by default—plus the initial calculation. Anchored mode waits for at least 10 candles in the new period by default. Also check the symbol’s data and your selected weighting.
The full explanation is here when you need it.
The tool spreads each candle’s activity across price rows in proportion to how much of its high–low range overlaps each row. This is an estimate, not a record of the exact trades at each price.
The busiest row becomes the POC. Equal-volume ties choose the row nearest the occupied range’s center. Starting there, the tool compares two neighboring rows above with two below and expands toward the larger total; equal totals expand upward.
The inner band targets at least 70% of the activity by default. Whole rows can take it past that target. The extended band targets 90%, or at least five percentage points more than the inner setting. Its price edges can still coincide with the inner edges.
Rolling mode uses the latest 200 candles by default. Anchored mode starts again each day by default. Each candle keeps the band calculated for that time; old closes are not reclassified against today’s band.
VWAP follows a volume-weighted average price. Bollinger Bands use a moving average and price variation. Value Envelope finds a busy price row and an activity area around it.
Its edges are not standard deviations, and its POC need not be centered. The bands can look similar while describing different things.
ACC · acceptance: three consecutive confirmed closes above VAH or below VAL by default. The accepted state stays active until a return completes or enough closes establish acceptance on the opposite side.
80% · re-entry: after acceptance, two consecutive closes inside value by default. A close exactly on VAH or VAL is inside. An interrupted count resets; completing the return clears the accepted state.
REJ · rejection: while no accepted state is active, the candle first pokes beyond an edge and closes back across that edge. The preceding candle must not already have poked beyond its own corresponding edge. Acceptance takes priority.
The rejection close can even pass through the whole band; it need not finish inside it. A wick touch or a return inside does not always print REJ. Some short on-chart descriptions simplify this rule.
These marks record closed-candle events. They do not place entries or confirm that a later target is reached.
POC migration: compare the busiest line with 10 candles ago by default. Up or down requires a move greater than the larger of half a price row or a quarter of ATR. Smaller moves read as flat.
Shape: P means the POC sits toward the upper part of value; b means lower; D means more central. It is a shortcut based on POC position, not proof of who bought, sold or closed a position.
Compression: the value-area width ranks at or below the 20th percentile of its last 100 readings by default. Anchored mode also needs 50 profile candles. Narrow does not tell you when or which way price will break out.
Read location first: where the close is now. The gauge shows its position inside value, or its distance outside in ATR. The other rows show POC and its movement, the area’s edges, width, shape and the last event with its age.
The footer shows mode, candle count, weighting, row height and row count. A SIGNAL row reports an earlier event; check how many candles ago it happened.
NOW describes the current state. WHY lists the readings behind it. WATCH names relevant levels and the next condition that would change the read.
Detailed mode adds confidence, blind spots and a glossary. Confidence is a hand-coded context rating, not a measured chance of success. This panel translates the same calculations; it does not add an independent prediction.
Start with the defaults, then change one setting at a time. No preset establishes that a trading plan is profitable.
A larger value-area percentage targets more activity; it does not establish that its edges are stronger. Row height stays fixed within an epoch and recalibration can change the band in visible steps.
These are study ideas, not instructions to enter. Define your own entry, exit, trade size and maximum loss.
Watch a failed edge test, then record whether price moves inward or leaves again. A REJ mark alone is not enough to establish a trade.
After a hold outside, compare later closes and POC migration. Acceptance describes the completed count; continuation remains uncertain.
Study a confirmed return after acceptance. The opposite edge is a reference for the rotation idea, not a promised destination.
Mark periods of narrow value and observe what follows. Keep both directions and failed moves in your records.
Compare the band with levels already in your plan or another timeframe. More overlapping references do not by themselves prove a better trade.
Choose Value Envelope in TradingView’s alert dialog. The script provides nine named conditions:
Use Once Per Bar Close when creating a named-condition alert. These conditions use confirmed bars; the alerts describe an event, not a filled order.
Any alert() function call sends a readable message containing symbol, timeframe, event and the Co-Pilot’s NOW sentence. It covers only the six rejection, acceptance and re-entry events. POC-cross and compression alerts require their named conditions.
Volume and price feeds differ. In Auto mode, the tool falls back to one weight per candle only when cumulative available volume is zero. A single zero-volume candle does not switch a populated feed to TPO.
TPO here spreads that weight across the candle’s range. It does not measure the actual time or trades at each price. The profile cannot identify traders or reveal real order flow.
The newest band can change while its candle is still open. Closed history stays tied to its own calculation. Changing inputs or data can recalculate history; rolling windows lag, and anchored profiles restart each period.
The tool describes the chart—never what price will do next. There is no backtest and no out-of-sample validation behind these rules. This is research tooling, not financial advice.
What shipped and what changed in Value Envelope, newest first. Ask for the next change below; what gets built lands here with a date, and on the lab queue on the front page.
Value Envelope Shipped
Shows how the area containing most estimated volume changes.
A small friction or a big idea. Tell us what would make this tool work better for you.
Requests for a new tool go on the same queue: see what is asked for and what is being built.
