PulseHub
OPEN-SOURCE SCRIPT

Macro Liquidity Waterfall Board [The_lurker]

2 176
Macro Liquidity Waterfall Board لوحة شلال السيولة الكلّية

An integrated monitoring board for the state of macro liquidity across global markets, built to answer one question with precision and clarity: where is liquidity positioned right now, and which market sectors are moving with it?

Unlike traditional liquidity indicators that compress the entire picture into a single composite number that hides its sources, this board displays liquidity as a transparent, interconnected system: every data source is visible, every information channel is separate, and every component can be traced back to its origin. The result is a complete view of the macro context in a single board, instead of scattered numbers across several tools.


🏛️ HIERARCHICAL LIQUIDITY STRUCTURE

The board displays liquidity as a tree flowing top to bottom, revealing how it propagates across market levels:

snapshot

▸ Level 1 — Global Liquidity
Net liquidity is computed from the standard accounting identity: the Federal Reserve balance sheet, minus reverse repo agreements and the Treasury General Account, with an optional M2 money supply component. This is the primary engine from which the rest of the system branches.

snapshot

▸ Level 2 — Asset Classes
Bonds, stocks, crypto, stablecoins, gold, and oil — each as an independent node showing its relative position within the broader landscape.

snapshot

▸ Level 3 — Crypto Assets
Customizable individual coins (Bitcoin, Ethereum, Ripple, altcoins) with each one's allocation share within the crypto sector.


📊 SEPARATE INFORMATION CHANNELS

The governing design principle: no single composite number that hides the source. Each node displays its channels separately, so the trader sees why liquidity is moving, not merely that it is moving:

snapshot

◆ Value and Change
The current magnitude and its percentage change over the selected period.

snapshot

◆ Z-Score
The position of the current move against its historical distribution, using either standard or outlier-resistant scaling.

snapshot

◆ Freshness Indicator
A colored dot revealing data age (live / delayed / stale), so you never unknowingly rely on outdated data.

◆ Relative Performance
Each node's color reflects its position against the class average: relatively outperforming or underperforming.

snapshot

◆ In-Card Sparkline
The recent value trajectory inside each card at a glance.

snapshot

💧 ACCOUNTING WATERFALL PANEL

The most precise element on the board, and the only real flow it displays: the decomposition of the change in global liquidity into its contributing components (Fed, reverse repo, Treasury) via an exact accounting identity — so you see exactly which source injected liquidity and which drained it, in actual dollar figures, with stale components flagged automatically.


⚙️ ANALYTICAL ENGINES

▸ Regime State Classification
The board classifies the instantaneous relationship between liquidity direction and crypto direction into four clear states:

• Concurrent Expansion — liquidity and price rising together
• Liquidity Without Price — liquidity rising while price lags
• Unsupported Rally — price rising without liquidity support
• Concurrent Contraction — liquidity and price falling together

Along with the current state's age against its historical median, so you know whether the present regime is within its usual duration or has stretched unusually long.

▸ Crypto Breadth
A cross-sectional measure revealing how many crypto assets are actually moving with the direction of liquidity. High breadth means a broad, reliable regime signal; low breadth means movement driven by one or two names — an essential distinction that guards against reading a narrow signal as a general trend.

▸ Hypothesis-Validity Line
A rolling correlation coefficient between liquidity and crypto changes, revealing when the liquidity-market relationship is currently active and when it breaks down — an honesty gauge that prevents blind reliance on the liquidity narrative when it isn't holding.

▸ Edge-Triggered Alerts
Alerts fire on state change only — no repetition, no noise. The board monitors the system on your behalf and notifies you at regime transitions, or when a data gap is detected.

snapshot

▸ Timeline Ribbon

A row of colored cells showing the regime path across recent periods, so you read the state history at a single glance. Each cell's color reflects that period's state: teal for expansion, red for contraction, amber for divergence (liquidity without price, or an unsupported rally), and gray for the neutral state.

🎯 NATURE AND USE

This board is a concurrent macro-context awareness tool — designed to build a deep understanding of the current liquidity environment before making a decision, not to time specific entry or exit moments. Its natural place in any trader's system is the top layer: reading the general liquidity regime and macro context, upon which precise timing decisions are built with other tools. It answers the question: what is the macro market environment today? with depth and clarity.


🔧 TECHNICAL NOTES

◆ Inter-class flow is a relative representation, not a direct measurement — trading platforms do not provide cross-asset order flow; class color shows relative performance against the average, while the real accounting flow appears in the waterfall panel exclusively.

◆ Required data sources — FRED economic data, CRYPTOCAP, TVC, and NASDAQ; please confirm their availability within your subscription.

◆ Unit calibration — default settings are tuned for raw quoting; check the data window if a unit warning appears, to calibrate the sources.

