OPEN-SOURCE SCRIPT

Compass | Anonycryptous

1 073
Compass | Anonycryptous
Description & user manual

Credits
The weekly psychological level calculation in this indicator is based on open-source code originally published on TradingView. The original script was created by plasmapug. Continued development was done by infernixx, Peshocore, and xtech5192 in collaboration with TradersReality. Significant modifications have been made to integrate this component into the Compass framework.

Why this indicator is different
Most indicators answer one question. A moving average tells you the trend direction. An oscillator tells you momentum. A session box tells you the time. A volume indicator tells you participation. Each one is useful. None of them tells you where you are.
Before placing a trade, a trader needs to answer several questions simultaneously. What session is active and what does that mean for the type of price action to expect? Where does the macro trend stand? Is volume confirming the move or contradicting it? Are there open imbalances nearby that price may return to? How much of the day's expected range has already been consumed? Where are the key structural levels — pivots, the daily open, prior week references?
Answering each of these questions separately requires stacking tool after tool until the chart becomes unreadable. Compass answers all of them at once.
It is not a signal indicator. It does not fire arrows or tell you when to buy or sell. What it does is something more fundamental: it gives you a complete read of the market environment before any decision is made. Sessions, trend, volume, imbalances, range levels, pivots, psychological references — all in one overlay, all configurable, all on one chart.
The design philosophy is orientation first. Decision second. Compass tells you where you are. What you do with that is your responsibility.

Important notice
Compass does not generate trading signals.
It does not tell you when to buy or sell.
It does not predict market direction.
It does not replace your trading strategy or your own analysis.
All illustrative examples in this manual are for educational purposes only and are not trading recommendations.
All trading decisions remain entirely with the user.
Always apply your own judgment and manage your own risk.

1. Overview
Compass is a comprehensive market context indicator that combines eleven independent analysis frameworks into one unified overlay. Every component is individually toggleable. Six presets are included for different trading styles, from fast scalping to full multi-component analysis.

What it includes:
- Five-EMA suite with adaptive cloud around the EMA 50
- EMA crossover system with configurable signals and candle coloring
- Stochastic RSI background alerts with four alert types and RSI divergence detection
- PVSRA volume vector candle analysis with zone tracking and configurable thresholds
- Eight global market sessions with automatic DST awareness
- Average daily, weekly, and monthly range levels with 50% midpoints
- Classic pivot points with mid-point levels
- Daily open reference line with historical opens
- Fair value gap detection with partial absorption tracking
- Weekly psychological level tracking
- Live dashboard with eighteen data points across all active components

2. EMA suite
Five exponential moving averages are plotted simultaneously: EMA 5, EMA 13, EMA 50, EMA 200, and EMA 800. Together they cover short-term momentum, medium-term trend direction, macro trend, and long-term structural bias.
The EMA 50 is wrapped in a dynamic cloud calculated from two standard deviations of price. The cloud expands during volatility and contracts during consolidation. A widening cloud indicates active price discovery. A thinning cloud indicates equilibrium or compression before a directional move.
The EMA 200 is the primary macro bias filter. Price above it defines a broadly bullish environment. Price below it defines a broadly bearish environment. This is shown in the dashboard at all times.
The EMA 800 provides long-term structural context, particularly useful on mid to higher timeframes where it marks the gravitational center of multi-month price structure.
All five EMA lengths are configurable. Each has individual color and transparency controls. An EMA label option displays the current value at the right edge of each line.

3. EMA cross system
The EMA cross tracks a configurable fast EMA crossing a configurable slow EMA and marks the crossover bar. All candles after a cross continue in the direction of that cross until the opposite cross fires.
Three display modes are available: show both the fast and slow EMA lines, show a single consolidated EMA line, or hide the EMA lines entirely while keeping the crossover signals visible.
This component is a trend state indicator, not a trade trigger. A bull cross does not mean buy. It means the short-term trend has shifted upward relative to the medium-term average.
Signals and candle coloring can be toggled independently.

