Trend Velocity Voyager

This Pine Script (version 6) defines a custom TradingView indicator called "Trend Velocity Voyager." It's an overlay indicator (meaning it plots directly on the price chart) designed for trend detection and trading signals. The indicator combines adaptive volatility-based periods, ATR (Average True Range) channels, EMA (Exponential Moving Average) crossovers, RSI (Relative Strength Index) divergences, and smoothed moving averages to identify trends, reversals, potential tops/bottoms, and micro-trends. It incorporates a bias toward bearish entries (easier to enter downtrends) and uses higher-timeframe (HTF) data for color-coded caution signals. The main output is a smoothed trend line with dynamic colors, optional micro-trend dots, bar coloring, and labels for key events like reversals, tops, and bottoms.The script emphasizes adaptability to market volatility (shorter periods in high volatility for faster responses) and uses ratcheting mechanisms to "lock in" trends, making it suitable for trend-following strategies in volatile markets like stocks, forex, or crypto.

Key InputsUsers can customize the indicator via these parameters:

Base Trend Length (default: 14): Base period for calculations like ATR and KAMA.
Enable AI-Adaptive Periods (default: true): Toggles volatility-based adjustment of periods (shorter in high vol for quicker reactions).
ATR Multiplier (default: 1.5): Scales the ATR to widen/narrow the up/down channels.
Show Micro Trend Dots (default: false): Toggles display of a dotted line for short-term ("micro") trends.
HTF for High Trend (default: "1W" or weekly): Higher timeframe for incorporating macro trend data into coloring.
RSI Length for Tops (default: 14): Period for RSI used in divergence detection.
Smoothing Length (default: 20): Period for smoothing micro-trend calculations.
Main Line Smoothing Length (default: 3): Additional smoothing applied to the main trend line.
Colors: Up Trend (green), Caution (yellow), Down Trend (red) — used for the main line and bars.

Visual Outputs

Main Plot: A single smoothed trend line (linewidth 2) with dynamic colors:Green: Strong uptrend (trendDir=1 and close > HTF KAMA).
Yellow: Cautionary uptrend (trendDir=1 but close ≤ HTF KAMA).
Red: Downtrend (trendDir=-1).

Micro Trend Dots: Optional line showing ultra-smoothed short-term trend (lime up, maroon down).
Bar Coloring: Green (up), red (down), gray (neutral) for quick visual trend overview.
Labels (transparent background, large size, positioned left of bar):"R" (yellow): Reversal signals on EMA crossovers (bullish: below low; bearish: above high).
"T" (purple): Potential top on RSI bearish divergence (above high).
"B" (blue): Potential bottom on RSI bullish divergence (below low).

Usage Notes

Strategy Fit: Best for trend-following; buy above the line in green, sell below in red. Caution (yellow) signals potential weakness in uptrends. Labels highlight entry/exit points.
Strengths: Adaptive to volatility, ratcheting reduces false signals, multi-timeframe adds context, divergences catch reversals.
Limitations: May lag in ranging markets due to heavy smoothing; RSI divergences can false-positive in strong trends.
Customization: Toggle adaptive mode for choppy vs. trending assets; adjust multiplier for sensitivity; use HTF for longer-term bias.