OPEN-SOURCE SCRIPT
Atlas Candle Volume Engine
Atlas Candle Volume Engine
Read the candle. Measure the participation. Understand the move.
The Atlas Candle Volume Engine is a multi-timeframe candle and volume analysis tool designed to answer one fundamental question:
Is price moving with meaningful participation — or is it moving on weak volume?
Instead of treating every bullish or bearish candle equally, Atlas breaks the candle down into its individual components and compares them across Chart, 1H, 15M and 5M.
The result is a compact market diagnostic table that lets you see direction, candle strength, rejection, volume participation, volatility and volume efficiency at a glance.
How to read the table
🟢 Direction
Shows whether the candle is currently BULL or BEAR.
Don't use Direction by itself.
A bearish candle on extremely low volume is very different from a bearish candle accompanied by a major volume expansion.
Think:
Direction tells you what price did.
The other rows help explain why it may have happened.
📊 Body %
Measures how much of the candle's range is real body.
Example:
80% Body
Price travelled decisively in one direction.
20% Body
Most of the candle's movement was wick.
Reading it:
High Body % + high volume = stronger directional candle
Low Body % + high volume = potential conflict/rejection
📍 Close %
Shows where the candle finished within its high-low range.
Close near 90–100%
Buyers controlled most of the candle.
Close near 0–10%
Sellers controlled most of the candle.
Close around 50%
Neither side clearly controlled the final outcome.
Example
A bullish candle with:
Body 85% Close 95% Volume 2.2×
is much more convincing than:
Body 25% Close 52% Volume 2.2×
The volume is identical, but the result of that volume is completely different.
Wick % — rejection
Upper Wick
A large upper wick means price traded higher but failed to hold those levels.
Lower Wick
A large lower wick means price traded lower but recovered.
Example — potential selling rejection
Bear/Bull candle Upper Wick 45% Volume 2.5×
This tells you there was substantial activity at higher prices, but price couldn't maintain the high.
Example — potential buying rejection
Lower Wick 50% Volume 2.5×
Price was pushed lower but recovered strongly.
Wicks become much more meaningful when accompanied by elevated volume.
🔥 Volume Ratio
This is one of the most important numbers.
It compares current volume with its normal volume.
Example
0.50×
Volume is roughly half normal.
1.00×
Normal participation.
1.50×
50% above normal.
2.00×
Twice normal volume.
3.00×
Extreme participation.
The key rule:
High volume does NOT automatically mean bullish.
It means:
Something significant is happening.
We then look at the candle to determine what price actually did with that participation.
📈 Volume Percentile
This answers a slightly different question:
How unusual is this volume compared with previous candles?
For example:
95% percentile
means current volume is unusually high compared with its historical distribution.
10% percentile
means volume is relatively quiet.
Example
Price suddenly falls with:
Volume Ratio: 2.4× Volume Percentile: 97%
That's a major participation event.
Now look at:
Body + Close + Wicks + Efficiency
to determine what that participation accomplished.
🚀 Volume Acceleration
This tells you whether participation is increasing or decreasing.
Example
0.8×
1.0×
1.3×
1.7×
2.1×
Volume is accelerating.
If price is simultaneously moving upward with strong candles, that can indicate expanding participation behind the move.
Conversely:
2.4×
2.0×
1.6×
1.2×
0.8×
Volume is fading.
If price continues moving but participation keeps disappearing, the move may be losing strength.
⚡ Range / ATR
This tells you how large the candle is compared with normal volatility.
Example
0.40
Small movement.
1.00
Normal movement.
2.00
The candle is approximately twice the normal ATR range.
A large range combined with high volume is much more significant than a tiny candle occurring on the same volume.
💥 Body / ATR
This focuses specifically on directional displacement.
A candle could have a large range because of huge wicks.
Body/ATR helps determine whether price actually travelled directionally.
Example A
Range/ATR = 2.0 Body/ATR = 0.3
Huge candle, but most of it was wick.
Example B
Range/ATR = 1.5 Body/ATR = 1.2
Most of the movement was genuine directional displacement.
That distinction is extremely important.
⚙️ Efficiency
Efficiency brings several of these ideas together.
It asks:
How effectively is the current volume producing price movement?
HIGH efficiency
Volume is producing substantial directional displacement.
MED efficiency
Some movement is occurring, but the signal is less decisive.
LOW efficiency
A lot of activity is producing relatively little directional movement.
Real-world examples
Example 1 — Strong bullish expansion
Direction BULL
Body % 85%
Close % 94%
Upper Wick 5%
Lower Wick 11%
Vol Ratio 2.3×
Vol Percentile 96%
Vol Accel UP
Range/ATR 1.7
Body/ATR 1.4
Efficiency HIGH
Reading:
Bullish direction + strong body + close near high + high volume + increasing participation + strong displacement.
This is a high-quality bullish expansion profile.
Example 2 — Weak bearish move
Direction BEAR
Body % 72%
Close % 67%
Vol Ratio 0.35×
Vol Percentile 8%
Vol Accel DOWN
Range/ATR 0.55
Body/ATR 0.40
Efficiency MED
Price is falling.
But participation is weak.
Reading:
Bearish price action, but little evidence of expanding participation behind the move.
This doesn't automatically mean bullish — it means the bearish move isn't strongly confirmed by volume.
Example 3 — High-volume rejection
Direction BULL
Body % 25%
Close % 58%
Upper Wick 62%
Vol Ratio 2.8×
Vol Percentile 98%
Vol Accel UP
Range/ATR 1.9
Body/ATR 0.35
Efficiency LOW
This is very interesting.
Huge volume.
Huge range.
But very little body.
And a massive upper wick.
Reading:
A lot of activity occurred, but price failed to maintain the move higher.
That is a very different market condition from a clean bullish expansion.
Example 4 — Quiet accumulation/absorption type behaviour
Direction BULL
Body % 30%
Close % 72%
Lower Wick 48%
Vol Ratio 2.2×
Vol Percentile 94%
Vol Accel UP
Range/ATR 1.4
Body/ATR 0.30
Efficiency MED
Price was pushed down, but recovered.
Volume is elevated.
The lower wick is large.
Reading:
Significant activity occurred at lower prices, but sellers failed to maintain control.
This is the sort of pattern where the relationship between volume + wick + close becomes much more informative than candle colour alone.
The golden rule of the table
Never read one row in isolation.
Instead, read it in layers:
1️⃣ Direction
Which way did price move?
↓
2️⃣ Body + Close
How decisively did it move?
↓
3️⃣ Wicks
Was there rejection?
↓
4️⃣ Volume Ratio + Percentile
Was there meaningful participation?
↓
5️⃣ Volume Acceleration
Is participation increasing or fading?
↓
6️⃣ Range/ATR + Body/ATR
How significant was the actual displacement?
↓
7️⃣ Efficiency
Did the volume actually accomplish much?
Multi-timeframe example
This is where the table becomes particularly powerful.
Imagine:
1H 15M 5M
Direction BULL BULL BEAR
Body % 82% 74% 65%
Vol Ratio 1.8× 2.1× 0.5×
Vol Accel UP UP DOWN
Efficiency HIGH HIGH MED
The 1H and 15M are showing strong bullish participation, while the 5M is currently pulling back on weak volume.
That tells a very different story from:
1H 15M 5M
Direction BEAR BEAR BEAR
Vol Ratio 2.1× 2.4× 2.7×
Vol Accel UP UP UP
Efficiency HIGH HIGH HIGH
Here, all three time frames are showing expanding bearish participation.
That's the real purpose of the table:
Don't just look at the colour of the candle. Look at what the market had to do to produce it.
Atlas Candle Volume Engine
Price tells you what happened. Volume tells you how much participation was involved. Candle structure tells you how that participation affected price. Efficiency tells you how much the market actually accomplished.
That combination is what makes the table useful as a standalone market-reading tool.
Read the candle. Measure the participation. Understand the move.
The Atlas Candle Volume Engine is a multi-timeframe candle and volume analysis tool designed to answer one fundamental question:
Is price moving with meaningful participation — or is it moving on weak volume?
Instead of treating every bullish or bearish candle equally, Atlas breaks the candle down into its individual components and compares them across Chart, 1H, 15M and 5M.
The result is a compact market diagnostic table that lets you see direction, candle strength, rejection, volume participation, volatility and volume efficiency at a glance.
How to read the table
🟢 Direction
Shows whether the candle is currently BULL or BEAR.
Don't use Direction by itself.
A bearish candle on extremely low volume is very different from a bearish candle accompanied by a major volume expansion.
Think:
Direction tells you what price did.
The other rows help explain why it may have happened.
📊 Body %
Measures how much of the candle's range is real body.
Example:
80% Body
Price travelled decisively in one direction.
20% Body
Most of the candle's movement was wick.
Reading it:
High Body % + high volume = stronger directional candle
Low Body % + high volume = potential conflict/rejection
📍 Close %
Shows where the candle finished within its high-low range.
Close near 90–100%
Buyers controlled most of the candle.
Close near 0–10%
Sellers controlled most of the candle.
Close around 50%
Neither side clearly controlled the final outcome.
Example
A bullish candle with:
Body 85% Close 95% Volume 2.2×
is much more convincing than:
Body 25% Close 52% Volume 2.2×
The volume is identical, but the result of that volume is completely different.
Wick % — rejection
Upper Wick
A large upper wick means price traded higher but failed to hold those levels.
Lower Wick
A large lower wick means price traded lower but recovered.
Example — potential selling rejection
Bear/Bull candle Upper Wick 45% Volume 2.5×
This tells you there was substantial activity at higher prices, but price couldn't maintain the high.
Example — potential buying rejection
Lower Wick 50% Volume 2.5×
Price was pushed lower but recovered strongly.
Wicks become much more meaningful when accompanied by elevated volume.
🔥 Volume Ratio
This is one of the most important numbers.
It compares current volume with its normal volume.
Example
0.50×
Volume is roughly half normal.
1.00×
Normal participation.
1.50×
50% above normal.
2.00×
Twice normal volume.
3.00×
Extreme participation.
The key rule:
High volume does NOT automatically mean bullish.
It means:
Something significant is happening.
We then look at the candle to determine what price actually did with that participation.
📈 Volume Percentile
This answers a slightly different question:
How unusual is this volume compared with previous candles?
For example:
95% percentile
means current volume is unusually high compared with its historical distribution.
10% percentile
means volume is relatively quiet.
Example
Price suddenly falls with:
Volume Ratio: 2.4× Volume Percentile: 97%
That's a major participation event.
Now look at:
Body + Close + Wicks + Efficiency
to determine what that participation accomplished.
🚀 Volume Acceleration
This tells you whether participation is increasing or decreasing.
Example
0.8×
1.0×
1.3×
1.7×
2.1×
Volume is accelerating.
If price is simultaneously moving upward with strong candles, that can indicate expanding participation behind the move.
Conversely:
2.4×
2.0×
1.6×
1.2×
0.8×
Volume is fading.
If price continues moving but participation keeps disappearing, the move may be losing strength.
⚡ Range / ATR
This tells you how large the candle is compared with normal volatility.
Example
0.40
Small movement.
1.00
Normal movement.
2.00
The candle is approximately twice the normal ATR range.
A large range combined with high volume is much more significant than a tiny candle occurring on the same volume.
💥 Body / ATR
This focuses specifically on directional displacement.
A candle could have a large range because of huge wicks.
Body/ATR helps determine whether price actually travelled directionally.
Example A
Range/ATR = 2.0 Body/ATR = 0.3
Huge candle, but most of it was wick.
Example B
Range/ATR = 1.5 Body/ATR = 1.2
Most of the movement was genuine directional displacement.
That distinction is extremely important.
⚙️ Efficiency
Efficiency brings several of these ideas together.
It asks:
How effectively is the current volume producing price movement?
HIGH efficiency
Volume is producing substantial directional displacement.
MED efficiency
Some movement is occurring, but the signal is less decisive.
LOW efficiency
A lot of activity is producing relatively little directional movement.
Real-world examples
Example 1 — Strong bullish expansion
Direction BULL
Body % 85%
Close % 94%
Upper Wick 5%
Lower Wick 11%
Vol Ratio 2.3×
Vol Percentile 96%
Vol Accel UP
Range/ATR 1.7
Body/ATR 1.4
Efficiency HIGH
Reading:
Bullish direction + strong body + close near high + high volume + increasing participation + strong displacement.
This is a high-quality bullish expansion profile.
Example 2 — Weak bearish move
Direction BEAR
Body % 72%
Close % 67%
Vol Ratio 0.35×
Vol Percentile 8%
Vol Accel DOWN
Range/ATR 0.55
Body/ATR 0.40
Efficiency MED
Price is falling.
But participation is weak.
Reading:
Bearish price action, but little evidence of expanding participation behind the move.
This doesn't automatically mean bullish — it means the bearish move isn't strongly confirmed by volume.
Example 3 — High-volume rejection
Direction BULL
Body % 25%
Close % 58%
Upper Wick 62%
Vol Ratio 2.8×
Vol Percentile 98%
Vol Accel UP
Range/ATR 1.9
Body/ATR 0.35
Efficiency LOW
This is very interesting.
Huge volume.
Huge range.
But very little body.
And a massive upper wick.
Reading:
A lot of activity occurred, but price failed to maintain the move higher.
That is a very different market condition from a clean bullish expansion.
Example 4 — Quiet accumulation/absorption type behaviour
Direction BULL
Body % 30%
Close % 72%
Lower Wick 48%
Vol Ratio 2.2×
Vol Percentile 94%
Vol Accel UP
Range/ATR 1.4
Body/ATR 0.30
Efficiency MED
Price was pushed down, but recovered.
Volume is elevated.
The lower wick is large.
Reading:
Significant activity occurred at lower prices, but sellers failed to maintain control.
This is the sort of pattern where the relationship between volume + wick + close becomes much more informative than candle colour alone.
The golden rule of the table
Never read one row in isolation.
Instead, read it in layers:
1️⃣ Direction
Which way did price move?
↓
2️⃣ Body + Close
How decisively did it move?
↓
3️⃣ Wicks
Was there rejection?
↓
4️⃣ Volume Ratio + Percentile
Was there meaningful participation?
↓
5️⃣ Volume Acceleration
Is participation increasing or fading?
↓
6️⃣ Range/ATR + Body/ATR
How significant was the actual displacement?
↓
7️⃣ Efficiency
Did the volume actually accomplish much?
Multi-timeframe example
This is where the table becomes particularly powerful.
Imagine:
1H 15M 5M
Direction BULL BULL BEAR
Body % 82% 74% 65%
Vol Ratio 1.8× 2.1× 0.5×
Vol Accel UP UP DOWN
Efficiency HIGH HIGH MED
The 1H and 15M are showing strong bullish participation, while the 5M is currently pulling back on weak volume.
That tells a very different story from:
1H 15M 5M
Direction BEAR BEAR BEAR
Vol Ratio 2.1× 2.4× 2.7×
Vol Accel UP UP UP
Efficiency HIGH HIGH HIGH
Here, all three time frames are showing expanding bearish participation.
That's the real purpose of the table:
Don't just look at the colour of the candle. Look at what the market had to do to produce it.
Atlas Candle Volume Engine
Price tells you what happened. Volume tells you how much participation was involved. Candle structure tells you how that participation affected price. Efficiency tells you how much the market actually accomplished.
That combination is what makes the table useful as a standalone market-reading tool.
オープンソーススクリプト
TradingViewの精神に則り、このスクリプトの作者はコードをオープンソースとして公開してくれました。トレーダーが内容を確認・検証できるようにという配慮です。作者に拍手を送りましょう！無料で利用できますが、コードの再公開はハウスルールに従う必要があります。
免責事項
これらの情報および投稿は、TradingViewが提供または承認する金融、投資、取引、またはその他の種類の助言もしくは推奨であることを意図したものではなく、またこれらに該当するものでもありません。詳細は利用規約をご覧ください。
オープンソーススクリプト
TradingViewの精神に則り、このスクリプトの作者はコードをオープンソースとして公開してくれました。トレーダーが内容を確認・検証できるようにという配慮です。作者に拍手を送りましょう！無料で利用できますが、コードの再公開はハウスルールに従う必要があります。
免責事項
これらの情報および投稿は、TradingViewが提供または承認する金融、投資、取引、またはその他の種類の助言もしくは推奨であることを意図したものではなく、またこれらに該当するものでもありません。詳細は利用規約をご覧ください。