VSA Volume + Fibonacci (Volunacci)

Mar 13

Overview
This indicator combines Volume Spread Analysis (VSA) with Fibonacci levels to identify key price zones based on volume behavior. It helps traders determine potential support and resistance levels influenced by volume strength.

How It Works
Volume Calculation

The indicator calculates volume levels based on the selected timeframe.
It identifies high volume spikes and low volume dips, which are critical for detecting supply and demand shifts.
It uses a simple moving average (SMA) of volume to smooth fluctuations.
Fibonacci Levels Integration

When a high-volume event is detected, the indicator records the highest high and lowest low of that candle.
It then plots Fibonacci retracement and extension levels to highlight potential price reaction zones.
Negative Fibonacci levels are included to identify possible deep retracements.
Visual Features

The indicator adapts to both light and dark themes for better visibility.
Fibonacci lines are color-coded based on key retracement and extension levels.
A table displaying key Fibonacci levels and their corresponding prices is provided for quick reference.

Why Is This Indicator Useful?
It helps traders spot accumulation and distribution phases by analyzing volume at key price points.
The combination of VSA and Fibonacci allows traders to confirm trend strength and identify potential reversal points.
Works well for trend-following strategies, scalping, and breakout trading.
How to Use This Indicator?
Use it to confirm breakouts or reversals at Fibonacci levels when volume supports the move.
Watch for high-volume spikes near key Fibonacci zones—these can signal strong trend continuation or reversal.
Use the displayed Fibonacci table to quickly assess price reaction levels.
Credits
This script was inspired by the Hidden Gap’s VSA Volume indicator by HPotter and has been enhanced by integrating Fibonacci-based analysis.

Mar 20

Release Notes

Adding option to show labels on left or right + Adjust labels

Mar 20

Release Notes

ِAdd Skip Invalid Candles (open=close or high=low)? Option

Apr 8

Release Notes

Adding original code owner info to source code

Apr 12

Release Notes

Enhanced with customizable Moving Averages (up to 3 MAs with adjustable types, lengths, and colors).

Apr 12

Release Notes

Fix colors issues

Apr 22

Release Notes

# 📈 VSA Volume + Fibonacci (Volunacci) – Major Update 🚀
This update brings a massive upgrade to the original Volunacci script — combining smart Volume Spread Analysis with dynamic Fibonacci price/time levels, volume divergence detection, and multilingual tooltips. It’s built to empower technical traders with powerful visual insights and customizable tools.

---

## 🔧 What's New in This Version?

### 🧠 General Enhancements
- Added `max_bars_back`, `max_lines_count`, and `max_labels_count` for stability
- Introduced language selector (EN/AR) for tooltips
- Switched between Auto and Manual Fibonacci candle detection
- Added auto frame detection (Scalping / Swing / Long-Term)

### 🔢 Fibonacci Level Enhancements
- Toggle between basic or extended Fibonacci levels
- Customizable line width, color, and style
- Redraw levels after a defined number of bars (Refresh After)
- Labels can now be positioned left or right

### ⏰ Fibonacci Time Zones (NEW)
- Optional vertical projections based on Fibonacci number sequence (1, 2, 3, 5, ...)
- Shows time confluence labels when price intersects key time bars
- Fully multilingual tooltip support

### 📉 Volume Divergence Detection (NEW)
- Detects:
- Basic Bullish / Bearish Divergence
- Regular Divergence (lower low + rising volume)
- Hidden Divergence (trend continuation)
- Optional confirmation filters (Volume trend / RSI OB-OS)

### 📊 Dashboard Table (NEW)
- Summarizes:
- Closest Fibonacci Support / Resistance
- MA trend (Bullish / Bearish / Mixed)
- Volume Strength (Very High / Trap / Normal)
- Climax Candle status

### 📈 Moving Averages (Enhanced)
- Supports up to 3 customizable moving averages
- Syncs with selected time frame (scalping/swing/long-term)
- Trend bias detection using MA stacking order

### 🟩 Visual Markers
- Triangle markers for all detected Fibonacci candles
- Tooltips showing volume and candle index distance

---

## 📐 Gann Fan Integration Notice
This indicator includes a Gann Fan algorithm originally developed by **LonesomeTheBlue**.
The integration is made with respect to the author's original statement that the algorithm is free to use.
All credits for the Gann Fan logic go to the original developer.
Minor adjustments were made to match the layout and behavior of this combined VSA + Fibonacci indicator.
You can enable or disable the Gann Fan from settings.