4. Stochastic RSI
The stochastic RSI component runs a standard stochastic RSI calculation and generates background color alerts based on crossover conditions at configurable band levels.
Four alert types are available, each independently toggleable:
Middle band crossover — K line crosses D line near the 50 level. Indicates a possible trend shift in momentum.
Overbought/oversold crossover — K line crosses D line from overbought or oversold territory. Indicates a potential reversal from an extreme.
Entering overbought — K line crosses above the upper band. Indicates that momentum has moved into overbought territory.
Entering oversold — K line crosses below the lower band. Indicates that momentum has moved into oversold territory.
The dashboard displays the current stochastic RSI state and the RSI value. RSI appears in green when above the midline and in red when below. Regular bullish and bearish divergence is detected automatically and shown in the dashboard as a directional label. When divergence is active, a thin reference line appears on the price chart marking the divergence candles.

5. PVSRA volume vector analysis
PVSRA analysis colors candles based on volume relative to the 10-bar average and the relationship between volume and candle spread.
Four vector types:

Green vector — bullish bar where volume is at or above the green/red threshold (default 200% of the 10-bar average), or where volume multiplied by spread is the highest of the last 10 bars. Indicates strong bullish institutional participation.
Red vector — same conditions on a bearish bar. Indicates strong bearish institutional participation.
Blue vector — bullish bar where volume is at or above the blue/violet threshold (default 150% of average). Indicates elevated bullish volume below the institutional threshold.
Violet vector — same conditions on a bearish bar. Indicates elevated bearish volume.
Grey — no vector conditions met. Normal volume.
Both thresholds are configurable directly from the settings panel. Blue and violet signals are strictly exclusive from green and red — a bar cannot qualify for both simultaneously.
Vector candle zones draw boxes at each vector candle location and remain active until price moves through the zone, marking areas where elevated institutional activity was detected at the time the candle formed.
The PVSRA override input allows a different symbol to be used for the volume calculation. This is useful when the charted instrument has unreliable volume data, such as CFDs, perpetual swaps, or instruments where the primary volume is on a related market.

6. Market sessions
Eight global trading sessions are tracked simultaneously, each with automatic DST awareness. Sessions are displayed as expanding boxes with high and low lines and a real-time label showing the session open.
Sessions included:
- London: 08:00–16:30 UTC
- New York: 14:30–21:00 UTC
- Tokyo: 00:00–06:00 UTC
- Hong Kong: 01:30–08:00 UTC
- Sydney: 22:00–06:00 UTC
- EU brinks: 08:00–09:00 UTC
- US brinks: 14:00–15:00 UTC
- Frankfurt: 07:00–16:30 UTC

DST is handled automatically for London, New York, and Sydney. No manual adjustment is needed. Each session can be toggled individually, and box color, transparency, and label color are fully configurable per session.
Session context matters because market behavior differs significantly depending on which participants are active. London and New York overlap produces the highest volume and fastest price movement. Tokyo and Sydney sessions tend to consolidate. The brinks windows mark the transition periods where session highs and lows often form.

7. Range levels
Three statistical range frameworks measure the expected price range for the current period based on historical averages.
Average daily range (ADR) — the expected high and low for the current trading day. When price reaches the ADR level, the day's expected range has been consumed. Moves beyond the ADR are extension moves that occur with lower statistical probability and often mean-revert. The dashboard shows ADR % used — how much of today's expected range has already been consumed. Above 80% indicates the day is approaching its expected limit.
Average weekly range (AWR) — the same concept applied to the current week. Useful for assessing how much room the week has left to move.
Average monthly range (AMR) — the same concept applied to the current month. Provides macro context for position sizing and target expectations.
Each framework includes a 50% midpoint level marking the center of the expected range. The ADR measure from daily open option calculates the range starting from that day's open price rather than the statistical high, making the levels static for the entire day.
All three frameworks have individual lookback period inputs, color controls, line styles, and label toggles.

