Volume Oracle v1.0
Advanced Learning Guide
Volume Flow Analysis • Regime Detection • Trading Psychology
⏱️ Reading Time: 14 minutes
🎯 Understanding What Volume Oracle Actually Tells You
Regime Background = Market Phase
- 🟢 Green Background: Accumulation regime: favor BULL signals
- 🔴 Red Background: Distribution regime: favor BEAR signals
- ⚪ Gray Background: Neutral regime: wait for direction
- 🟡 Gold Background: Weakening regime, so the regime in place is fading
Key Insight: Regime shows market phase. Signal quality (⭐ to ⭐⭐⭐) shows confluence strength. HTF alignment validates direction.
🚀 Your First Signal in 5 Minutes
Never used Volume Oracle before? Start here.
Step 1: Enable the Indicator
Load Volume Oracle on any timeframe (Daily recommended for beginners). Watch for background color changes (regime) and BULL/BEAR signal labels.
Step 2: Check the Regime
Look at the background color:
• Green = Accumulation (bullish): look for BULL signals
• Red = Distribution (bearish): look for BEAR signals
Step 3: Read the star band
• ⭐⭐⭐ (85 and above): the strongest agreement between the scored factors
• ⭐⭐ (75 to 84): most factors lined up
• ⭐ (65 to 74): enough to show, no more
• no star (under 65): the signal still fires and is still drawn
Step 4: Check HTF Alignment
Verify the higher timeframe regime agrees with your signal direction:
• BULL signal + HTF Accumulation = ✅ Aligned (stronger)
• BULL signal + HTF Distribution = ❌ Not aligned (weaker)
Step 5: Read what the marker records
Volume Oracle computes and draws its own reference levels. Record which ones were on screen when the signal printed.
Example: SPY 15m Chart
- Background: Green (Accumulation regime, 72% strength)
- 🟢 BULL ⭐⭐⭐ signal fires at $445.20
- HTF Check: 1H also in Accumulation ✅ Aligned
- The levels the indicator computed: entry $445.20, stop $443.50, first target $448.60
- Those come from the ATR at that moment, so a quieter day would produce a tighter set on the same signal
A one-star signal with the higher timeframe pointing the other way and a three-star signal with it pointing the same way are different readings. Both print as signals, and the difference is on screen before anything happens.
📋 The 3-2-1 Rule for Volume Oracle
Memorize This Framework
3 Things to ALWAYS Check:
- ✅ Regime Color: Green (Accumulation) for longs, Red (Distribution) for shorts
- ✅ Signal Quality: ⭐⭐⭐ = high confidence, ⭐⭐ = moderate, ⭐ = caution
- ✅ HTF Alignment: Higher timeframe regime matches signal direction
2 Things to NEVER Do:
- ❌ Never read a ⭐ signal as though it were a ⭐⭐⭐ (one star means the conditions barely cleared)
- ❌ Never ignore regime weakening (gold) (it is the earliest thing the regime meter says)
1 Golden Rule:
📌 Regime + Signal Quality + HTF = Confidence Level
Green regime + ⭐⭐⭐ BULL + HTF aligned is the best supported reading the indicator produces. Each missing factor is one fewer source agreeing.
🧠 Volume Trading Psychology: The 3 Critical Challenges
🟢 Challenge 1: Reading a Bottom-Band Signal Without Checking HTF Alignment
What Happens: A BULL ⭐ signal fires. You immediately buy, thinking "A signal is a signal!" Over the next few hours, price drops. You're confused and frustrated: "The signal fired but price went against me!"
Why This Happens: You're treating all signals equally. A ⭐ signal scored 65 to 74 and a ⭐⭐⭐ scored 85 or above, so they describe different amounts of agreement between the scored factors. Read as the same event, that difference is thrown away.
The Fix: record the band, every time. The star count is the indicator's own score put into bands, and a reading that leaves it out cannot be compared with the next one. We publish no accuracy figures by star count.
Mental Script: "Which band, and does the higher timeframe agree? Both are on screen before anything happens."
🚫 Challenge 2: Not Updating the Reading When the Regime Weakens
What Happens: A reading was made in a green regime. The background turns gold. The reading stays as it was, because it was a good reading when it was made and gold is only a shade away from green. Then the regime flips red, and the reading was describing conditions that stopped being on the chart several bars earlier.
Why This Happens: A reading you have written down feels finished. Gold is a revision, and revisions arrive after you have stopped looking.
What gold actually reports: the regime that was in place is losing strength. It is the earliest thing the regime meter says, and it says it before red. Treat it as the indicator updating its own reading, and update yours: note the bar it turned, what the star rating is now, and whether the higher timeframe still agrees.
Worth writing in the log: "Gold on this bar. The regime the reading was built on is fading. Re-read before anything else."
📈 Challenge 3: Not Reading What the Risk Levels Are Made Of
What Happens: A ⭐⭐⭐ BULL signal fires with Entry at $185.42 and Stop at $182.15. You ignore these levels and enter at $186.50, setting your own stop at $180. Price pulls back to $182.50 (above the indicator's stop) then rallies. But your wider stop and worse entry meant larger risk and smaller reward.
Why This Happens: You don't trust the auto-calculated levels or think you know better. Or you simply ignore the Risk Management display.
The Fix: read what each level is computed from, because that is what makes them comparable between one signal and the next:
- Entry: the price at which the signal's conditions were met
- Stop: a fixed multiple of ATR from there, 1.5 by default, so it is wider on a wild day and tighter on a quiet one
- T1 and T2: the same ATR, at 2.0 and 3.5 by default
All four are arithmetic on volatility, not a judgement about the market. Two signals with identical stars can carry very different distances, and the distance is the part that changes.
✅ Your First 3 Trades - Verification Checklist
Print This and Keep it Visible While Trading
Before Every Trade, Verify:
Trade #_____ (Date: ______)
- ☐ Regime checked (Green = longs, Red = shorts, Gray/Gold = wait)
- ☐ Star rating the signal carried ___
- ☐ Higher timeframe aligned, opposed, or neutral
- ☐ ATR distance between entry and stop on this signal ___
- ☐ How that distance compared with the last signal on this symbol
- ☐ Strategy mode the indicator was running in
After Your First 3 Trades, Review:
- Did I record the star rating, or only the direction? Y / N
- Did I check the higher timeframe? Y / N
- Did I note the distance between the computed levels? Y / N
- Did the three-star readings look different afterwards from the one-star ones? _______
- Did the aligned readings look different from the opposed ones? _______
Common Beginner Mistake: reading every signal as the same signal. The star rating is the indicator's own score band, 65 to 74 for one star and 85 or above for three, and it is printed next to every signal.
🚫 Top 5 Mistakes That Kill Volume Traders
Mistake #1: Ignoring Signal Quality Ratings
What Happens: A one-star BULL signal fires. You read it as a signal and stop there, without looking at the star count that is printed next to it. A one-star and a three-star signal go into your notes as the same event.
The Fix: the stars are the indicator's own score, banded. Record which band, every time:
- ⭐⭐⭐ (85 and above): the strongest agreement between the scored factors
- ⭐⭐ (75 to 84): most factors lined up
- ⭐ (65 to 74): enough to show, no more
The band is a description of the conditions, not a probability. We publish no win rates by star count, and you should be suspicious of anyone who does.
Mistake #2: Ignoring Regime Weakening (Gold Background)
What Happens: A reading is made in a green regime. The background turns gold. The reading is left alone as "just temporary". The regime then flips red, and the reading has been out of date since the gold bar.
The Fix: Gold is the regime meter revising itself before red arrives. When you see gold:
- Note the bar it turned on
- Re-read the star rating, which may have moved with it
- Check whether the higher timeframe still agrees
- Write the revised reading down rather than amending the old one
Gold arrives before red. It is the earliest revision the instrument offers.
Mistake #3: Trading Against HTF Alignment
What Happens: A BULL signal fires on your 15m chart. You buy without checking HTF. The 4H (higher timeframe) is in Distribution (red). Price drops immediately.
The Fix: check HTF alignment on every reading. The higher timeframe either agrees with the signal or it does not, and which one is on screen before anything happens:
- ✅ BULL with HTF Accumulation: aligned, so two timeframes describe one condition
- ❌ BULL with HTF Distribution: opposed, so the two timeframes disagree and the reading has one source, not two
- ⚪ BULL with HTF Neutral: the higher timeframe detected no direction, so it neither agrees nor disagrees
Mistake #4: Recording the Signal Without the Distances
What Happens: A signal fires with a computed entry at $185.42 and a stop at $182.15. You write down "BULL signal at 185". A month later the log cannot tell you whether that was a tight signal or a wide one, and the distance was the part that varied.
The Fix: the four levels are arithmetic on ATR, so the distance between them is a measurement of the day:
- Entry: the price where the signal's conditions were met
- Stop: a fixed ATR multiple from there, 1.5 by default
- T1 and T2: the same ATR at 2.0 and 3.5 by default
- Record the distance, not just the direction. Two identical-looking signals can be three times apart
Mistake #5: Wrong Strategy Mode for Market Conditions
What Happens: Market is choppy/ranging. You're in Trend Following mode. Signals fire but get stopped out repeatedly because there's no trend to follow.
Why This Happens: You didn't match the strategy mode to current market conditions.
The Fix: Choose the right strategy mode for the market:
- Trend Following: Best for trending markets, strong directional moves
- Mean Reversion: Best for ranging/choppy markets, reversal plays
- Hybrid: both signal types enabled at once. Trend Following is the default
- Review regime strength: >70% = trend likely, <50% = consider reversion mode
❓ Top 10 Questions from New Users
Quick Answers to Common Confusion
Q1: What do the star ratings mean?
A: The indicator scores each signal from 0 to 100 and bands it: ⭐⭐⭐ at 85 and above, ⭐⭐ at 75 to 84, ⭐ at 65 to 74, and no star below 65, where the signal still fires and is still drawn. More stars means more of the scored factors lined up, which is a description of the conditions rather than a probability.
Q2: What's the difference between regime colors?
A: Green = Accumulation (bullish), Red = Distribution (bearish), Gray = Neutral (no direction), Gold = Weakening (the regime in place is fading).
Q3: Does every signal carry the same weight?
A: No. A ⭐⭐⭐ with HTF alignment is the best supported reading the indicator produces. A ⭐⭐ says less without that alignment. A ⭐ means the conditions barely cleared the threshold, and on its own it is a thin reading.
Q4: What does HTF Alignment mean?
A: Higher TimeFrame check. If your 15m BULL signal has 4H also in Accumulation, that's "aligned" and stronger. If 4H is Distribution, that's "not aligned" and weaker.
Q5: What does a gold background report?
A: That the regime currently in place is losing strength. It is the earliest revision the regime meter makes, and it arrives before the flip to red rather than after it.
Q6: What do the strategy modes change?
A: Which conditions the indicator scores. Trend Following, the default, scores continuation. Mean Reversion scores a return toward the mean. Hybrid turns both signal types on rather than choosing between them. The mode changes what is being measured, so it changes what the stars mean.
Q7: How is position size calculated?
A: The indicator divides the Risk Amount you set by the distance to its computed stop. The output is arithmetic on two numbers you can see, one of which you chose, and it makes no judgement about whether either is sensible for you.
Q8: Do signals repaint?
A: No. Once a signal fires and conditions confirm at bar close, it remains fixed and does not change retroactively.
Q9: Can I use Volume Oracle on all assets?
A: Yes for stocks, futures, crypto. For forex spot (tick volume only), regime detection is less reliable: consider Harmonic Oscillator instead.
Q10: My own tracked results are worse than I expected. Where do I look first?
A: At what you recorded. Did you note the star band, or only the direction? Did you note whether the higher timeframe agreed? Did you note the ATR distance between the levels? Those three are what separate one signal on this indicator from another, and a log without them cannot answer the question.
📄 Printable Quick Reference Cheat Sheet
┌─────────────────────────────────────────────────────────────┐
│ VOLUME ORACLE QUICK REFERENCE │
│ (Save or Print This) │
├─────────────────────────────────────────────────────────────┤
│ │
│ ✅ A WELL SUPPORTED READING: │
│ • Regime matches signal (Green = BULL, Red = BEAR) │
│ • Star band ⭐⭐⭐ (85+) or ⭐⭐ (75-84) │
│ • Higher timeframe in the same regime │
│ • You noted the ATR distance between the levels │
│ │
│ ⚠️ A THIN READING: │
│ • Star band ⭐ (65-74), so it barely cleared │
│ • Higher timeframe in the opposite regime │
│ • Gray regime, meaning no direction was detected │
│ • Gold regime, meaning the current one is weakening │
│ │
│ REGIME COLORS: │
│ 🟢 GREEN = Accumulation (bullish) → Favor BULL signals │
│ 🔴 RED = Distribution (bearish) → Favor BEAR signals │
│ ⚪ GRAY = Neutral (wait for direction) │
│ 🟡 GOLD = Weakening (the current regime is losing force) │
│ │
│ SIGNAL SCORE BANDS: │
│ ⭐⭐⭐ = 85 and above → the strongest agreement │
│ ⭐⭐ = 75 to 84 → most factors lined up │
│ ⭐ = 65 to 74 → enough to show, no more │
│ │
│ 🎯 WHAT THE LEVELS ARE MADE OF: │
│ • Stop = 1.5 × ATR from entry, by default │
│ • T1 = 2.0 × ATR, T2 = 3.5 × ATR, by default │
│ • Size = the Risk Amount you set ÷ stop distance │
│ │
│ 🎓 THE 3-2-1 RULE: │
│ 3 to read: Regime, star band, HTF alignment │
│ 2 that get missed: a lone ⭐, a gold regime │
│ 1 to remember: three readings, not one number │
│ │
│ STRATEGY MODES: │
│ • Trend Following: Trending markets │
│ • Mean Reversion: Ranging markets │
│ • Hybrid: both types on (Trend Following is default) │
│ │
│ 💡 KEY INSIGHT: │
│ Upper star band + HTF aligned = more sources agree │
│ Gold regime = the regime in place is fading │
│ The indicator's levels are ATR arithmetic, not advice │
│ │
└─────────────────────────────────────────────────────────────┘
Keep this visible on your second monitor while reading!
🎓 Your Learning Journey - Success Milestones
You're Progressing When You See These Signs
📅 Week 1: Recognition Phase
- ✅ You understand the 4 regime colors (Green, Red, Gray, Gold)
- ✅ You can identify signal quality ratings (⭐ to ⭐⭐⭐)
- ✅ You're checking HTF alignment on every reading
- ✅ You understand gold = the regime in place is fading
- ✅ You can say what the Entry, Stop, T1 and T2 levels are computed from
📅 Week 2-4: Execution Phase
- ✅ You check regime and star band without having to remind yourself
- ✅ You can spot regime transitions (green → gold → red)
- ✅ You're reading ⭐⭐⭐ and ⭐⭐ signals with HTF alignment closely, and the rest briefly
- ✅ You note the indicator's Entry, Stop and Target levels as part of every reading
- ✅ You're reading fewer signals and finishing each one
📅 Month 2+: Mastery Phase
- ✅ Your reading of a regime stops changing when you look again the next day
- ✅ You can see the components softening before the background turns gold
- ✅ You're combining Volume Oracle with other indicators (Janus levels, Pentarch cycles)
- ✅ You understand strategy modes and switch based on market conditions
- ✅ You read the star band first, and let it set how much attention the rest gets
🚨 Warning Signs (You Need to Review the Guide):
- ❌ You're reading ⭐ signals as though they were ⭐⭐⭐
- ❌ You're ignoring HTF alignment checks
- ❌ You're reading signals in a neutral (gray) regime as though the regime agreed
- ❌ You're leaving a reading unchanged after the background turns gold
- ❌ You still cannot say what star band your last ten signals carried
Remember: The star band is a count of conditions met, so a ⭐⭐⭐ with HTF alignment and a ⭐ without it are two very different readings wearing the same shape. Read the band first, the regime second, and the alignment third. The Entry, Stop and Target levels are ATR arithmetic printed alongside, and they describe distance, not a decision.
🔗 Synergy: Pairing Volume Oracle with Other Indicators
🎯 High Synergy Combinations
- + Pentarch: the regime and the Exhaustion Counter read together. A BULL ⭐⭐⭐ on a Count 9 bar is a volume reading and a cycle reading describing the same bar.
- + OmniDeck: two regime readings from different instruments. When they agree, one more source is saying the same thing.
- + Janus Atlas: a signal landing on a level cluster rather than in open space. The distance to the nearest level is the part that varies between one signal and the next.
🎲 Common Trading Combinations
- BULL ⭐⭐⭐ with a Pentarch Count 9 Buy → the top star band on a bar the counter also marked
- BEAR ⭐⭐⭐ + Janus resistance cluster → the top star band on a bar sitting at a tested level
- Regime Weakening (gold) + OmniDeck Regime red → Multi-indicator exit warning
💡 Why These Pair Well
Volume Oracle provides DIRECTION (regime) and QUALITY (signal ratings). Pentarch/OmniDeck provide TIMING (cycles). Janus provides LEVELS (price). Risk Management provides EXECUTION (Entry/Stop/Targets).
Read together they cover four separate readings: what the score counted, where the level sits, where the cycle stands, and what arithmetic the risk lines used.
Educational only. Trading involves substantial risk of loss. Not financial advice. Past performance does not guarantee future results.