---

## 🧠 Original Credits
- VSA Logic: Hidden Gap’s VSA Volume by HPotter
- Gann Fan: LonesomeTheBlue’s Gann Fan Script
- Modifications & Enhancements: tarekshaker1690
- License: MPL 2.0

---

## 🇸🇦 النسخة العربية

# 📈 مؤشر الفوليوم + فيبوناتشي (Volunacci) – تحديث شامل 🚀
هذا التحديث يُعد نقلة كبيرة في المؤشر الأصلي Volunacci، حيث يجمع بين تحليل الفوليوم الذكي (VSA)، ومستويات فيبوناتشي السعرية والزمنية، مع كشف الانفراجات الحجمية، ودعم كامل للغة العربية والإنجليزية.

---

## 🔧 الجديد في هذا التحديث

### 🧠 تحسينات عامة
- دعم `max_bars_back` وعدد الخطوط والليبلز لتحسين الاستقرار
- إضافة اختيار اللغة (عربي / إنجليزي) لشرح الإشارات
- إمكانية اختيار شمعة الفيبو يدويًا أو تلقائيًا
- دعم اختيار الإطار الزمني حسب نوع التحليل (سكالبينج، سوينج، طويل الأجل)

### 🔢 تحسين مستويات فيبوناتشي
- إمكانية عرض المستويات الأساسية فقط أو الموسعة
- تخصيص سمك الخط، لونه، ونمطه
- إعادة رسم المستويات تلقائيًا بعد عدد معين من الشموع
- اختيار موضع الليبلز (يمين أو يسار)

### ⏰ مناطق فيبوناتشي الزمنية (جديدة)
- رسم خطوط رأسية حسب تسلسل فيبوناتشي (1، 2، 3، 5...)
- كشف مناطق التقاء بين السعر والزمن
- دعم تولتيب متعدد اللغات لكل مستوى زمني

### 📉 كشف الانفراجات الحجمية (جديد)
- يدعم:
- الانفراج الأساسي (هبوطي / صعودي)
- الانفراج العادي (إشارة عكس)
- الانفراج المخفي (استمرار الاتجاه)
- مع إمكانية تفعيل شروط تأكيد إضافية مثل RSI

### 📊 لوحة معلومات ديناميكية (جديدة)
- تلخص:
- أقرب دعم ومقاومة فيبوناتشي
- الاتجاه بناءً على ترتيب المتوسطات المتحركة
- تقييم حجم التداول الحالي
- وجود شمعة كليماكس من عدمه

### 📈 المتوسطات المتحركة
- دعم حتى 3 متوسطات متحركة مع تخصيص كامل
- مزامنة تلقائية مع إطار التحليل المختار
- كشف الاتجاه بناءً على ترتيب المتوسطات

### 🟩 علامات بصرية
- رسم مثلثات على الشموع التي تم تحديدها كشموع فيبوناتشي
- عرض معلومات الحجم وموقع الشمعة تلقائيًا

---

## 📐 إشعار تكامل Gann Fan
يتضمن هذا المؤشر خوارزمية Gann Fan التي تم تطويرها في الأصل بواسطة **LonesomeTheBlue**.
تم دمج الخوارزمية باحترام كامل لتصريح المطور بأنها متاحة للاستخدام المجاني.
كامل الفضل يعود للمطور الأصلي لخوارزمية Gann Fan.
تم إجراء تعديلات طفيفة فقط لتتناسب مع تصميم وسلوك مؤشر VSA + Fibonacci.
يمكنك تفعيل أو تعطيل Gann Fan من الإعدادات.

---

## 🧠 الإشارات الأصلية
- منطق VSA: المؤشر الأصلي لـ Hidden Gap’s VSA Volume
- Gann Fan: سكربت LonesomeTheBlue
- تعديلات وتوسيع: tarekshaker1690
- الترخيص: MPL 2.0

Apr 22

Release Notes

// ✅ Added user-configurable table text size
// - Introduced input option: "Table Text Size" with Tiny, Small, Normal, Large

Release Notes

This update improves usability and clarity across all devices:

✅ Table repositioned to fit better on mobile screens.