8. Pivot points
Classic pivot points are calculated from the prior day's high, low, and close. Levels include PP, R1/S1, R2/S2, R3/S3, and M mid-point levels between each major level.
Pivot points provide structural reference for the current session. Price above PP defines a broadly bullish day structure. R levels act as potential resistance targets. S levels act as potential support targets. M levels provide intermediate precision references between major pivots.
All levels can be toggled individually. Lines extend rightward from the prior session and can optionally extend in both directions. Each level has individual color and line style controls.

9. Daily open
A horizontal line marks the current day's opening price. This is one of the most referenced structural levels among short-term traders because it defines the starting point for the day's price discovery.
Price above the daily open reflects a bullish session bias. Price below reflects a bearish session bias. When price oscillates around the daily open without committing direction, the session is in balance — a lower probability environment for trend trades.
Historical daily opens can optionally be shown as reference for prior day context.

10. Fair value gaps
A fair value gap is a three-bar imbalance where price moved through a range without leaving two-sided trade — the low of the upper candle is above the high of the lower candle (bullish gap) or vice versa (bearish gap). These areas represent unfinished business where the market may return to achieve balance.
Gaps are filtered by a minimum width threshold expressed as a multiple of ATR. Gaps narrower than the threshold are excluded. Partial absorption is tracked — as price returns into the gap, the fill color changes to show how much of the imbalance has been recovered.
Fully mitigated gaps can be kept on the chart as historical reference or deleted automatically to maintain a clean view.

11. Psychological levels
Weekly psychological levels mark the prior week's high and low as calculated by a specific session-anchored method. These levels represent deliberate structural references where participants have previously committed size — breakouts and rejections around these levels tend to be more intentional than random price noise.
Three GMT offset options accommodate the session anchor calculation for different global market structures. Two mode options are available: crypto (weekly reset on Saturday Sydney open) and forex (weekly reset on Monday Tokyo open).

12. Settings reference
Preset
- Custom: full manual control over all settings.
- Clean scalper: sessions, EMA suite, FVG, subtle candle coloring. Low noise.
- Full context: everything on, medium transparency. Best for analysis.
- Signal focus: EMA cross, stoch RSI background, PVSRA bar color prominent. Rest subtle.
- Minimal: sessions, daily open, ADR only. No signals.
- PVSRA pro: PVSRA and vector candle zones central. EMA 200 and 800 only.

Global settings
- Master opacity offset (custom preset only): shifts all transparency values simultaneously.
- Show bull/bear label text: shows or hides text on EMA cross signal triangles.

EMA suite
- Show EMA suite and labels
- Individual EMA color and transparency controls
- EMA cloud fill and border transparency
- EMA line width

EMA cross
- Show EMA cross signals
- Fast EMA, slow EMA, and consolidated EMA lengths
- Show both EMAs or consolidated only
- Bull, bear, and neutral colors and transparency
- Cross EMA line width

Stochastic RSI
- Show stochastic RSI background alerts
- RSI length and stochastic length
- Overbought and oversold band levels
- Individual alert type toggles (four types)
- Alert colors and transparency
- RSI divergence lookback period
- Divergence line color and width

PVSRA
- Vector colors (red, green, violet, blue, regular up/down)
- Green/red threshold (× average volume, default 2.0)
- Blue/violet threshold (× average volume, default 1.5)
- Include spread filter for green/red classification
- Override symbol toggle and input
- Show vector candle zones with transparency and width settings

Candle coloring
- Enable candle coloring
- Coloring mode: EMA cross / PVSRA / EMA 200 / off
- Bull and bear candle color and transparency

Market sessions
- Show market sessions
- Session timezone
- Show sessions on weekends
- Session high/low line style and width
- Per session: toggle, box color, transparency, label color

Range levels
- Show ADR, AWR, AMR (individual toggles)
- Lookback periods for each
- Show 50% midpoint levels
- Measure from daily open (ADR only)
- Color, transparency, line width, line style, labels

Pivot points
- Show PP, R1/S1, R2/S2, R3/S3, M levels individually
- Show labels
- Extend lines both directions
- Individual level colors and line styles
- Pivot line width