◆ Context calibration — regime duration metrics and thresholds are built on recent market data, and may require review when the broad macro environment changes.

◆ Technical commitments — no repainting · confirmed data only · a one-period delay is intentional by design to prevent future leakage · efficient per-bar computation.

═════════════════════════════════════════════════════════════
⚠️ DISCLAIMER
═════════════════════════════════════════════════════════════

This indicator is for educational and analytical purposes only. It does not constitute financial, investment, or trading advice. Use it alongside your own strategy and risk management. Neither PulseWire nor the developer is responsible for any financial decisions or losses.

══════════════════════════════════════════════════════════
══════════════════════════════════════════════════════════

Macro Liquidity Waterfall Board لوحة شلال السيولة الكلّية


لوحة رصد متكاملة لحالة السيولة الكلّية عبر الأسواق العالمية، مصمّمة لتُجيب سؤالًا واحدًا بدقّة ووضوح: أين تتموضع السيولة الآن، وأيّ قطاعات السوق تتحرّك معها؟

على عكس مؤشرات السيولة التقليدية التي تختزل الصورة كلّها في رقم واحد مركّب يُخفي مصادره، تعرض هذه اللوحة السيولة كمنظومة مترابطة شفافة: كل مصدر بياناته مرئي، كل قناة معلومات منفصلة، وكل مكوّن يمكن تتبّعه إلى أصله. النتيجة صورة كاملة للسياق الكلّي في لوحة واحدة، بدل أرقام متناثرة عبر عدّة أدوات.


🏛️ البنية الهرمية للسيولة

تعرض اللوحة السيولة كشجرة تتدفّق من الأعلى إلى الأسفل، تكشف كيف تنتقل عبر مستويات السوق:

snapshot

▸ المستوى الأول — السيولة العالمية
يُحتسب صافي السيولة من الهوية المحاسبية القياسية: الميزانية العمومية للاحتياطي الفدرالي، مطروحًا منها اتفاقيات إعادة الشراء العكسية وحساب الخزانة العام، مع خيار إدراج المعروض النقدي M2. هذا هو المحرّك الأساسي الذي تتفرّع منه بقية المنظومة.

snapshot

▸ المستوى الثاني — فئات الأصول
السندات، الأسهم، الكريبتو، العملات المستقرة، الذهب، والنفط — كل فئة كعقدة مستقلّة تُظهر موقعها النسبي داخل المشهد الكلّي.

snapshot

▸ المستوى الثالث — أصول الكريبتو
عملات فردية قابلة للتخصيص (بيتكوين، إيثريوم، ريبل، البدائل) مع نسبة التخصيص لكل منها داخل قطاع الكريبتو.


📊 قنوات المعلومات المنفصلة

المبدأ التصميمي الحاكم: لا رقم مركّب واحد يُخفي المصدر. كل عقدة تعرض قنواتها منفصلة، فيرى المتداول لماذا تتحرّك السيولة لا مجرّد أنها تتحرّك:

snapshot

◆ القيمة والتغيّر
الحجم الحالي ونسبة تغيّره عبر الفترة المختارة.

snapshot

◆ الدرجة المعيارية (Z-Score)
موقع الحركة الحالية مقابل توزيعها التاريخي، بمقياس قياسي أو مقاوم للقيم الشاذّة.

snapshot

◆ مؤشر حداثة البيانات
نقطة ملوّنة تكشف مدى حداثة بيانات كل مصدر (حديثة / متأخّرة / قديمة). بعض المصادر تتحدّث بترددات مختلفة — بيانات الفدرالي أسبوعية، والمعروض النقدي شهري، بينما الكريبتو لحظي — فيكشف هذا المؤشر أيّ الأرقام على اللوحة حيّة الآن وأيّها قديم، حتى لا تبني قرارًا على قيمة لم تُحدَّث منذ فترة.

◆ الأداء النسبي
لون كل عقدة يعكس موقعها مقابل متوسط الفئات: متفوّقة أم متخلّفة نسبيًا.

snapshot

◆ الخط البياني المصغّر
مسار القيمة الأخير داخل كل بطاقة بلمحة.

snapshot

💧 لوحة الشلال المحاسبي

العنصر الأكثر دقّة في اللوحة، ويعرض التدفّق الحقيقي الوحيد فيها: تفكيك تغيّر السيولة العالمية إلى مكوّناته المساهِمة (الفدرالي، إعادة الشراء العكسية، الخزانة) بهوية محاسبية دقيقة — فترى بالضبط أيّ مصدر ضخّ سيولة وأيّها سحبها، بأرقام دولارية فعلية، مع تمييز المكوّنات القديمة تلقائيًا.


⚙️ المحرّكات التحليلية