🎨 Improved color scheme for better visibility in both Light and Dark modes.

🔺 Custom volume signal icons – choose your own shape, color, and symbol.

🌙 Dark Mode compatibility: table, labels, tooltips now adapt automatically.

📦 Minor UI polishing for cleaner look and smoother reading on all timeframes

Release Notes

Update Fib Time tooltips

Release Notes

Fix minor issue

Release Notes

Some minor fixes for large time frames

Release Notes

🆕 📐 Swing High/Low Detection [NEW]
Brand new module for detecting major pivots:

Auto-identifies swing highs and lows using left/right bar logic.

Dynamically draws levels on chart with realtime tracking.

Labels last pivot points + optional Fibonacci Retracement Levels:
→ 38.2%, 50%, 61.8%

Classifies market wave direction:
→ 📈 Uptrend, 📉 Downtrend, 🔁 Correction

🆕 🔔 Fibonacci Time Zone Alerts
Set automatic alerts when price reaches these projection zones:
1, 2, 3, 5, 8, 13, 21, 34 bars
Each with tooltip and colored labels.

🆕 🎯 Fibonacci Level Alerts
Alerts when price nears classic Fib levels:
🟢 Support: -161.8%, -61.8%
🟡 Retracement: 38.2%, 61.8%, 100%
🔴 Extensions: 161.8%, 261.8%, 423.6%

🆕 💣 Climax Candle Alerts
Get notified on extreme volume + strong move:

🟢 Bullish Climax

🔴 Bearish Climax

🆕 📈 MA Trend Alerts
Detect when moving averages align for:

📈 Bullish trend (stacked short to long)

📉 Bearish trend (stacked long to short)

🆕 📉 Volume Divergence Alerts
Covers all divergence types:

🟢 Basic Bull / 🔴 Basic Bear

🟢📈 Regular Bull / 🔴📉 Regular Bear

🟢🕵️ Hidden Bull / 🔴🕵️ Hidden Bear

🧠 All features come with multi-language tooltips and fully customizable inputs.

🆕 📐 اكتشاف القمم والقيعان [جديد]
نظام مدمج للتعرف على قمم وقيعان السوق:

يعتمد على عدد شموع من اليسار واليمين لتحديد القمة أو القاع.

يرسم خطوط ديناميكية على الشارت مع تحديث لحظي.

يعرض قيم آخر قمة وآخر قاع على الشارت.

يحسب مستويات تصحيح فيبوناتشي تلقائيًا:
→ 38.2% – 50% – 61.8%

يحدد اتجاه الموجة:
→ 📈 صعود، 📉 هبوط، 🔁 تصحيح

🆕 🔔 تنبيهات الفيبوناتشي الزمني
استقبل تنبيهات تلقائية عند الوصول للفترات التالية:
1، 2، 3، 5، 8، 13، 21، 34 شمعة
كل منطقة بلون مختلف وشرح دقيق داخل التولتيب.

🆕 🎯 تنبيهات اقتراب من مستويات فيبوناتشي
ينبهك عند اقتراب السعر من أهم مستويات الفيبوناتشي:
🟢 دعم: -161.8%، -61.8%
🟡 تصحيح: 38.2%، 61.8%، 100%
🔴 امتداد: 161.8%، 261.8%، 423.6%

🆕 💣 تنبيهات شموع الكليماكس
اشعار فوري عند ظهور شمعة بفوليوم ضخم واتجاه قوي:

🟢 كليماكس صاعد

🔴 كليماكس هابط

🆕 📈 تنبيهات الاتجاه حسب المتوسطات
ينبه عند ترتيب المتوسطات لتشكيل:

📈 اتجاه صاعد (متوسطات قصيرة أعلى الطويلة)

📉 اتجاه هابط (المتوسطات الطويلة أعلى القصيرة)

🆕 📉 تنبيهات الانفراجات في الحجم (Divergence)
يشمل جميع أنواع الدايفرجنس:

🟢 أساسي صاعد / 🔴 أساسي هابط

🟢📈 عادي صاعد / 🔴📉 عادي هابط

🟢🕵️ مخفي صاعد / 🔴🕵️ مخفي هابط

🧠 كل الميزات تأتي مع شرح مدمج (تولتيب) بعدة لغات، وإعدادات مرنة.