Daily open
- Show daily open
- Show label
- Show historical daily opens
- Color, transparency, line width

Fair value gaps
- Show fair value gaps
- Width filter (ATR multiplier)
- Extend to current bar
- Bullish and bearish FVG colors
- Mitigation fill colors
- Keep historical FVGs after mitigation

Psychological levels
- Show psy levels and labels
- Show historical psy levels
- GMT offset (GMT+1, GMT+2, GMT+3)
- Psy type: crypto or forex
- High and low colors and transparency

Dashboard
- Show dashboard
- Position: top left, top right, bottom left, bottom right
- Size: tiny, small, normal

13. Dashboard reference
The dashboard provides eighteen live data points across all active components:
Session — the currently active market session.
EMA cross — current EMA cross direction: bull or bear.
EMA 200 — whether price is above or below the EMA 200.
Stoch RSI — current stochastic RSI condition.
RSI — current RSI value, colored green above midline and red below.
RSI divergence — active bullish or bearish divergence, or none.
PVSRA — current candle vector type.
ADR % used — how much of today's expected daily range has been consumed.
FVG active — count of open unmitigated fair value gaps and mitigation percentage.
Psy level — whether price is above or below the prior week's psychological level.
Timezone — active session timezone setting.
VCZ active — count of active vector candle zones above and below current price.
Pivot PP — current pivot point value.
Daily open — current daily open price and direction.

14. How to use
14.1 Initial setup
Select a preset that matches your primary trading style. Adjust the session timezone to match your location or your primary exchange. If you trade an instrument with unreliable volume data, enable the PVSRA override and set it to a correlated liquid instrument. Set the ADR lookback period to your preference — 14 days is a standard starting point. For FVGs, set the width filter to 0.5 or higher to exclude minor gaps.

14.2 Reading the dashboard
The dashboard is the fastest way to orient yourself on a new chart or a new session. Check session, EMA cross direction, EMA 200 position, stoch RSI state, and ADR consumed before anything else. Five seconds to a full picture of where the market stands.

14.3 Reading the chart
Check EMA alignment. When EMA 13, EMA 50, and EMA 200 are stacked in the same direction, the trend is more significant than a single crossover. Divergence between them reflects a transition or competing timeframe pressures.
Check ADR percentage. Below 50% means the day has statistical room to move. Above 80% means the day is near its expected limit and extension moves are less probable.
Look for open FVGs near current price. An unmitigated FVG in the direction of the prevailing trend is a precision reference area where price has historically returned.
Check the psy level. If price is approaching the prior week's high or low, be aware that participant behavior around those references tends to be deliberate.

14.4 Timeframe guide
1 minute to 3 minutes — clean scalper preset, candle coloring set to EMA cross.
5 minutes to 15 minutes — clean scalper or signal focus preset.
30 minutes to 1 hour — full context preset, use ADR and pivot points.
4 hours to daily — full context or minimal preset.

14.5 Tips
PVSRA override — use when your broker's volume data is unreliable, when you trade a CFD or derivative with synthetic volume, or when you want spot market volume for a futures chart.
Master opacity offset — adding 10 to 20 increases overall transparency and dims the chart if it feels cluttered. Subtracting 10 to 20 makes all elements more prominent. This shifts all transparency values simultaneously without changing individual settings. Only active in custom preset.
Not every component needs to be active at once. Most traders will find three to four components provide the context they need for their specific setup.

15. Disclaimer
This indicator is provided for educational and informational purposes only.
Nothing in this document constitutes financial advice or any form of trading recommendation.
Trading financial instruments involves substantial risk of loss.
Past performance is not indicative of future results.
You may lose all of your invested capital.
All trading decisions are made entirely by the user.
Use at your own discretion.

Feragatname

Bilgiler ve yayınlar, TradingView tarafından sağlanan veya onaylanan finansal, yatırım, alım satım veya diğer türden tavsiye veya öneriler anlamına gelmez ve teşkil etmez. Kullanım Koşulları bölümünde daha fazlasını okuyun.