▸ تصنيف حالة النظام
تُصنّف اللوحة العلاقة اللحظية بين اتجاه السيولة واتجاه الكريبتو إلى أربع حالات واضحة:

• توسّع متزامن — السيولة والسعر يرتفعان معًا
• سيولة بلا سعر — السيولة ترتفع بينما السعر يتخلّف
• رالي غير مدعوم — السعر يرتفع دون دعم السيولة
• انكماش متزامن — السيولة والسعر ينخفضان معًا

مع عمر الحالة الحالي مقابل وسيطها التاريخي، فتعرف إن كان النظام الراهن ضمن مدّته المعتادة أم امتدّ بشكل غير اعتيادي.

▸ اتّساع الكريبتو
مقياس مقطعي يكشف كم أصلًا من أصول الكريبتو يتحرّك فعليًا مع اتجاه السيولة. اتّساع عالٍ يعني إشارة نظام واسعة يُوثَق بها؛ اتّساع منخفض يعني حركة يقودها أصل أو اثنان — تمييز جوهري يحمي من قراءة إشارة ضيّقة على أنها اتجاه عام.

▸ مؤشر صلاحية الفرضية
معامل ارتباط متدحرج بين تغيّرات السيولة والكريبتو، يكشف متى تكون العلاقة بين السيولة والسوق فاعلة الآن ومتى تتعطّل — أداة تحقّق تمنع الاعتماد الأعمى على سردية السيولة حين لا تكون قائمة.

▸ تنبيهات عند التغيّر فقط
تنبيهات تُطلَق على تغيّر الحالة فقط — لا تكرار ولا ضجيج. اللوحة تراقب المنظومة نيابةً عنك وتُعلمك عند الانتقال بين الأنظمة، أو عند اكتشاف فجوة في البيانات.

snapshot

▸ شريط الخط الزمني
صفّ من الخلايا الملوّنة يعرض مسار النظام عبر الفترات الأخيرة، فترى تاريخ الحالة بلمحة بصرية واحدة. لون كل خلية يدلّ على حالة تلك الفترة: أزرق للتوسّع، أحمر للانكماش، برتقالي للتباعد (سيولة بلا سعر أو رالي غير مدعوم)، ورمادي للحالة المحايدة.

🎯 طبيعة اللوحة واستخدامها

هذه اللوحة أداة وعي بالسياق الكلّي المتزامن — تُصمَّم لبناء فهمٍ عميق لبيئة السيولة الراهنة قبل اتّخاذ القرار، لا لتوقيت لحظات دخول أو خروج محدّدة. موقعها الطبيعي في منظومة أي متداول هو الطبقة الأعلى: قراءة نظام السيولة العام والسياق الكلّي، الذي تُبنى فوقه قرارات التوقيت الدقيقة بأدوات أخرى. تُجيب سؤال: ما بيئة السوق الكلّية اليوم؟ بعمق ووضوح.


🔧 ملاحظات فنّية

◆ التدفّق بين فئات الأصول تمثيل نسبي، لا قياس مباشر — منصّات التداول لا توفّر تدفّق أوامر عبر-أصلي؛ لون الفئة يعرض الأداء النسبي مقابل المتوسط، بينما التدفّق المحاسبي الحقيقي يظهر في لوحة الشلال حصريًا.

◆ مصادر البيانات المطلوبة — بيانات FRED الاقتصادية، وCRYPTOCAP، وTVC، وNASDAQ؛ يُرجى التأكّد من توفّرها ضمن اشتراكك.

◆ معايرة الوحدات — الإعدادات الافتراضية مضبوطة على القيم الخام كما ترد من المصدر؛ راجع نافذة البيانات عند ظهور إنذار الوحدات لضبط المصادر.

◆ معايرة السياق — مقاييس مدّة الأنظمة وحدودها مبنية على بيانات السوق الحديثة، وقد تحتاج مراجعة عند تغيّر البيئة الكلّية الكبرى.

◆ الالتزامات التقنية — بلا إعادة رسم · اعتماد على البيانات المؤكّدة فقط · تأخير فترة واحدة مقصود بالتصميم لضمان عدم التسرّب المستقبلي · حساب فعّال لكل شمعة.


═════════════════════════════════════════════════════════════
⚠️ إخلاء المسؤولية
═════════════════════════════════════════════════════════════

هذا المؤشر لأغراض تعليمية وتحليلية فقط. لا يُمثل نصيحة مالية أو استثمارية أو تداولية. استخدمه بالتزامن مع استراتيجيتك الخاصة وإدارة المخاطر. لا يتحمل PulseWire ولا المطور مسؤولية أي قرارات مالية أو خسائر.

Disclaimer

The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by PulseWire. Read more in the Terms of Use.