Open Interest Suite [QuantAlgo]🟢 Overview
The Open Interest (OI) Suite is a comprehensive OI visualization and analysis tool built specifically for crypto perpetual futures traders. It reads open interest data directly from PulseWire-supported exchanges, giving you a way to monitor how many active contracts are currently open in the market. Whether you are tracking a single exchange or aggregating OI across venues like Binance, Bybit, Bitget, Coinbase, Kraken, HTX, BitMEX, and OKX, this indicator is one of the most powerful contextual tools available, allowing traders to quickly gauge overall perpetual futures market positioning.
🟢 What is Open Interest?
Open interest (OI) is the total number of live contracts between buyers and sellers at any given moment. Every long is matched to a short at a 1:1 ratio, so OI gives you a strong sense of how much capital and how many positions are currently committed to the market. Rising OI suggests new money and new positions are entering. Falling OI suggests positions are being closed or liquidated. When combined with price action, OI becomes one of the most valuable lenses available for understanding what is likely happening beneath the surface of price movement in perpetual markets.
🟢 How It Works
The indicator operates in two distinct modes. In Single (Chart) mode, it automatically reads open interest from whichever supported exchange and perpetual contract you are currently viewing, requiring no manual configuration. In Aggregated mode, it fetches OI from some of the highest-volume exchanges in crypto, for example, Binance, Bybit, Bitget, Coinbase, Kraken, HTX, BitMEX, and OKX, combines them into a single composite total, and gives you a cross-market view of positioning that no individual exchange feed can provide on its own. For each exchange in Aggregated mode, OI is fetched across both USDT and USDC perpetual pairs where applicable, then converted to a unified measure before summing. More exchanges will be added as their data becomes available on PulseWire.
The Measure setting controls how OI values are expressed. In Coins mode, values are kept in their native unit, which may be more useful when you want to observe raw contract volume independent of price fluctuations. In Dollars mode, coin quantities are multiplied by the current bar price to convert values into USD, which is the standard way most traders and data providers report OI and tends to make cross-asset comparisons more intuitive. For exchanges that report natively in USD, the conversion is handled in reverse when Coins mode is active.
🟢 Key Features
▶ View Modes
The indicator offers four ways to visualize OI, each suited to a different analytical purpose.
1. Candles: Renders OI as full OHLC candlesticks, displaying open, high, low, and close OI for every bar. This is the richest view for studying OI structure, trends, compression, and expansion over time. You can watch OI build or unwind bar by bar similarly to how you read price action, which may help with spotting periods of aggressive position-building or rapid deleverage.
2. Lines: Renders OI as a single continuous line using the close value of each bar. Cleaner and less visually demanding than candles, this mode works well for maintaining OI context alongside other indicators without crowding the chart.
3. Change: Displays the bar-over-bar absolute difference in OI as a histogram. Positive bars indicate net new positions were likely opened. Negative bars suggest net positions were closed or liquidated. This mode can help identify the bars where positioning shifted most dramatically, which often corresponds to high-conviction entries, forced liquidations, or possible trend exhaustion.
4. Change (%): The same histogram expressed as a percentage of the prior bar OI value. This normalises the signal across different asset sizes and OI magnitudes, which could make it easier to compare positioning dynamics between a large-cap asset and a smaller altcoin.
▶ Aggregated Mode and Exchange Selection
In Aggregated mode, each of the eight supported exchanges can be toggled on or off independently. This flexibility allows several useful configurations beyond a simple total. You can enable only one exchange to track that specific venue regardless of which chart you are currently viewing. You can also add the indicator to your layout multiple times with a different single exchange selected each time, letting you compare individual exchange OI side by side on the same chart.
▶ Color Presets
Five built-in color presets (Classic, Aqua, Cosmic, Cyber, Neon) allow you to match the indicator's appearance to your chart setup with a single click. A Custom preset exposes individual color pickers for bull, bear, and line colors, giving full control over every visual element including candle bodies, wicks, borders, histogram columns, and the line overlay.
▶ Unsupported Exchange Warning
When Single (Chart) mode is active and the current exchange does not provide open interest data on PulseWire, the indicator displays a warning label on the chart identifying the unsupported exchange and listing supported alternatives.
🟢 Price + OI Interpretation
Reading OI in isolation is only part of the picture. More meaningful analysis tends to come from combining OI direction with price action and, where available, volume data, along with other trend-following or mean-reversion indicators.
Examples:
1. Price Up + OI Up: New capital is likely entering on the long side. This could indicate bullish trend continuation, with fresh positioning supporting the move rather than just short covering. The stronger the OI growth relative to price movement, the higher the probability that the trend has genuine participation behind it.
2. Price Down + OI Up: New shorts are probably being added aggressively. Bearish momentum may be building through fresh positioning, which tends to be a more sustained signal than a move driven purely by long liquidations.
3. Price Down + OI Down: Longs are likely closing or being liquidated. The selling pressure in this scenario is coming from position unwinds rather than new short entries, which could sometimes suggest exhaustion near a local low rather than fresh trend initiation.
4. Price Up + OI Down: Shorts are probably closing or being squeezed out. This is the likely mechanics of a short squeeze: buyers overwhelm sellers, underwater shorts cover, and the resulting buy pressure may accelerate the move higher. This pattern tends to produce some of the fastest and sharpest price moves seen in crypto perpetual markets.
It is worth noting that for every short there is a long. When OI increases during a downtrend, it does not necessarily mean only shorts are entering. Longs are participating too, often more passively through limit orders. Cumulative Volume Delta (CVD) can help distinguish which side is more likely driving the flow, since it measures aggressive buying versus aggressive selling pressure within each bar.
🟢 Important Notes
1. This indicator is designed exclusively for crypto perpetual futures and will not produce output on spot tickers, equity symbols, or any instrument without a corresponding OI feed on PulseWire. In Single (Chart) mode, if the exchange you are viewing is not among the currently supported venues (Binance, Bybit, Bitget, Coinbase, Kraken, HTX, BitMEX, and OKX), the indicator will display a warning and produce no data. Switching to a supported exchange will restore functionality. More exchanges will be added as their data becomes available on PulseWire.
2. OI is most useful as a context layer rather than a standalone signal. Using it alongside price structure, volume, and order flow analysis may help you assess whether a move is likely backed by new positioning or driven by position unwinds. That distinction could have meaningful implications for how far a move extends and how quickly it might reverse. Indicator
Cross Exchange Premium Drift Map [AGPro Series]Cross Exchange Premium Drift Map
🧠 Core Idea
Is the active crypto venue drifting away from the exchange basket, or is the market staying aligned across venues?
📌 Overview / What it does
Cross Exchange Premium Drift Map is a crypto market structure tool designed to compare the active chart against a configurable basket of exchange reference symbols.
Instead of reading only the local chart, the script builds a venue basket from multiple exchange feeds and measures whether the active venue is trading at a premium, discount, or neutral alignment versus that basket.
It produces a premium drift path, a dispersion path, a right-side venue premium stack, event labels, strongest/weakest venue context, and a compact panel. It does not predict price direction, automate trading, or claim that a premium will close immediately.
🎯 Purpose & Design Philosophy
This script was built to fill a specific gap in crypto analysis: many traders look at one exchange chart and assume that chart represents the whole market.
Crypto is fragmented across venues. Premiums, discounts, and venue dispersion can appear before important shifts in liquidity, risk appetite, or execution quality.
The purpose of this tool is to make that fragmentation visible in a structured, readable, and non-predictive way.
⚡ Why This Script Is Different
Most tools focus on the active chart alone, or compare futures against spot using a basis model.
This script does NOT operate as a funding, carry, open interest, or perp-versus-spot basis indicator.
Instead, it compares the active venue against a configurable cross-exchange reference basket, then maps premium drift, venue dispersion, strongest venue, weakest venue, and alignment quality into a dedicated visual workflow.
⚙️ Methodology
1. Venue Basket Construction
The script requests multiple user-defined exchange symbols and builds an average reference basket from available venue prices.
2. Premium Drift Detection
The active chart is compared against the venue basket to calculate premium or discount.
3. Dispersion Evaluation
The script measures how far individual venues are spread around the basket.
4. State Classification
Premium, discount, spread expansion, spread compression, and exchange alignment are converted into readable states.
5. Visual Output
The chart displays premium paths, event labels, a right-side venue stack, and a panel summary.
🗺️ How to Read the Chart
The premium drift path shows how the active chart behaves relative to the venue basket.
The dispersion path shows whether exchange prices are widening away from each other or compressing toward alignment.
The right-side venue stack shows the current premium/discount context, basket drift, dispersion, strongest venue, and weakest venue.
Labels mark meaningful changes such as Venue Premium, Venue Discount, Spread Expansion, and Exchange Alignment.
The panel summarizes state, score, premium, drift z-score, velocity, dispersion, direction, grade, and venue count.
🚦 Signals & States
• Venue Premium → the active chart trades meaningfully above the exchange basket
• Venue Discount → the active chart trades meaningfully below the exchange basket
• Spread Expansion → venue dispersion is widening
• Spread Compression → venue prices are moving closer together
• Exchange Alignment → venues are compressed and the active chart is near the basket
• Check Venue Set → selected symbols may not represent the same asset or may be mismatched
🔔 Alerts Logic
Alerts trigger when the script detects a fresh state transition into a meaningful venue condition.
Venue Premium alerts mark active-chart premium pressure versus the basket.
Venue Discount alerts mark active-chart discount pressure versus the basket.
Spread Expansion alerts mark widening cross-exchange dispersion.
Exchange Alignment alerts mark compression toward venue agreement.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest readings occur when premium drift, drift z-score, velocity, dispersion, and persistence align.
When these conditions align, the venue message becomes more meaningful, but it still remains context rather than a prediction.
📊 When to Use
• Crypto spot charts with active multi-exchange liquidity
• BTC, ETH, and major liquid altcoin pairs
• Periods where venue premium, discount, or spread quality matters
• Market structure review before interpreting local price action
• Cross-exchange monitoring during volatile sessions
⚠️ When NOT to Use
• Illiquid symbols with unreliable venue references
• Symbols where the basket does not match the active chart asset
• Extremely noisy low-timeframe conditions
• Markets where one or more venue feeds are missing or stale
• Situations where the user expects guaranteed arbitrage signals
🎛️ Key Inputs
• Venue Symbols → define the exchange reference basket
• Venue Labels → control the short exchange names shown in the visual stack
• Premium Threshold → controls when active-chart premium or discount becomes relevant
• Dispersion Threshold → controls when cross-exchange spread widening matters
• Premium Baseline Length → controls the drift baseline
• Premium Z-Score Length → controls normalization
• Visual Settings → control panel, labels, paths, and venue stack display
🖥️ Interface & Visual Design
The interface is built for quick market reading.
The panel provides compact state information.
The premium stack shows the current venue relationship without using pale or white primary visuals, preserving readability on both dark and light chart backgrounds.
Labels are designed to be visible, premium, and not buried inside candles.
🧪 Practical Usage Workflow
1. Confirm that the venue symbols match the active chart asset.
2. Read the panel state and score.
3. Check whether the active chart is premium, discount, aligned, or mismatched.
4. Inspect the strongest and weakest venue labels.
5. Use the premium and dispersion paths to understand whether the relationship is widening or normalizing.
🔍 Interpretation Guidelines
A venue premium does not automatically mean price must fall.
A venue discount does not automatically mean price must rise.
Spread expansion means exchange prices are becoming less aligned.
Exchange alignment means the active venue is closer to the basket.
The script should be read as market context, not as a buy or sell system.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an arbitrage execution tool.
It is not an auto-trading system.
It does not guarantee that premiums, discounts, or spreads will normalize.
⚠️ Limitations & Transparency
Cross-exchange readings depend on symbol quality, venue availability, quote currency differences, and PulseWire data access.
USD and USDT references may behave slightly differently.
Low-liquidity assets can produce unstable readings.
Timeframe differences and exchange data behavior can affect how states appear.
🧠 Market Context Notes
Crypto markets are fragmented.
The same asset can trade differently across exchanges because of liquidity, regional flow, quote currency differences, venue-specific demand, and execution conditions.
This script attempts to make that fragmentation easier to see.
🧾 Use Case Examples
When the active chart trades above the basket while dispersion expands, the market may be showing venue-specific premium pressure.
When the active chart trades below the basket while dispersion expands, the market may be showing local venue weakness.
When premium and dispersion compress together, the market may be returning toward exchange alignment.
🧱 System Philosophy
Cross Exchange Premium Drift Map follows the AGProLabs design principle of building decision-support maps rather than prediction tools.
The goal is to improve context, visual structure, and trader awareness.
🔐 Non-Promise Statement
No signal in this script guarantees a future price move.
No premium or discount reading guarantees convergence.
All outputs require broader market interpretation.
📉 Risk Disclosure
Trading involves risk.
Users are fully responsible for their own decisions.
This script does not provide financial advice, investment advice, or guaranteed trading outcomes.
📚 Educational Note
This tool is designed for educational and analytical use. It helps traders study cross-exchange price behavior, venue alignment, and premium drift as part of a broader market structure workflow.
Indicator
Crypto Beta Leadership Ladder [AGPro Series]Crypto Beta Leadership Ladder
🧠 Core Idea
When crypto risk appetite changes, who is actually leading the move: BTC, ETH, broad alt beta, or the active chart itself?
📌 Overview / What it does
Crypto Beta Leadership Ladder is a market leadership and relative beta map for crypto traders.
The script compares BTC, ETH, broad altcoin market-cap behavior, high-beta altcoin breadth, BTC dominance, ETH dominance, and the active chart into a single leadership framework.
It produces a right-side leadership ladder, a live leadership path, selective transition labels, optional compact markers, and an AG Pro dashboard panel. It does not predict price, automate trades, or tell users what to buy or sell.
🎯 Purpose & Design Philosophy
This script was built to solve a common crypto-market problem: price may move, but leadership often rotates underneath the move.
Sometimes BTC is leading defensively. Sometimes ETH begins to participate. Sometimes broad alt beta expands. Sometimes the active chart is outperforming the market. These are different market conditions, and they should not be interpreted the same way.
The goal is to help traders read crypto leadership quality instead of reacting only to candle direction.
⚡ Why This Script Is Different
Most tools focus on one symbol, one moving average, one dominance chart, or one relative-strength line.
This script does NOT draw liquidation zones, funding stress maps, stablecoin liquidity pulses, basis corridors, or open-interest commitment zones.
Instead, it builds a leadership ladder from multiple crypto-market proxies and ranks BTC, ETH, alt beta, and chart beta as a live market hierarchy.
⚙️ Methodology
1. Context Detection
The script reads BTC, ETH, TOTAL2, TOTAL3, BTC dominance, and ETH dominance sources.
2. Relative Beta Mapping
It compares performance, dominance change, chart beta versus BTC, and altcoin breadth versus BTC.
3. Leadership Ranking
BTC, ETH, ALT, and CHART scores are ranked into a leadership stack. The gap between the first and second rank controls whether leadership is clear or split.
4. Visual Output
The script displays a right-side rank ladder, a leadership path, selective event labels, optional rank markers, and a compact dashboard.
🗺️ How to Read the Chart
The top ladder rail shows the current leadership rank.
The middle rail shows the second rank and whether leadership is close or split.
The lower rail shows the third rank and the active beta spread context.
The leadership path moves with the market and changes color by active leadership state.
Event labels highlight major transitions such as BTC Shield Lead, ETH Leadership, Alt Beta Lead, Chart Beta Expansion, or Split Leadership.
The panel summarizes leader, score, edge, BTC relative change, ETH relative change, alt beta, chart beta, dominance shift, persistence, state, and grade.
🚦 Signals & States
• BTC Leadership → BTC is leading defensively versus the broader crypto market
• ETH Leadership → ETH participation is stronger than BTC and broad alt context
• Alt Beta Lead → high-beta altcoin breadth is leading the crypto market
• Chart Beta Expansion → the active chart is outperforming BTC with expanding beta
• Split Leadership → leadership is mixed and no single group has clear control
• Balanced Leadership → leadership is present but not strong enough to be dominant
• Data Missing → one or more reference sources are unavailable
🔔 Alerts Logic
Alerts can be enabled for BTC Leadership, ETH Leadership, Alt Beta Leadership, Chart Beta Expansion, and Split Leadership.
Alerts trigger when the relevant state becomes active and the leadership state changes.
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
The ladder becomes more meaningful when rank edge, dominance shift, chart trend, and persistence align.
For example, an Alt Beta Lead state with positive chart beta and falling BTC dominance suggests a stronger risk-on leadership environment than a single isolated altcoin move.
📊 When to Use
• Crypto market rotation analysis
• BTC versus altcoin leadership checks
• ETH participation monitoring
• Altcoin beta expansion environments
• Market regime comparison across timeframes
⚠️ When NOT to Use
• Symbols with poor liquidity
• Very low timeframes with noisy dominance behavior
• Markets where reference symbols are unavailable
• During extreme news shocks without broader context
🎛️ Key Inputs
• Leadership Momentum Length → controls the main comparison window
• Leadership Baseline Length → controls slower leadership context
• Leadership Edge Threshold → controls how strong rank separation must be
• Beta Expansion Threshold → controls chart outperformance sensitivity
• Ladder Projection Bars → controls right-side ladder length
• Label Font Size / Panel Font Size → controls visual readability
🖥️ Interface & Visual Design
The interface is designed as a leadership stack rather than a zone map.
The ladder avoids white or pale-gray primary visuals so it remains visible on both dark and light chart backgrounds.
The panel uses the AG Pro blue header with a single merged title row and a compact information hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check which asset group leads the ladder.
3. Compare edge and persistence.
4. Read the leadership path color.
5. Use event labels as attention markers, not trade signals.
🔍 Interpretation Guidelines
Clear leadership means one group is controlling relative market behavior.
Split leadership means the market may be rotating, pausing, or lacking conviction.
Chart Beta Expansion means the active symbol is outperforming BTC, but it still requires broader confirmation.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not a financial-advice tool.
It is not an automated trading system.
It does not guarantee that leadership will continue.
It does not replace risk management or broader market analysis.
⚠️ Limitations & Transparency
Reference-symbol availability may vary by exchange, region, and PulseWire data feed.
Dominance data may behave differently from exchange-traded pairs on lower timeframes.
Leadership can rotate quickly during volatile crypto sessions.
Different timeframes may show different leadership states.
🧠 Market Context Notes
BTC leadership often reflects defensive crypto behavior.
ETH leadership can suggest higher participation in major smart-contract assets.
Alt beta leadership can suggest broader risk appetite, but it may also be more volatile.
Split leadership often appears during transitions, pauses, or uncertain market regimes.
🧾 Use Case Examples
When BTC leads while BTC dominance rises, the market may be defensive even if price is moving.
When alt beta leads while BTC dominance falls, broader risk appetite may be improving.
When the active chart expands versus BTC while rank edge improves, that symbol may deserve closer attention.
🧱 System Philosophy
Crypto markets are not led by one chart all the time.
This script treats leadership as a rotating hierarchy and visualizes that hierarchy directly on the chart.
🔐 Non-Promise Statement
No script can guarantee future price behavior.
This tool maps leadership context; it does not provide certainty.
📉 Risk Disclosure
Trading involves risk.
Users are responsible for their own decisions.
This script is provided for educational and analytical purposes only and does not constitute financial advice.
📚 Educational Note
Use the ladder to study how crypto leadership rotates between BTC, ETH, alt beta, and the active chart across different market regimes.
Indicator
Stablecoin Liquidity Pulse Map [AGPro Series]Stablecoin Liquidity Pulse Map
🧠 Core Idea
Is stablecoin liquidity expanding into the market, parking defensively on the sidelines, or drying up before risk appetite weakens?
📌 Overview / What it does
Stablecoin Liquidity Pulse Map is a crypto market-context tool that maps stablecoin liquidity flow, stablecoin dominance pressure, and risk-appetite behavior into a clean visual pulse framework.
The script reads USDT and USDC market-cap sources, optionally includes DAI, compares stablecoin flow against broader crypto market-cap context, and converts those inputs into liquidity pulse states.
It produces a right-side liquidity pulse ribbon, pulse tracks, selective event labels, optional compact markers, and an AG Pro dashboard panel. It does not predict price, automate trades, or claim that stablecoin growth must immediately create a bullish market.
🎯 Purpose & Design Philosophy
Stablecoins are one of the most important liquidity layers in crypto.
When stablecoin supply expands, capital may be entering or preparing to rotate. When stablecoin dominance rises while price weakens, capital may be parking defensively. When stablecoin flow contracts, risk liquidity can become thinner.
This script was built to turn that macro liquidity layer into a practical chart-reading tool without pretending that liquidity alone is a complete trading system.
⚡ Why This Script Is Different
Most tools focus on price, trend, volatility, or exchange-specific derivatives data.
This script does NOT focus on funding, open interest, basis, leverage reset, liquidation levels, or ordinary trend signals.
Instead, it studies the stablecoin liquidity layer behind the market. It asks whether stablecoin flow, dominance pressure, and price behavior are aligned with expansion, defensive parking, dry liquidity, or early rotation.
⚙️ Methodology
1. Stablecoin Flow Detection
The script reads USDT and USDC market-cap data, with optional DAI inclusion.
2. Dominance Pressure Mapping
It compares stablecoin value against total crypto market-cap context when available.
3. Risk-Appetite Evaluation
It evaluates whether price is behaving constructively or defensively relative to a baseline.
4. Pulse Classification
The script combines flow, velocity, dominance pressure, parking risk, dry-liquidity behavior, and rotation context into a single liquidity pulse state.
🗺️ How to Read the Chart
The right-side pulse ribbon is the main visual object.
The center ribbon shows the active liquidity pulse state.
The upper ribbon tracks stablecoin flow and expansion pressure.
The lower ribbon helps identify parking or dry-liquidity pressure.
The vertical needle shows where the current pulse sits inside the active liquidity range.
Event labels identify important state changes such as Liquidity Inflow, Risk-Off Parking, Dry Liquidity, or Rotation Ready.
The panel summarizes state, pulse, stable flow, velocity, dominance, dominance change, direction, grade, risk parking, dry score, and data-source availability.
🚦 Signals & States
• Liquidity Expansion → stablecoin flow is improving while dominance pressure is not defensive
• Risk-Off Parking → stablecoin dominance pressure is rising while market appetite weakens
• Dry Liquidity → stablecoin flow is contracting and liquidity conditions may be thinner
• Rotation Ready → stablecoin flow improves while market behavior begins to recover
• Neutral Pulse → no strong stablecoin liquidity state is active
• Data Missing → selected stablecoin sources are unavailable
🔔 Alerts Logic
Alerts can be enabled for Liquidity Expansion, Risk-Off Parking, Dry Liquidity, and Rotation Ready.
Each alert triggers when the selected state becomes active. Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest reads happen when stablecoin flow, velocity, dominance behavior, and price context align.
For example, rising stablecoin flow with falling defensive dominance pressure can support a constructive liquidity read.
Rising stablecoin dominance while price weakens can suggest defensive parking rather than active risk appetite.
📊 When to Use
• Crypto market-cycle analysis
• BTC and ETH context checks
• Stablecoin liquidity monitoring
• Risk-on / risk-off environment review
• Macro crypto liquidity dashboards
• 1D and 1W chart analysis
⚠️ When NOT to Use
• Very low liquidity altcoins as the only decision source
• Symbols where stablecoin market-cap data does not load
• Extremely noisy intraday charts
• Situations requiring exact exchange order flow
• Any workflow that expects a standalone buy/sell signal
🎛️ Key Inputs
• USDT Market Cap Symbol → primary stablecoin source
• USDC Market Cap Symbol → secondary stablecoin source
• Include DAI Source → optional additional stablecoin component
• Total Crypto Market Cap Symbol → used for dominance pressure
• Liquidity Flow Length → controls stablecoin flow measurement
• Pulse Baseline Length → controls slower liquidity and trend context
• Inflow / Outflow Thresholds → control state sensitivity
• Dominance Pressure Threshold → controls risk-off parking sensitivity
• Visual settings → control ribbon, event labels, tracks, markers, panel, and font sizes
🖥️ Interface & Visual Design
The design is intentionally different from derivatives-focused maps.
It avoids large projected zones, liquidation paths, reset ladders, and basis meters.
The right-side pulse ribbon keeps the visual focused on liquidity context rather than exact price levels. Colors remain visible on both dark and white chart backgrounds, and the panel follows the AG Pro merged-header format.
🧪 Practical Usage Workflow
1. Read the panel state first.
2. Confirm USDT and USDC sources are active.
3. Check stable flow and dominance change.
4. Review the right-side pulse ribbon.
5. Compare the state with price structure and broader market trend.
6. Use alerts as attention markers, not trade instructions.
🔍 Interpretation Guidelines
Liquidity Expansion does not guarantee upside.
Risk-Off Parking does not guarantee downside.
Dry Liquidity does not guarantee immediate volatility.
Rotation Ready means conditions are improving, not that a rotation must occur.
Use the script as a market-context layer alongside structure, trend, volatility, and disciplined risk management.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an automated trading system.
It is not an exact order-flow tool.
It does not guarantee market direction.
⚠️ Limitations & Transparency
Stablecoin market-cap symbols depend on PulseWire data availability.
Total crypto market-cap data may not be available in every environment.
Stablecoin supply changes can lag market behavior.
Different timeframes can produce different interpretations.
Extreme events, exchange stress, depegs, or abnormal data conditions can affect readings.
🧠 Market Context Notes
Stablecoin liquidity is not automatically bullish or bearish.
The meaning depends on context. Stablecoins can represent incoming buying power, defensive parking, cash rotation, or liquidity withdrawal.
This script focuses on interpreting that context more clearly.
🧾 Use Case Examples
When stablecoin flow rises and defensive dominance pressure is low, the script may show Liquidity Expansion.
When stablecoin dominance rises while price weakens, it may show Risk-Off Parking.
When stablecoin flow contracts and market appetite is weak, it may show Dry Liquidity.
When stablecoin flow improves with early market recovery, it may show Rotation Ready.
🧱 System Philosophy
AGProLabs scripts are built as structured decision-support tools.
The goal is to make hidden market context easier to read, not to replace judgment with certainty.
🔐 Non-Promise Statement
No liquidity model can remove uncertainty.
No state should be treated as certainty.
No visual element should replace trader judgment.
📉 Risk Disclosure
Trading involves risk.
Crypto markets can be highly volatile and liquidity conditions can change quickly.
This script is for educational and analytical purposes only.
Nothing in this script should be interpreted as financial advice, investment advice, or a guaranteed trading outcome.
Users remain fully responsible for their own decisions.
📚 Educational Note
Use this script to study how stablecoin supply, stablecoin dominance, and risk appetite interact across crypto market cycles.
Indicator
Liquidation Cascade Risk Map [AGPro Series]Liquidation Cascade Risk Map
🧠 Core Idea
When leverage pressure builds, is the market entering a real cascade-risk zone, or is liquidation pressure already cooling?
📌 Overview / What it does
Liquidation Cascade Risk Map is a crypto derivatives analysis tool designed to visualize liquidation-cascade risk without pretending to know exact exchange liquidation levels.
The script evaluates open interest data when available, falls back to a transparent volume-proxy mode when needed, and combines volatility expansion, range pressure, candle body stress, directional movement, and distance from reference structure into a single cascade-risk context.
It produces a cascade pressure path, right-side state tags, event labels, optional pulse markers, and a compact AG Pro dashboard panel. It does not predict future price, automate entries, provide liquidation prices, or act as a guaranteed signal system.
🎯 Purpose & Design Philosophy
This script was built for traders who want to understand when a crypto market may be carrying unstable leverage pressure.
Many liquidation tools focus on exact levels, heatmaps, or speculative liquidation clusters. Those can be useful, but they often require external datasets and may create false certainty when used as chart overlays.
Liquidation Cascade Risk Map takes a different approach. It asks whether current market behavior has the ingredients of cascade vulnerability: expanding pressure, directional stress, range instability, aggressive bodies, and persistence.
⚡ Why This Script Is Different
Most tools focus on liquidation levels, estimated heatmap bands, or simple volatility alerts.
This script does NOT claim to know where every liquidation sits, and it does not draw exchange-style liquidation heatmaps.
Instead, it maps the quality of the surrounding cascade-risk environment. It highlights when the market is showing pressure that may support long-side cascade risk, short-side cascade risk, two-way cascade vulnerability, or cooling after a pressure build-up.
⚙️ Methodology
1. Context Detection
The script checks whether usable open interest data exists. If not, it can fall back to a volume-proxy model so the visual framework remains usable across more symbols.
2. Pressure Mapping
It evaluates data change, volatility shock, candle range pressure, body expansion, distance from reference structure, and directional movement.
3. Cascade Evaluation
Those components are blended into a cascade-risk score. The script then classifies the environment as Long Cascade Risk, Short Cascade Risk, Two-Way Cascade, Risk Cooling, Neutral Risk, or Data Missing.
4. Visual Output
The chart displays a cascade pressure path, a dotted center reference, a vertical pressure needle, right-side tags, event labels, and a panel that summarizes the active state.
🗺️ How to Read the Chart
The upper pressure rail represents elevated liquidation-cascade risk.
The lower pressure rail represents cooling or pressure release context.
The dotted centerline acts as the current reference path.
The vertical needle shows how stretched the active cascade-risk score is inside the pressure path.
Event labels identify important changes such as Long Cascade, Short Cascade, Two-Way Cascade, or Risk Cooling.
The panel summarizes state, score, data change, velocity, persistence, cooling, direction, grade, data mode, ATR shock, data source, and trend.
🚦 Signals & States
• Long Cascade Risk → downside pressure is elevated and long-side liquidation vulnerability may be rising
• Short Cascade Risk → upside pressure is elevated and short-side liquidation vulnerability may be rising
• Two-Way Cascade → volatility and pressure are elevated on both sides, suggesting unstable conditions
• Risk Cooling → cascade pressure is decreasing after a build-up
• Neutral Risk → no strong cascade-risk condition is currently active
• Data Missing → the selected data source is not usable on the current symbol or mode
🔔 Alerts Logic
Alerts can be enabled for Long Cascade Risk, Short Cascade Risk, Two-Way Cascade, and Risk Cooling.
Each alert triggers when the selected state becomes active. Alerts are designed as attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when data expansion, volatility shock, range pressure, directional bias, and persistence align at the same time.
For example, high volatility with strong directional movement and rising pressure persistence may indicate a more unstable cascade-risk environment than volatility alone.
📊 When to Use
• Crypto perpetual futures
• High-volatility market phases
• Sharp directional moves
• Post-breakout acceleration
• Failed recovery or forced unwind environments
• Situations where leverage pressure may matter more than ordinary trend context
⚠️ When NOT to Use
• Very low liquidity symbols
• Symbols with unreliable volume or open interest data
• Extremely noisy low-timeframe charts
• Markets with abnormal gaps or data breaks
• Any situation where the user expects exact exchange liquidation prices
🎛️ Key Inputs
• Data Mode → chooses between automatic open interest, manual open interest symbol, or volume proxy
• Lookback Length → controls the normalization window for pressure scoring
• Fast / Slow Pressure Length → controls short-term and baseline pressure reaction
• Cascade Threshold → defines how demanding the script is before marking cascade-risk conditions
• Cooling Threshold → controls when pressure is considered to be cooling
• Persistence Bars → measures whether pressure is sustained or only momentary
• Visual settings → control labels, pulse markers, path visibility, panel layout, and font sizes
🖥️ Interface & Visual Design
The interface is built to make the chart readable at first glance.
The cascade path is intentionally not a large boxed zone. It is a pressure-path structure designed to remain visually distinct from corridor, ladder, and basis-style scripts.
The panel uses a merged AG Pro header row, compact metrics, and a dark professional layout. Visual elements avoid white or pale primary treatments so the script remains readable on both dark and light PulseWire chart backgrounds.
🧪 Practical Usage Workflow
1. Read the panel state first.
2. Check whether Data Mode shows real open interest or volume proxy.
3. Look at the cascade pressure path and current needle position.
4. Check event labels for recent pressure build-up or cooling.
5. Compare the state with broader trend, volatility, and market structure.
🔍 Interpretation Guidelines
Do not treat a cascade-risk state as a direct entry or exit signal.
Use it as a context layer. The script is most useful when combined with structure, liquidity, volatility, market regime, and risk management.
Rising cascade risk can mean the market is becoming unstable. Cooling can mean pressure is easing, but it does not guarantee reversal or continuation.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an automated trading system.
It does not calculate exact liquidation prices.
It does not guarantee that a liquidation cascade will happen.
⚠️ Limitations & Transparency
Open interest availability depends on symbol, exchange, and PulseWire data support.
Volume proxy mode is only a proxy. It can help visualize pressure context, but it is not the same as real open interest.
Different timeframes may produce different readings.
Fast markets, illiquid symbols, gaps, and abnormal candles can affect outputs.
🧠 Market Context Notes
Liquidation pressure is often connected to leverage, volatility, liquidity, and forced positioning.
This script focuses on context quality rather than exact liquidation geography. That makes it useful as a decision-support layer, but it should always be interpreted with broader market evidence.
🧾 Use Case Examples
When price accelerates downward while pressure score and persistence rise, the chart may show Long Cascade Risk.
When price squeezes upward with high pressure and volatility expansion, the chart may show Short Cascade Risk.
When volatility and pressure expand without clean directional separation, the chart may show Two-Way Cascade.
When pressure falls after a build-up, the chart may show Risk Cooling.
🧱 System Philosophy
AGProLabs scripts are built as structured decision-support tools.
The goal is not to make the chart louder. The goal is to make hidden market context easier to read, compare, and question.
🔐 Non-Promise Statement
No script can remove uncertainty.
No state should be treated as certainty.
No visual element should replace trader judgment.
📉 Risk Disclosure
Trading involves risk.
Crypto derivatives and leveraged markets can be especially volatile.
This script is for educational and analytical purposes only.
Nothing in this script should be interpreted as financial advice, investment advice, or a guarantee of outcome.
Users remain fully responsible for their own decisions.
📚 Educational Note
Use this script to study how pressure, volatility, persistence, and directional stress interact before and after unstable crypto market moves.
Indicator
Leverage Reset Quality Map [AGPro Series]Leverage Reset Quality Map
🧠 Core Idea
Did leverage actually reset, or did the market only pause before risk rebuilt again?
📌 Overview / What it does
Leverage Reset Quality Map is a crypto derivatives context tool designed to evaluate whether a leverage washout is developing into a cleaner reset, a fragile reset, a crowded stress condition, or a reload-risk environment.
The script combines open interest when available, a transparent volume-proxy fallback, data-change behavior, volatility shock, range expansion, wick flush behavior, recovery quality, persistence, and trend context. It converts those inputs into a reset-quality ladder, compact state labels, right-side tags, pulse markers, alerts, and an AG Pro dashboard.
It does not liquidate positions, predict future price direction, automate entries, or claim that a reset must lead to a reversal. It is an analytical map for reading whether leverage pressure appears to be clearing, rebuilding, or remaining unstable.
🎯 Purpose & Design Philosophy
This script was built for traders who want to separate a true leverage reset from a simple bounce, pause, or noisy reaction.
After sharp moves, many markets look relieved for a short period. The important question is whether participation pressure cooled, volatility stabilized, and price recovered with acceptable structure. Leverage Reset Quality Map turns that question into a visible workflow.
The design philosophy is simple: a reset is not automatically bullish or bearish. A reset is a context condition. Its quality depends on stress release, recovery quality, volatility behavior, and whether participation starts rebuilding too early.
⚡ Why This Script Is Different
Most tools focus on liquidation levels, open interest changes, or raw volume spikes.
This script does NOT draw another liquidation heatmap, does NOT treat every OI drop as bullish, and does NOT mark every volume spike as meaningful leverage cleansing.
Instead, it evaluates reset quality as a multi-factor condition. It asks whether stress is building, whether pressure is releasing, whether the market is recovering cleanly, and whether leverage-style participation is reloading before the reset matures.
⚙️ Methodology
1. Context Detection
The script reads official open interest when available. If official OI is unavailable and fallback is enabled, it uses volume as a transparent leverage-participation proxy.
2. Stress Mapping
It evaluates data-change pressure, velocity, volatility shock, range shock, and wick flush behavior to estimate whether leverage-style stress is present.
3. Reset Quality Evaluation
It measures participation contraction, volatility cooling, price recovery, wick recovery, and trend context to estimate reset quality.
4. Visual Output
The output is displayed as a reset-quality ladder with state, quality, reload risk, event labels, compact pulse markers, reaction tracks, and a dashboard panel.
🗺️ How to Read the Chart
The reset-quality ladder is the main visual object.
The upper step represents the current reset or stress state.
The middle step represents reset quality.
The lower step represents reload risk.
The vertical needle shows where current reset quality sits inside the ladder.
Labels mark state transitions such as Clean Reset, Fragile Reset, Reload Risk, and Stress Build.
Compact pulse markers add context:
• R = Clean Reset pulse
• F = Fragile Reset pulse
• L = Reload Risk pulse
• S = Stress Build pulse
Colors communicate context:
• Teal = cleaner reset pressure
• Yellow = fragile or incomplete reset
• Pink = reload or stress risk
• Indigo = neutral reset-quality structure
The panel summarizes state, reset quality, data change, stress score, persistence, reload score, direction, grade, data mode, volatility shock, OI source, and trend.
🚦 Signals & States
• Clean Reset → stress release and recovery quality are improving
• Fragile Reset → some reset behavior is visible, but quality remains incomplete
• Reload Risk → participation may be rebuilding before the reset is healthy
• Crowded Stress → leverage-style pressure is building without a clean reset
• Neutral Reset → no active reset state dominates the current read
• Data Missing → official OI and fallback data are not available
🔔 Alerts Logic
Alerts trigger when the script transitions into selected reset-quality states.
Clean Reset alerts mark improving reset quality.
Fragile Reset alerts mark incomplete reset conditions.
Reload Risk alerts mark renewed leverage-style participation before quality improves.
Stress Build alerts mark stress expansion without a clean reset read.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest context appears when several components align:
Participation contraction + volatility cooling + wick recovery + price recovery + improving reset quality.
The weakest context appears when participation expands again, volatility stays hot, and reset quality remains low.
📊 When to Use
• Crypto perpetual and futures charts
• Post-selloff or post-squeeze environments
• High-volatility reactions
• Open interest or volume-pressure analysis
• Markets where leverage reset quality matters more than a raw signal
⚠️ When NOT to Use
• Extremely illiquid symbols
• Markets with unreliable open interest or volume data
• Very low-volatility sideways charts where leverage pressure is not active
• News-driven gaps where normal reset logic may be distorted
• Any situation where the user expects a direct buy or sell signal
🎛️ Key Inputs
• Data Mode → selects official OI, manual OI, or volume-proxy behavior
• Manual Open Interest Symbol → lets the user define a specific OI source
• Context Lookback → controls the normalization window
• Fast Reaction Length → controls the short-term recovery track
• Slow Baseline Length → controls the slower reset baseline
• Minimum Stress Score → controls how much pressure is required for stress states
• Minimum Quality Score → controls how much recovery quality is required for a clean reset
• Event Label Cooldown → controls label spacing and visual density
• Panel / label settings → control visual layout and readability
🖥️ Interface & Visual Design
The interface is designed to feel different from zone-first or corridor-first tools.
Instead of drawing a large boxed area, the script uses a staggered reset-quality ladder. This keeps the chart readable on both dark and light PulseWire backgrounds and reduces the risk of looking like a duplicate of nearby derivatives tools.
The panel uses a merged blue AG Pro header row and a compact information hierarchy.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check whether data mode is Open Interest or Volume Proxy.
3. Look at the reset-quality ladder.
4. Compare reset quality with reload risk.
5. Review recent event labels and pulse markers.
6. Confirm the broader chart structure.
🔍 Interpretation Guidelines
A Clean Reset does not mean price must rise.
A Reload Risk state does not mean price must fall.
The script is designed to help users think in terms of leverage pressure, reset quality, and context alignment. It should be interpreted with broader structure, liquidity, trend, and risk controls.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It is not a liquidation heatmap.
It does not guarantee reversals, continuations, entries, exits, or outcomes.
⚠️ Limitations & Transparency
Open interest availability depends on the symbol, exchange, and PulseWire data support.
When official OI is unavailable, the script can use volume as a transparent proxy. A proxy is not the same as official open interest.
Timeframe differences may change how reset quality appears.
Volatility spikes, exchange-specific behavior, and sudden news events may distort the read.
🧠 Market Context Notes
Leverage resets often appear after forced movement, sharp volatility expansion, wick-heavy reactions, or participation contraction.
The important distinction is whether the reset becomes cleaner or whether risk reloads before the market has stabilized.
This script focuses on that distinction.
🧾 Use Case Examples
When price flushes lower, participation contracts, volatility cools, and price recovers toward the reaction track, the script may show Clean Reset.
When a market bounces but participation expands again while reset quality remains weak, the script may show Reload Risk.
When volatility remains hot and stress score remains elevated, the script may show Crowded Stress.
🧱 System Philosophy
Leverage Reset Quality Map follows the AGProLabs principle of building decision-support maps rather than prediction tools.
The goal is to make hidden market conditions easier to observe, compare, and interpret without overclaiming certainty.
🔐 Non-Promise Statement
No script can know future price direction.
No state should be treated as certainty.
Every output should be interpreted as context, not as an instruction.
📉 Risk Disclosure
Trading involves risk.
Crypto derivatives can be highly volatile and may involve leverage, liquidation risk, exchange risk, data limitations, and rapid market movement.
Users remain fully responsible for their own decisions.
This script does not provide financial advice.
📚 Educational Note
This script is intended for educational, analytical, and visual market-structure study.
Its value comes from helping users ask better questions about leverage pressure, reset quality, and risk rebuilding.
Indicator
Perpetual Basis Drift Map [AGPro Series]Perpetual Basis Drift Map
🧠 Core Idea
Is the perpetual market quietly drifting away from spot, or is the basis relationship compressing back toward neutral?
📌 Overview / What it does
Perpetual Basis Drift Map is a crypto derivatives context tool designed to monitor how the active perpetual or futures market behaves against a matching spot reference.
The script compares the active chart price with an automatically selected spot reference, measures basis percentage, basis drift, normalized basis z-score, drift velocity, persistence, and trend context. It converts that relationship into an open three-rail basis drift meter, state labels, right-side tags, alerts, and an AG Pro dashboard.
It does not read official funding payments, automate trades, predict future price direction, or promise that basis must mean-revert. It is a structured visual map for interpreting perpetual premium, perpetual discount, basis expansion, basis compression, reset, and spot-reference mismatch conditions.
🎯 Purpose & Design Philosophy
This script was built to separate basis drift from generic funding or premium talk.
Funding pressure can be noisy, and a raw premium number is often not enough. Traders need to know whether the relationship between perp/futures and spot is widening, compressing, persisting, or simply resetting.
The design goal is to make basis behavior visible as a chart story, not just a number in a panel.
⚡ Why This Script Is Different
Most tools show a spread or premium value and leave the interpretation to the user.
This script does NOT treat basis as a simple buy or sell signal, does NOT claim that premium must reverse, and does NOT hide reference mismatch risk.
Instead, it maps the basis relationship into states: Positive Drift, Negative Drift, Basis Expansion, Basis Compression, Reset, and Check Spot Ref, while the chart labels use Premium Drift, Discount Drift, Spread Expansion, and Basis Compression for faster visual reading. It uses spot-reference comparison, baseline drift, z-score, velocity, persistence, and trend context together.
⚙️ Methodology
1. Context Detection
The script builds a spot reference from the active chart base currency, selected exchange, and selected quote.
2. Reference Mapping
It compares the active market against the spot reference and calculates basis percentage.
3. Reaction Evaluation
The model evaluates basis drift from baseline, normalized basis z-score, drift velocity, persistence, and trend context.
4. Visual Output
The result is shown as a compact open basis drift meter, centered meter label, right-side tags, event labels, and dashboard panel.
🗺️ How to Read the Chart
The basis drift meter separates the current read into three visible layers: state rail, basis value rail, and pressure score rail. It is intentionally open-ended rather than a closed corridor, so the visual story feels different from zone-first tools.
Labels mark state changes such as Premium Drift, Discount Drift, Spread Expansion, and Basis Compression. Optional compact pulse markers add additional context when premium, discount, expansion, or compression pressure appears without turning the script into a signal engine.
Colors communicate context:
• Teal = positive/perp-premium drift pressure
• Pink = negative/perp-discount drift pressure
• Yellow = spread expansion or reference warning
• Indigo = compression/reset regime
The panel summarizes state, score, basis, basis z-score, velocity, persistence, direction, quality, spot reference, trend, and meter values.
🚦 Signals & States
• Positive Drift → perpetual/futures market is drifting above the spot reference
• Negative Drift → perpetual/futures market is drifting below the spot reference
• Basis Expansion → basis deviation and drift velocity are widening
• Basis Compression → basis deviation is compressing back toward neutral
• Reset → no active drift state is strong enough to dominate the read
• Check Spot Ref → selected spot reference appears mismatched or unavailable
🔔 Alerts Logic
Alerts trigger when the script transitions into selected basis states.
Positive Basis Drift alerts mark meaningful upward perp-versus-spot drift.
Negative Basis Drift alerts mark meaningful downward perp-versus-spot drift.
Basis Expansion alerts mark widening basis deviation and drift velocity.
Basis Compression alerts mark movement back toward a neutral basis relationship.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest context appears when multiple components align:
Basis percentage + normalized basis z-score + drift velocity + persistence + trend context.
When basis widens and persists, the relationship may deserve closer attention. When basis compresses, the market may be returning toward a more neutral perp-versus-spot condition.
📊 When to Use
• Crypto perpetual and futures charts
• Markets where spot reference comparison is meaningful
• Perp/spot monitoring on BTC, ETH, and liquid crypto pairs
• Basis expansion, basis compression, and drift-context analysis
• Sessions where derivatives premium or discount behavior matters
⚠️ When NOT to Use
• Symbols with poor spot-reference alignment
• Illiquid markets with unreliable pricing
• Spot-only charts if the user expects a derivatives basis story
• Extreme news events where spread behavior can become unstable
• Markets where the active symbol and selected reference are not comparable
🎛️ Key Inputs
• Auto Spot Reference → automatically builds a matching spot reference
• Basis Baseline Length → controls how quickly the normal basis relationship adapts
• Basis Normalization Lookback → controls how unusual basis drift must be
• Drift Velocity Lookback → measures whether basis is widening or tightening
• Persistence Window → measures whether basis behavior continues across bars
• Reference Mismatch Guard % → prevents mismatched references from being interpreted as real basis drift
• Visual Settings → control meter projection, labels, right-side tags, and font sizes
🖥️ Interface & Visual Design
The interface is designed around a premium chart-first story.
The basis drift meter provides the main visual anchor. Centered meter text explains the state without relying on weak transparent labels or a large corridor box. Right-side tags keep the current state, basis, and score visible near the active price area.
The panel follows the AG Pro standard with a merged blue header row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Apply the script to a crypto perpetual or futures chart.
2. Keep Auto Spot Reference enabled for the first pass.
3. Confirm the Spot Ref row matches the active market base currency.
4. Read State, Score, Basis, Basis Z, and Velocity.
5. Inspect whether basis is drifting, expanding, compressing, or resetting.
6. Confirm the read with broader market structure, liquidity, volatility, and risk management.
🔍 Interpretation Guidelines
Positive basis drift can show perp premium building, but it does not automatically mean price must fall.
Negative basis drift can show perp discount building, but it does not automatically mean price must rise.
Basis expansion is a context marker, not a trade instruction.
Basis compression can indicate normalization, but normalization does not guarantee direction.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto trading system.
This script is not a guaranteed signal engine.
This script does not read official funding payments directly.
This script does not claim that basis drift must immediately reverse.
⚠️ Limitations & Transparency
The script estimates basis from active-symbol versus spot-reference price behavior.
Reference quality matters. If the selected reference is wrong or unavailable, the script shows Check Spot Ref rather than presenting the spread as valid basis drift.
Different exchanges, contract types, liquidity conditions, and timeframes can produce different basis behavior.
Very low basis values can be visually clean but may not produce a dramatic story.
🧠 Market Context Notes
Perpetual basis can help traders understand whether derivatives pricing is leaning above or below spot.
The value of this tool is strongest when combined with structure, volatility, liquidity, open interest, and disciplined risk management.
Basis tells context. It does not create certainty.
🧾 Use Case Examples
When a perpetual chart trades persistently above spot and basis velocity expands, the script may classify Positive Drift or Basis Expansion.
When a perpetual chart trades persistently below spot and basis velocity expands downward, the script may classify Negative Drift.
When basis returns toward its baseline, Basis Compression can help show normalization.
🧱 System Philosophy
Perpetual Basis Drift Map follows the AGProLabs principle of building decision-support maps rather than prediction tools.
The script is designed to make hidden derivatives context easier to see, not to replace judgment.
🔐 Non-Promise Statement
No basis model can guarantee future price direction.
No drift score removes uncertainty.
This tool helps organize context; it does not create certainty.
📉 Risk Disclosure
Trading involves risk.
Crypto derivatives can be highly volatile and may involve leverage, liquidation risk, exchange risk, funding-cost changes, and rapid market movement.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use the script as a learning layer for understanding how perpetual premium, perpetual discount, basis drift, basis velocity, and spot-reference behavior can combine into a cleaner derivatives-context read.
Indicator
Open Interest Commitment Map [AGPro Series]Open Interest Commitment Map
🧠 Core Idea
Is open interest expansion actually committing with price, or is participation building without conviction?
📌 Overview / What it does
Open Interest Commitment Map is a crypto derivatives context tool designed to evaluate whether open interest expansion, contraction, price movement, volatility, and persistence are aligning into a meaningful market participation state.
The script attempts to read open interest data through configurable OI symbol builders, including Perp Contract OI, Chart Ticker + _OI, Dot-P + _OI, and Manual mode. When supported open interest data is available, it measures OI change, normalizes that change, compares it with price movement, and classifies the result into commitment states. If official open interest data is unavailable, it can fall back to a transparent Volume Proxy mode so the user knows exactly what data mode is being used.
It produces a projected commitment zone, state labels, right-side tags, alerts, and an AG Pro dashboard. It does not predict price direction, automate entries, or claim that open interest expansion must continue.
🎯 Purpose & Design Philosophy
This script was built because open interest is often discussed as if it has one simple meaning. In reality, rising open interest can support a trend, pressure a crowded side, reflect absorption, or become irrelevant without price confirmation.
The goal is to turn open interest into a readable commitment map rather than a raw number. The script asks whether participation is expanding, whether price is accepting that expansion, whether the behavior persists, and whether the current state deserves attention.
It is designed for crypto futures and perpetual traders who want to evaluate derivatives participation without relying on a simplistic “OI up equals bullish” or “OI down equals bearish” interpretation.
⚡ Why This Script Is Different
Most tools show open interest as a separate line or histogram.
This script does NOT treat open interest as a standalone signal, does NOT assume rising OI is automatically bullish, and does NOT hide data limitations when official OI is unavailable.
Instead, it maps OI behavior into structured states: Long Build, Short Build, OI Unwind, Absorption, Reset, or Data Missing. It combines OI change, normalized OI deviation, price movement in ATR units, trend acceptance, persistence, and volume rank into one visual commitment framework.
⚙️ Methodology
1. Context Detection
The script builds or reads the open interest source and checks whether official OI data is available.
2. Reference Mapping
Open interest change is measured over a configurable lookback and normalized against a longer historical window.
3. Reaction Evaluation
The model compares OI expansion or contraction with price movement, trend position, volatility, and persistence.
4. Visual Output
The final state is displayed through a projected commitment zone, state tags, event labels, and a compact AG Pro panel.
🗺️ How to Read the Chart
The commitment zone represents the active area where price and participation behavior are being monitored.
Labels mark key state transitions such as Long Build, Short Build, OI Unwind, and OI Absorption.
Colors communicate context:
• Teal = Long Build
• Pink = Short Build
• Yellow = OI Unwind
• Indigo = Absorption or neutral commitment context
• Light/neutral = Reset or Data Missing
The panel shows state, score, OI change, OI z-score, persistence, volume rank, direction, quality, data mode, OI source, and distance from the OI baseline.
🚦 Signals & States
• Long Build → open interest expands while price shows constructive acceptance
• Short Build → open interest expands while price shows bearish acceptance
• OI Unwind → open interest contracts meaningfully while price moves
• OI Absorption → open interest expands but price movement remains compressed
• Reset → no strong commitment state is active
• Data Missing → no usable open interest or proxy data is available
🔔 Alerts Logic
Alerts trigger when the script transitions into a selected commitment state.
Long Build alerts mark expanding participation with constructive price acceptance.
Short Build alerts mark expanding participation with bearish price acceptance.
OI Unwind alerts mark meaningful open interest contraction while price is moving.
OI Absorption alerts mark expanding open interest with limited price movement.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest read appears when multiple conditions align:
Open interest change + OI z-score + price movement + trend acceptance + persistence + volume rank.
When expansion appears without price progress, the context can shift from directional commitment to absorption. When contraction appears with price movement, the context can shift toward unwind behavior.
📊 When to Use
• Crypto perpetual and futures markets
• Symbols where PulseWire provides open interest data through `_OI`
• High-participation sessions where trader positioning may matter
• Breakout, breakdown, compression, and post-liquidation environments
• Situations where the user wants to distinguish commitment from noise
⚠️ When NOT to Use
• Symbols with no reliable open interest data when proxy mode is not desired
• Illiquid markets with unstable volume or fragmented data
• Very low timeframe noise without broader context
• Spot-only markets where open interest is not relevant
• Major news events where positioning can change faster than the model can stabilize
🎛️ Key Inputs
• OI Symbol Mode → controls whether the script uses Perp Contract OI, Chart Ticker + _OI, Dot-P + _OI, or Manual OI source selection
• Manual Open Interest Symbol → allows manual OI source selection if needed
• Allow Volume Proxy Fallback → uses transparent proxy mode when official OI is unavailable
• OI Baseline Length → controls the smoothing baseline for participation data
• OI Change Lookback → controls the change window for OI expansion or contraction
• OI Normalization Lookback → controls how unusual the OI change must be
• OI Commitment Z Threshold → defines the minimum normalized expansion required for commitment
• Visual Settings → control zone projection, event labels, right-side tags, and font sizes
🖥️ Interface & Visual Design
The interface is built around a clean commitment zone and a compact AG Pro panel.
The chart should feel active but not crowded. The projected zone gives the screenshot a visible story, right-side tags show the live state, and event labels highlight meaningful historical transitions.
The panel follows the AG Pro standard with a merged blue header row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Apply the script to a crypto perpetual or futures chart.
2. Start with OI Symbol Mode set to Perp Contract OI.
3. Confirm the Data Mode row says Open Interest when official OI data is available.
4. If Data Mode says Volume Proxy, try Chart Ticker + _OI, Dot-P + _OI, or Manual mode before using the screenshot for publication.
5. Read the State and Score rows.
6. Inspect whether price and OI are building, unwinding, absorbing, or resetting.
7. Confirm the context with broader market structure, liquidity, volatility, and risk management.
🔍 Interpretation Guidelines
Rising open interest is not automatically bullish.
Falling open interest is not automatically bearish.
Open interest expansion becomes more meaningful when price movement and persistence support the same story.
Absorption can be important because participation is increasing without clean price progress.
Unwind can be important because positioning is contracting while price is moving.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto trading system.
This script is not a guaranteed signal engine.
This script does not guarantee official open interest data exists on every symbol.
This script does not claim that open interest expansion must continue or reverse.
⚠️ Limitations & Transparency
Official open interest availability depends on the symbol, exchange, and PulseWire data support.
If official OI data is not available and proxy fallback is enabled, the panel clearly shows Volume Proxy mode.
Volume Proxy is not the same as official open interest. It can still help visualize participation pressure, but it should be interpreted more cautiously.
Different exchanges, contract types, timeframes, and liquidity conditions can produce different open interest behavior.
🧠 Market Context Notes
Open interest can help traders think about participation, but it needs context.
Expansion with price acceptance may indicate commitment.
Expansion without progress may indicate absorption.
Contraction with movement may indicate unwind.
No single state removes uncertainty.
🧾 Use Case Examples
When OI expands and price accepts higher while trend context supports the move, the script may classify Long Build.
When OI expands and price accepts lower while trend context supports the move, the script may classify Short Build.
When OI expands but price remains compressed, OI Absorption can warn that participation is building without clean directional progress.
When OI contracts while price moves, OI Unwind can help identify positioning reduction.
🧱 System Philosophy
Open Interest Commitment Map follows the AGProLabs design principle of building decision-support maps rather than prediction tools.
The script is designed to organize participation context into a readable workflow: read the panel, inspect the zone, check the state, evaluate reaction, and confirm with broader structure.
🔐 Non-Promise Statement
No open interest model can guarantee future price direction.
No commitment score creates certainty.
This tool helps structure interpretation; it does not replace judgment.
📉 Risk Disclosure
Trading involves risk.
Crypto derivatives can be highly volatile and may involve leverage, liquidation risk, exchange risk, and rapid market movement.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use the script as a learning layer for understanding how participation, price movement, volatility, persistence, and open interest behavior can combine into a more complete derivatives-context read.
Indicator
Indicator
Funding Carry Stress Map [AGPro Series]Funding Carry Stress Map
🧠 Core Idea
Is the market carrying a hidden derivatives premium or discount that is becoming crowded enough to matter?
📌 Overview / What it does
Funding Carry Stress Map is a crypto derivatives context tool designed to estimate when perpetual-style premium, carry pressure, basis drift, and volatility-adjusted crowding are becoming structurally relevant on the chart.
The script compares the active chart symbol against a user-selected spot reference, builds a smoothed carry baseline, measures premium/discount deviation, evaluates persistence, and converts the result into a visual carry stress framework. It produces a projected carry stress corridor, state labels, right-side tags, alerts, and a compact AG Pro dashboard.
It does not read official exchange funding payments, automate trades, predict future price direction, or promise that elevated carry stress must reverse. It is a structured analytical layer for reading derivatives pressure, premium imbalance, discount imbalance, carry squeeze risk, and cooling behavior.
🎯 Purpose & Design Philosophy
This script was built to fill a gap in the public AGProLabs lineup: most chart tools focus on trend, volume, support/resistance, momentum, or volatility. Crypto traders also need a clean way to think about derivatives-side pressure without turning the chart into a noisy data terminal.
The design goal is to make carry stress visible as a chart story. Instead of showing only a raw spread number, the script asks whether premium/discount is large, unusual, persistent, and supported by enough volatility context to deserve attention.
It is built for traders who want to monitor crowded long carry, crowded short carry, squeeze risk, and stress cooling while still making their own decisions from broader market context.
⚡ Why This Script Is Different
Most tools either show generic premium/basis values or treat funding-related pressure as a simple bullish/bearish signal.
This script does NOT claim to know the next candle, does NOT treat carry pressure as an automatic reversal signal, and does NOT depend on official funding-rate feeds that may not be available on every chart.
Instead, it converts spot-vs-active-symbol premium behavior into a structured carry stress map: premium size, normalized basis deviation, persistence, volatility rank, price reaction, and cooling behavior are combined into one visual decision-support framework.
⚙️ Methodology
1. Context Detection
The script reads the active chart price and a spot reference. By default, it automatically builds that reference from the chart base currency, selected exchange, and selected quote.
2. Reference Mapping
The premium series is smoothed into a carry baseline. The script then measures how far current premium/discount has moved away from that baseline.
3. Reaction Evaluation
The model evaluates basis z-score, absolute premium percentage, persistence across a recent window, volatility rank, and whether price is starting to reject the crowded side.
4. Visual Output
The result is displayed as a carry stress corridor, event labels, right-side tags, and a dashboard panel showing state, stress score, premium, basis z-score, persistence, volatility rank, and current interpretation.
🗺️ How to Read the Chart
The carry stress corridor represents the active price area where derivatives-side pressure is being monitored.
Labels mark important state transitions such as premium stress, discount stress, carry squeeze risk, and carry cooling.
Colors communicate state:
• Pink = positive carry / long-crowding stress
• Teal = negative carry / short-crowding stress
• Yellow = squeeze-risk reaction
• Indigo = cooling or neutralization
The panel summarizes the current condition so the user can quickly read whether carry pressure is low, watch-level, elevated, or extreme.
🚦 Signals & States
• Premium Stress → positive premium/carry pressure is active and persistent enough to monitor
• Discount Stress → negative premium/discount pressure is active and persistent enough to monitor
• Carry Squeeze Risk → elevated carry pressure is present while price begins reacting against the crowded side
• Carry Cooling → previously meaningful carry stress has faded below the model’s cooling zone
• Reset → no active carry imbalance is strong enough to dominate the current read
🔔 Alerts Logic
Alerts trigger when the internal state changes into one of the selected alert conditions.
Premium Stress alerts mark a transition into meaningful positive carry pressure.
Discount Stress alerts mark a transition into meaningful negative carry pressure.
Carry Squeeze Risk alerts mark a transition where crowded carry pressure and adverse price reaction align.
Carry Cooling alerts mark a transition where carry stress has materially faded.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The strongest context appears when multiple components align:
When premium size + basis z-score + persistence + volatility rank align, the carry stress score becomes more meaningful.
When that elevated score also appears with price rejection against the crowded side, the context shifts from simple premium/discount monitoring into potential squeeze-risk awareness.
📊 When to Use
• Crypto perpetual and futures markets where a spot reference can be selected
• Perpetual charts compared against their closest spot market
• High-interest crypto pairs where basis and carry pressure can influence behavior
• Volatile sessions where crowded positioning may matter more than usual
• Market regimes where traders want to monitor long-crowd or short-crowd pressure
⚠️ When NOT to Use
• Illiquid symbols with unreliable spot or futures pricing
• Charts where the selected spot reference is not comparable to the active symbol
• Markets with very noisy or fragmented data
• Extreme news events where spread behavior can become unstable
• Non-crypto symbols unless the user deliberately selects a meaningful reference
🎛️ Key Inputs
• Auto Spot Reference → automatically builds the spot reference from the chart base currency, selected exchange, and selected quote
• Carry Baseline Length → controls how quickly the premium baseline adapts
• Stress Normalization Lookback → controls how far back the script looks to judge unusual basis behavior
• Persistence Window → measures whether carry pressure persists across several bars
• Premium Stress Threshold % → defines the minimum premium/discount level required for active stress
• Reference Mismatch Guard % → prevents mismatched symbols from being interpreted as real carry stress
• Basis Z-Score Threshold → defines how unusual the spread must be before stress can activate
• Visual Settings → control corridor projection, labels, right-side tags, bar colors, and font sizes
🖥️ Interface & Visual Design
The interface is designed around a premium first-glance chart story.
The corridor gives the chart an active visual anchor. The centered label explains the current stress read without forcing the user to inspect every panel row. Right-side tags keep the current state visible near the active price area.
The panel uses the AG Pro layout standard with a blue merged header row, adjustable location, adjustable theme, and adjustable font size.
🧪 Practical Usage Workflow
1. Apply the script to a perpetual or futures chart.
2. Keep Auto Spot Reference enabled, or manually select the closest matching spot market.
3. Read the panel state and stress score.
4. Check whether the corridor is neutral, premium-stressed, discount-stressed, or showing squeeze risk.
5. Evaluate price reaction around the corridor together with broader market structure, volatility, and risk rules.
🔍 Interpretation Guidelines
Treat carry stress as a context layer.
Premium stress can mean long-side carry is becoming crowded, but it does not automatically mean price must fall.
Discount stress can mean short-side carry is becoming crowded, but it does not automatically mean price must rise.
Carry squeeze risk is stronger when elevated stress and adverse price reaction appear together, but it still requires confirmation from broader market context.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an auto trading system.
This script is not a guaranteed signal engine.
This script does not read official funding payment data directly.
This script does not claim that premium or discount must immediately mean-revert.
⚠️ Limitations & Transparency
The script estimates carry stress from active-symbol versus spot-reference behavior. It is a proxy framework, not an official exchange funding-rate feed.
Results can vary by exchange, symbol mapping, liquidity, timeframe, and data quality.
The selected reference must match the active market. Auto Spot Reference is enabled by default to help keep ETH charts on an ETH reference, BTC charts on a BTC reference, and similar mappings aligned.
Fast market moves, low liquidity, stale references, or mismatched symbol selections can affect the accuracy of the stress interpretation.
Market conditions change, and the same stress score may behave differently across different volatility regimes.
🧠 Market Context Notes
In crypto markets, derivatives pressure can matter because perpetual traders may become crowded on one side when premium, basis, and volatility remain elevated.
This does not create certainty. It creates context.
The value of the script is strongest when the user combines carry stress with structure, liquidity, trend quality, volatility, and disciplined risk management.
🧾 Use Case Examples
When price trades above the spot reference with persistent premium and the panel shifts into Premium Stress, the user may monitor whether long-side carry is becoming crowded.
When price trades below the spot reference with persistent discount and the panel shifts into Discount Stress, the user may monitor whether short-side pressure is becoming crowded.
When elevated carry stress appears and price starts rejecting the crowded side, the Carry Squeeze Risk state can help highlight a context worth closer attention.
🧱 System Philosophy
Funding Carry Stress Map follows the AGProLabs principle of building decision-support maps rather than prediction tools.
The script is designed to make hidden context easier to see, not to replace judgment.
Its purpose is to organize information into a cleaner visual workflow: read the state, inspect the corridor, evaluate reaction, and confirm with broader context.
🔐 Non-Promise Statement
No script can guarantee market direction.
No carry stress model can remove uncertainty.
This tool helps organize context; it does not create certainty.
📉 Risk Disclosure
Trading involves risk.
Crypto derivatives can be highly volatile and may involve leverage, liquidation risk, exchange risk, funding-cost changes, and rapid market movement.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use the script as a learning layer for understanding how premium, discount, persistence, volatility, and price reaction can combine into a more complete derivatives-pressure read.
Indicator
Session Bias Relay Map [AGPro Series]Session Bias Relay Map
🧠 Core Idea
Did Asia, London, and New York pass the same bias forward, or did the next session reject the market narrative?
📌 Overview / What it does
Session Bias Relay Map is an intraday session-structure tool built to visualize how directional bias moves from one major trading session to the next.
The script tracks Asia, London, and New York session ranges, scores each session's directional bias, and classifies whether the active session confirms, conflicts with, or reverses the previous session's narrative.
It does not predict price direction, automate trades, or claim that a session handoff must continue. It is a structured visualization and decision-support map for session bias, market narrative, and intraday context.
🎯 Purpose & Design Philosophy
Many session tools draw boxes, highs, lows, or kill zones.
This script was built to answer a more contextual question:
Did the next major session accept the prior session's directional story, or did it break the handoff?
The design goal is to help traders read sessions as a relay of market intent instead of isolated time windows. It supports discretionary market reading, session review, and intraday structure analysis.
⚡ Why This Script Is Different
Most session indicators focus on time blocks, session highs, and session lows.
This script does NOT stop at drawing session boxes.
Instead, it evaluates how each session behaves relative to the prior session. It scores bias strength, detects handoff confirmation, identifies conflict, and highlights reversal pressure when the active session builds a strong opposite narrative.
⚙️ Methodology
1. Session Detection
The script tracks configurable Asia, London, and New York session windows using the chart symbol's exchange timezone.
2. Session Range Mapping
For each session, it records open, high, low, close, midpoint, bar count, and live range behavior.
3. Bias Scoring
Session bias is scored using body pressure, close location inside the session range, and optional relative volume confirmation.
4. Relay Evaluation
London is compared against the completed Asia bias.
New York is compared against the completed London bias.
5. Visual Output
The chart displays session boxes, midpoint rails, centered session labels, relay event labels, right-side tags, alerts, and a compact AG Pro decision panel.
🗺️ How to Read the Chart
Session Boxes = the active session range built from each configured time window.
Centered Labels = the session name, current bias, relay state, and quality score.
Midpoint Rails = the middle of each session range, useful for reading control and balance.
Relay Event Labels = confirmation, conflict, or reversal events when a later session responds to the prior session.
Right-Side Tags = the current relay state and active session bias.
Panel = summarizes active session, relay state, bias score, prior session, session quality scores, next context, and timeframe scope.
🚦 Signals & States
• RELAY CONFIRMED → the active session supports the previous session's directional bias.
• RELAY REVERSAL → the active session builds strong bias opposite to the previous session.
• BIAS CONFLICT → the active session does not clearly confirm the previous session.
• FIRST LEG → Asia is building the first session bias for the daily relay.
• WAIT HANDOFF → the active handoff does not yet have enough evidence.
• BULLISH → the session is closing with bullish range pressure.
• BEARISH → the session is closing with bearish range pressure.
• NEUTRAL → the session does not have enough directional pressure.
🔔 Alerts Logic
Alerts trigger when a major relay state appears.
• Session Bias Relay Confirmed → the active session confirmed the directional bias passed from the previous session.
• Session Bias Conflict → the active session failed to confirm the previous session and is showing conflict.
• Session Bias Reversal → the active session built strong bias opposite to the previous session.
Alerts are attention markers, not trade instructions.
🧩 Confluence Logic
The context becomes stronger when:
• The previous session has a clear directional bias
• The active session has enough bars to evaluate
• The active session bias score is above the confirmation threshold
• Price closes with clear range position
• Relative volume supports participation
• The relay label and panel state agree
If these elements do not align, the script avoids forcing a strong directional interpretation.
📊 When to Use
• Intraday session analysis
• Forex, crypto, index futures, and liquid stock index products
• Asia-to-London handoff review
• London-to-New-York handoff review
• Market narrative tracking
• Session range and bias studies
• 15m, 30m, 1H, and 2H charts
⚠️ When NOT to Use
• Daily, weekly, or monthly charts
• Very low-liquidity symbols
• Markets with irregular or meaningless session windows
• Extremely noisy conditions where session closes do not carry useful information
• Situations where a single session should not be over-interpreted
• Symbols where the chart exchange timezone does not match the intended session model
🎛️ Key Inputs
• Asia Session → defines the first session window used to build the initial bias.
• London Session → defines the second session window used to evaluate the Asia handoff.
• New York Session → defines the third session window used to evaluate the London handoff.
• Max Chart TF Minutes → limits the largest timeframe that should build the relay map.
• Bias Confirmation Threshold → controls how strong a session must be before it can confirm a relay.
• Conflict Threshold → controls when a session is treated as weak or conflicted.
• Minimum Handoff Bars → prevents early-session noise from printing premature relay labels.
• Use Volume Confirmation → adds relative volume pressure to the bias score.
• Show Session Boxes → controls the main visual range boxes.
• Show Relay Event Labels → controls confirmation, conflict, and reversal labels.
• Label Font Size → controls chart label and tag text size.
• Panel Font Size → controls panel text size.
🖥️ Interface & Visual Design
The visual hierarchy is built around the session relay story.
Session boxes define the time windows.
Centered labels make each session readable without hunting through the chart.
Relay labels highlight the important handoff moments.
Right-side tags keep the current state visible.
The AG Pro panel summarizes the active session context in a clean, compact format.
🧪 Practical Usage Workflow
1. Choose session windows that match the market being studied.
2. Let Asia build the first bias leg.
3. Watch whether London confirms, conflicts with, or reverses Asia.
4. Watch whether New York confirms, conflicts with, or reverses London.
5. Use the panel to check relay state, active bias, quality score, and timeframe scope.
6. Interpret the result inside broader market structure, liquidity, and volatility context.
🔍 Interpretation Guidelines
A relay confirmation does not guarantee continuation. It means the active session is supporting the prior session's directional bias according to the script's rule set.
A relay reversal does not guarantee a full trend reversal. It means the active session is building strong opposite pressure relative to the previous session.
A bias conflict is not a failure. It is useful information that the market narrative is not clean.
The best use is contextual: combine the relay state with support, resistance, liquidity, volume, and higher-timeframe structure.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed entry or exit signals.
It is not a generic session box indicator.
It is not a kill-zone strategy.
⚠️ Limitations & Transparency
Session settings matter. Poorly selected session windows can produce weak or misleading context.
Timeframe differences can affect how session handoffs appear.
Low-liquidity markets can distort bias scores.
Markets with irregular trading hours may need custom session inputs.
Relative volume can help, but it does not guarantee better interpretation in every market.
🧠 Market Context Notes
Session behavior is often shaped by liquidity, regional participation, volatility expansion, and macro timing.
The same relay state can mean different things depending on whether the market is trending, ranging, or reacting to news.
The script is strongest when used as a narrative map, not as a standalone decision machine.
🧾 Use Case Examples
• If Asia builds a bullish range and London also closes with strong bullish pressure, the relay may show confirmation.
• If Asia builds bullish pressure but London quickly forms strong bearish pressure, the relay may show reversal.
• If London begins with weak movement and no clear range pressure, the relay may show conflict or wait for more evidence.
🧱 System Philosophy
Session Bias Relay Map is part of the AGPro Series approach to decision-support tools:
clear structure, premium chart readability, honest interpretation, and no promise of certainty.
The goal is to help traders see market context faster without turning analysis into signal spam.
🔐 Non-Promise Statement
No script can know the future.
No session handoff is guaranteed.
No signal should be interpreted without broader market context.
📉 Risk Disclosure
Trading involves risk.
Markets can move unpredictably.
This script is for educational and analytical purposes only.
It does not provide financial advice or guaranteed trading outcomes.
Users remain responsible for their own decisions.
📚 Educational Note
Use this script to study how market participation changes across sessions.
The value is not only in the label. The value is in learning how the session narrative develops, confirms, conflicts, or reverses over time.
Indicator
Bitcoin Logarithmic MACD Risk Metric (W, M)Description
The Bitcoin Logarithmic MACD Risk Metric (W, M) is a long-term macro analysis tool designed to identify generational buying and selling opportunities for Bitcoin. By applying logarithmic and linear regression models to the Logarithmic MACD (LMACD), this indicator normalizes price momentum relative to historical market cycle extremes.
Unlike standard MACD, the logarithmic version used here accounts for Bitcoin's exponential growth over time, allowing for a consistent comparison of momentum across different cycles.
IMPORTANT: Timeframe Compatibility
Note: This indicator is strictly designed for Weekly (W) and Monthly (M) timeframes. The regression lines won't show on other timeframes.
The regression lines (Log and Linear fits) were calculated using data points from these high-level timeframes because they contain less "noise" and are far more reliable for predicting global cyclical tops and bottoms.
It is highly recommended to wait for the candle close on the respective timeframe to confirm any signal, as mid-candle fluctuations can significantly alter the Risk Metric value.
How to Use It
The metric provides a "Risk" score between 0 and 1, visualizing where Bitcoin sits within its historical growth channel.
Sell Zone (Red): When the LMACD line enters the red zone, it indicates that Bitcoin is overbought and potentially nearing a cyclical peak.
Buy Zone (Green): When the LMACD drops into the green zone, it suggests the asset is oversold and approaching a cyclical bottom.
Confluence: While these zones have historically marked major reversals, this indicator should not be used in isolation. Always seek confluence with other technical or fundamental indicators.
Customizable Settings
Line Fits: You can choose between "Log Fit" and "Linear Fit" for both Top and Bottom lines to see which model best aligns with your current analysis.
View Mode: Switch between Fit Lines (seeing the MACD inside the channel) or Normalized (viewing the risk as a 0-1 oscillator).
Risk Levels: Adjust the thresholds for the Buy and Sell zones to fit your risk tolerance.
Price Overlay: Toggle the candle coloring on the main chart to see risk levels directly on the price action.
VIsualization Tip
If the price overlay makes the chart look too cluttered, you can hide the Bitcoin price bars in the main chart settings to focus purely on the colored risk overlay. Alternatively, you can disable the "Plot on Main Pane" option in the indicator settings if you only want to see the metric in its own separate pane below.
Limitations
Asset Focus: This indicator is specifically calibrated for Bitcoin. While you can apply it to other charts, the indicator pane will always display Bitcoin's MACD risk, whereas the price overlay will color the candles of the currently selected instrument.
Fixed Parameters: The LMACD settings (12, 26, Close) are hardcoded. This is intentional, as the regression fitting was performed specifically using these values; changing them would make the historical bands irrelevant.
Hardcoded Coefficients: The regression lines are based on historical tops and bottoms up to 2023. Future market cycles may require new approximations if Bitcoin's volatility profile shifts significantly.
Regression Specifics: The Linear Fit model treats the early 2011 peaks/bottoms as outliers. On the Monthly timeframe, the bottom line is available only as a linear fit due to the limited number of historical macro data points. The upper linear boundary is guaranteed to be broken by future price action, but it can serve as a "conservative" macro target in the meantime.
No Guarantees: Past performance does not guarantee future results. There is no certainty that the metric will reach the boundaries in every cycle or remain within them indefinitely.
Indicator
Crypto Dominance Rotation Map [AGPro Series]Crypto Dominance Rotation Map
🧠 Core Idea
Is crypto capital rotating toward Bitcoin, Ethereum, altcoins, or defensive stablecoin exposure?
📌 Overview / What it does
Crypto Dominance Rotation Map is a crypto market regime tool built to read capital rotation through Bitcoin dominance, Ethereum dominance, broad altcoin participation, and stablecoin defensive pressure.
The script produces a four-lane rotation map, a 0-100 Risk Participation Score, curated regime labels, right-side lane tags, alert conditions, and an AG Pro panel that summarizes the active crypto capital-flow state.
It does not predict price direction, automate trades, or claim that dominance rotation will always lead to a specific outcome. It is designed as a structured market context and visualization tool.
🎯 Purpose & Design Philosophy
This script was built to fill the gap between single-symbol price indicators and broader crypto market context.
Many crypto traders watch BTC dominance, ETH dominance, altcoin market capitalization, and stablecoin dominance separately. This script brings those references into one readable rotation map so the trader can understand the current capital-flow environment faster.
The mindset is context-first: identify where attention and capital may be concentrating before interpreting individual chart setups.
⚡ Why This Script Is Different
Most tools focus on the active chart symbol or on a basket of crypto assets.
This script does NOT try to call buys or sells on one coin.
Instead, it maps dominance rotation across Bitcoin, Ethereum, altcoins, and stablecoin defense so the trader can read the broader crypto regime behind the chart.
⚙️ Methodology
1. Dominance Mapping
The script reads Bitcoin dominance, Ethereum dominance, altcoin market-cap participation, and stablecoin dominance.
2. Rotation Scoring
Each reference is converted into a normalized 0-100 lane score using configurable momentum and smoothing.
3. Regime Classification
The model classifies the active state as BTC Lead, ETH Lead, Alt Risk-On, Defensive, Rotation Watch, or Neutral.
4. Visual Output
The script plots four rotation lanes, a Risk Participation Score, event labels, right-side tags, and a compact panel.
🗺️ How to Read the Chart
BTC Lane shows whether Bitcoin dominance is gaining leadership.
ETH Lane shows whether Ethereum dominance is improving versus the broader crypto market.
Altcoin Lane shows whether broad non-Bitcoin participation is improving.
Stable Lane shows whether stablecoin dominance is rising, which may reflect defensive positioning.
The Risk Participation Score summarizes whether crypto rotation is constructive, defensive, or undecided.
🚦 Signals & States
• BTC LEAD → Bitcoin dominance is the active leadership lane.
• ETH LEAD → Ethereum dominance is leading rotation.
• ALT RISK-ON → altcoin participation is constructive and broad risk appetite is stronger.
• DEFENSIVE → stablecoin dominance pressure is elevated.
• ROTATION WATCH → no clean leader yet, but participation is improving.
• NEUTRAL → no strong capital-flow leader is confirmed.
🔔 Alerts Logic
Alerts trigger when the active rotation state changes into a major regime.
Available alert states:
• BTC Dominance Leadership
• ETH Dominance Leadership
• Altcoin Risk-On Rotation
• Defensive Stablecoin Rotation
Alerts are attention markers only. They are not trade instructions.
🧩 Confluence Logic
Context becomes stronger when the active rotation state aligns with the trader’s chart setup.
For example, an altcoin breakout may carry stronger context when the map shows Alt Risk-On. A defensive state may encourage more caution around aggressive long setups.
📊 When to Use
• Crypto market regime review
• Altcoin season / Bitcoin dominance monitoring
• Risk-on and risk-off context checks
• Higher-timeframe crypto market preparation
• Comparing individual setups with broader market rotation
⚠️ When NOT to Use
• Very low-liquidity crypto assets
• Symbols that do not respond to broader crypto conditions
• Extremely short-term scalping where dominance data is too slow
• Periods where dominance symbols are unavailable or delayed
🎛️ Key Inputs
• BTC Dominance Symbol → Bitcoin dominance reference.
• ETH Dominance Symbol → Ethereum dominance reference.
• Altcoin Market Cap Symbol → broad altcoin participation proxy.
• Stablecoin Dominance Symbol → defensive crypto positioning proxy.
• Rotation Momentum Length → how far back rotation pressure is measured.
• Rotation Smoothing → how smooth or reactive the lane map becomes.
• Risk-On / Defensive Thresholds → state classification sensitivity.
🖥️ Interface & Visual Design
The interface is designed around a four-lane map. Each lane has a clear role: BTC, ETH, ALT, and STABLE.
Event labels highlight regime changes without turning the chart into a signal board.
The panel summarizes state, risk score, lane values, dominance readings, next context, and timeframe.
🧪 Practical Usage Workflow
1. Read the panel state.
2. Check which lane is leading.
3. Compare the Risk Participation Score with the active chart idea.
4. Use labels and alerts as context markers.
5. Confirm with price structure, volume, and your own risk plan.
🔍 Interpretation Guidelines
The script should be interpreted as market context.
BTC leadership may indicate capital concentration in Bitcoin. Alt Risk-On may suggest broader participation. Defensive stablecoin rotation may indicate caution.
No state is automatically bullish or bearish for every asset.
🚫 What This Script Is NOT
This script is not a prediction engine.
It is not financial advice.
It is not an auto-trading system.
It does not provide guaranteed signals.
⚠️ Limitations & Transparency
Dominance symbols may update differently from exchange-traded instruments.
Timeframe selection can materially change the rotation read.
Crypto market conditions can shift quickly during volatility events.
The script depends on the availability and quality of the selected reference symbols.
🧠 Market Context Notes
Dominance rotation is often more useful as a background regime filter than as a direct entry signal.
The strongest use case is comparing an individual crypto setup against the broader flow of capital across Bitcoin, Ethereum, altcoins, and defensive stable exposure.
🧾 Use Case Examples
When an altcoin setup appears while the map shows Alt Risk-On, the broader participation context may be more supportive.
When Bitcoin dominance leads while altcoin participation weakens, altcoin setups may require more selectivity.
When stablecoin dominance becomes defensive, aggressive risk-on interpretations should be handled more carefully.
🔐 Non-Promise Statement
No script can provide certainty.
This tool provides structured context, not guaranteed outcomes.
📉 Risk Disclosure
Trading involves risk.
Users remain responsible for their own decisions.
This script does not provide financial advice.
📚 Educational Note
Use this script to study how crypto capital rotation changes across market regimes and how that context interacts with individual chart setups.
Indicator
Imperium FlowImperium Flow is a market flow indicator designed to evaluate the quality behind price movement. It analyzes pressure, volume participation, candle behavior, wick rejection, Money Flow, and effort versus result to help traders understand whether a move is supported, stretched, weakening, or starting to rotate.
The indicator is built for confirmation and market context. It does not predict price. Its purpose is to help identify when buyers or sellers have stronger control, when continuation remains healthy, and when market conditions are becoming less efficient.
Main Features
Exhaustion Zones;
Money Flow;
Price Pressure;
Price Effort;
Exhaustion Warnings;
Reversal Warnings;
Divergence.
Each section is designed to give a different view of market quality, from participation and pressure to exhaustion, consolidation, and possible rotation.
Exhaustion Zones
Exhaustion Zones highlight areas where directional pressure has become stretched.
Reaching these zones does not mean price must reverse. Strong trends can continue through them. The zones simply warn that late entries may carry more risk because continuation can become less efficient.
They are most useful when combined with pressure shifts, candle rejection, absorption, fading Money Flow, or nearby market structure.
Money Flow
Money Flow shows whether buying or selling participation is stronger.
When Money Flow is above zero, buyer participation is stronger. When it is below zero, seller participation is stronger.
Rising or stable Money Flow can support bullish continuation. Falling or weak Money Flow can support bearish continuation. When price keeps moving in one direction while Money Flow starts fading or improving against it, the move may be losing quality.
High positive or deep negative readings can also show stretched market conditions.
Price Pressure
Price Pressure shows the active balance between bullish and bearish pressure.
Positive pressure suggests stronger buyer control. Negative pressure suggests stronger seller control.
Pressure is most useful when compared with price movement. When pressure supports the direction of price, the move has better confirmation. When pressure starts moving against price, continuation may be losing quality.
The pressure momentum columns help show acceleration, fading pressure, absorption, rejection, or early rotation near key market areas.
Price Effort
Price Effort is the main directional read of Imperium Flow.
It shows whether price movement is supported by strong effort and meaningful follow-through, or whether the move is becoming weak, inefficient, or exhausted.
When Price Effort is above zero and in a bullish state, buyers have stronger control. When it is below zero and in a bearish state, sellers have stronger control. When it turns neutral, the market may be losing direction or entering consolidation.
The strongest continuation conditions usually appear when Price Effort, Price Pressure, and Money Flow support the same direction. When these readings begin to separate, the move should be treated with more caution.
Exhaustion Warnings
Exhaustion warnings are shown with ✦ symbols.
They appear when a strong move may be starting to lose quality. These warnings are not designed to mark the exact top or bottom. They are caution markers showing that the current direction may be becoming more vulnerable.
An exhaustion warning can appear when pressure fades, Money Flow becomes stretched, candles show rejection, volume produces weaker follow-through, or absorption forms against the active move.
The warning is more useful after an extended move or near important market structure, liquidity areas, previous highs or lows, support, or resistance. If price continues with strong pressure after the warning, the trend may remain valid. If it is followed by weak continuation, rejection, or a shift in Price Effort, the market may be preparing for a pullback or rotation.
Reversal Warnings
Reversal warnings are shown with ▼ and ▲ symbols.
They appear when an extended move begins to show stronger rotation evidence. These are not automatic buy or sell signals. They highlight moments where the active side may be losing control and the opposite side is starting to react.
A reversal warning can form after rejection from an extreme area, a pressure shift against the active move, fading Money Flow, or a turn in Price Effort from stretched conditions.
The signal is strongest when it appears after exhaustion, near important market structure, or after a failed continuation attempt. If price ignores the warning and continues with strong pressure, the trend may still remain active.
Divergence
Divergence highlights when price continues to extend, but Imperium Flow no longer confirms the move with the same strength.
This can help traders spot moments where momentum, pressure, or participation may be weakening behind the current price movement.
Divergence does not mean price must reverse immediately. It should be checked together with market structure, support, resistance, liquidity areas, rejection, exhaustion, and Price Effort behavior.
Divergence signals are confirmed after the swing confirmation period, so they can appear a few candles after the actual high or low. They are best used as context, not as standalone entry signals.
Practical Use
Imperium Flow is best used to evaluate whether the current move has strong confirmation or is starting to lose quality.
The main read is Price Effort. Price Pressure and Money Flow should be used as supporting confirmation.
When all three support the same direction, continuation conditions are usually stronger. When they separate, fade, or conflict, traders may choose to become more selective with entries, exits, and trade management.
Mixed or unstable readings usually mean the market does not have clear directional control.
Important Notes
Exhaustion is a caution signal, not a guaranteed reversal;
Reversal warnings are for context and should not be treated as automatic buy or sell signals;
Divergence can appear before price reacts, especially during strong trends;
Money Flow, Price Pressure, and Price Effort should be read together;
Mixed readings usually mean the move lacks clear confirmation;
Readings may be less reliable on symbols with missing, unreliable, or illiquid volume;
Non-standard chart types may produce different readings because candle structure and volume behavior can be altered;
The indicator analyzes current and recent market behavior. It does not predict future price movement.
Imperium Flow is intended for structured market analysis and confirmation. It should be used as part of a broader trading process that includes market structure, execution rules, invalidation, and risk management. Indicator
Crypto Market Breadth Risk Planner [AGPro Series]Crypto Market Breadth Risk Planner
🧠 Core Idea
Is the crypto market showing broad risk-on participation, weakening rotation, or a risk-off breadth environment?
📌 Overview / What it does
Crypto Market Breadth Risk Planner is a chart-first market breadth tool built to evaluate whether a selected crypto basket is participating broadly or weakening internally.
Instead of reading only the active chart symbol, the script reviews a configurable basket of major crypto pairs. It measures how many symbols are trading above their trend baseline, how many have positive momentum, how many have rising trend structure, and how much volatility stress is present across the basket.
The script produces a 0-100 Breadth Risk Score, a colored breadth risk corridor on the active chart, event labels, right-side tags, alerts, and a compact AG Pro panel. It does not predict price direction, automate execution, or claim that breadth alone is enough to trade.
🎯 Purpose & Design Philosophy
This script was built because single-chart analysis can look strong while the broader crypto market is quietly weakening, or look weak while breadth is beginning to rotate back into strength.
The purpose is to help traders read market participation before treating an individual setup as clean. Strong setups usually have a better context when the broader basket is aligned, while weaker breadth can warn that a chart may be more exposed to false follow-through.
The design supports traders who want broader market context without opening ten charts manually. It turns cross-market participation into a simple decision-support layer that can be read directly on the current chart.
⚡ Why This Script Is Different
Most crypto tools focus on the active symbol, a single benchmark, a simple correlation reading, or a raw relative-strength line.
This script does NOT act as a benchmark correlation meter, a relative-strength rotation map, a volume spike detector, or a generic trend dashboard.
Instead, it evaluates breadth across a user-defined crypto basket and converts that participation into a risk-readiness framework. The goal is not to say which coin to buy or sell. The goal is to show whether the broader crypto environment is supportive, mixed, stressed, or risk-off.
⚙️ Methodology
1. Context Detection
The script requests data from a configurable crypto basket and evaluates each symbol on the selected breadth timeframe.
2. Reference Mapping
Each symbol is compared against its own trend baseline, momentum reading, trend slope, and ATR-based volatility stress condition.
3. Reaction Evaluation
The script combines trend participation, momentum participation, slope confirmation, and volatility stress into a single Breadth Risk Score.
4. Visual Output
The final output includes a colored breadth risk corridor, centered corridor text, event labels, right-side tags, optional bar coloring, alerts, and an AG Pro panel.
🗺️ How to Read the Chart
Zones:
The breadth risk corridor is a visual context zone around price. Its color reflects the current breadth regime rather than a direct support or resistance level.
Labels:
Labels mark important breadth state transitions such as Risk-On, Rotation Watch, Risk-Off, Stress Review, and Cooling.
Colors:
Teal represents broad constructive participation.
Pink represents risk-off breadth or weak participation.
Gold represents stress or caution.
Indigo represents improving rotation or transitional breadth.
Panel:
The panel summarizes breadth participation, Breadth Risk Score, momentum, stress, regime, and action state.
🚦 Signals & States
• Risk-On Ready → Broad participation and momentum are strong enough to support risk-on review.
• Rotation Watch → Breadth is improving, but not yet strong enough for full risk-on classification.
• Stress Review → Volatility stress is elevated while breadth quality remains weak.
• Risk-Off → Basket participation is weak or deteriorating.
• Cooling → Stress is easing while breadth quality begins to improve.
• Wait Breadth → No strong breadth regime is currently active.
🔔 Alerts Logic
Alerts can trigger when the basket shifts into Risk-On, Rotation Watch, Risk-Off, Stress Review, or Cooling.
Alerts are attention markers only. They highlight changes in the breadth model. They are not trade instructions, automated entries, or guaranteed market calls.
🧩 Confluence Logic
The context becomes stronger when multiple breadth layers align together.
For example, a high Breadth Risk Score with many symbols above their trend baselines, positive momentum participation, rising trend slopes, and low stress suggests a cleaner risk-on environment than a rally led by only one or two symbols.
Likewise, weak participation combined with elevated stress can warn that individual bullish setups may need stricter review.
📊 When to Use
• Crypto market context review
• BTC, ETH, altcoin, and sector-style crypto watchlists
• 1H, 4H, and 1D market participation analysis
• Before treating individual setups as risk-on
• When the trader wants to know whether the broader crypto basket supports the active chart
⚠️ When NOT to Use
• Markets where selected symbols have unreliable data
• Very small or illiquid crypto pairs with distorted candles
• Situations where the basket does not match the user's trading universe
• Low-timeframe scalping where external-symbol breadth may be too slow
• News-driven events where correlation and breadth can change abruptly
🎛️ Key Inputs
• Crypto Basket Symbols → define the assets used in the breadth model
• Breadth Timeframe → controls whether the basket is evaluated on chart timeframe, 1H, 4H, or 1D
• Trend Baseline Length → controls the EMA reference used for participation
• Momentum Length → controls the ROC window used for positive or negative participation
• ATR Stress Threshold → controls when basket volatility begins to count as stress
• Minimum Risk-On Score → controls how selective the risk-on state should be
• Visual Settings → control corridor, labels, right-side tags, panel location, theme, and font size
🖥️ Interface & Visual Design
The interface is designed to make broad crypto participation readable without turning the chart into a large dashboard.
The corridor gives a fast visual state directly on the chart. The panel provides the structured readout. Labels mark only important transitions, while cooldown and memory controls keep historical events from overwhelming the chart.
The visual intent is premium, clean, and publication-friendly.
🧪 Practical Usage Workflow
1. Read the panel to identify the current breadth regime.
2. Check the Breadth Risk Score and participation percentage.
3. Review whether momentum and stress support or conflict with the active chart setup.
4. Use the corridor color as a market-context layer, not as a direct entry zone.
5. Combine breadth context with price structure, volatility, liquidity, and personal risk rules.
🔍 Interpretation Guidelines
A strong score means the selected crypto basket is broadly aligned according to the script's rules.
A Rotation Watch state means breadth is improving, but the market has not fully confirmed broad risk-on participation.
A Stress Review state means volatility pressure is elevated while breadth remains weak or mixed.
A Risk-Off state means the selected basket is not supporting broad participation under the current settings.
🚫 What This Script Is NOT
This script is not a prediction engine.
This script is not financial advice.
This script is not an automated trading system.
This script does not place orders.
This script does not guarantee market direction, continuation, reversal, or profitability.
⚠️ Limitations & Transparency
This script depends on the selected symbols, selected timeframe, and PulseWire data availability.
Different baskets can produce different breadth readings. A BTC-heavy basket may behave differently from an altcoin-heavy basket. External symbol data may also load differently depending on market, exchange, and PulseWire availability.
The script should be interpreted as market context, not as a standalone execution model.
🧠 Market Context Notes
Crypto often moves through participation waves. Sometimes BTC leads while altcoins lag. Sometimes the whole market rotates together. Sometimes volatility rises while breadth deteriorates, creating a more fragile environment.
This script is designed to make that internal participation easier to observe directly from the active chart.
🧾 Use Case Examples
Example 1:
BTC is breaking higher, but the panel shows weak breadth and high stress. The trader may decide that the move needs extra confirmation before treating it as broad risk-on.
Example 2:
ETH is consolidating, but the basket shifts into Rotation Watch with improving momentum. The trader can monitor whether the active chart begins to align with the broader rotation.
Example 3:
The basket prints Risk-Off while an individual altcoin setup looks technically clean. The script warns that the broader market backdrop is not supportive under the current model.
🧱 System Philosophy
AGPro Series tools are built as decision-support frameworks, not signal vending machines.
This script follows that philosophy by turning broad market participation into a structured context layer: define the basket, score the breadth, map the state, and show the next action clearly.
🔐 Non-Promise Statement
This script does not promise certainty.
It does not promise that a risk-on breadth state will produce gains, or that a risk-off state will produce losses. It only organizes participation context so the user can evaluate the broader market with more clarity.
📉 Risk Disclosure
Trading involves risk.
Market conditions can change quickly, and breadth models can fail or become less useful during sudden volatility, exchange-specific moves, or news-driven repricing. Users remain responsible for their own decisions, execution, and risk management.
This script is for educational and analytical purposes only. It does not provide financial advice.
📚 Educational Note
Use this tool to study how crypto breadth changes before, during, and after major market moves.
Its strongest value comes from comparing the active chart with the broader basket context rather than reading any single label in isolation.
Indicator
Market Sessions [Crypto Imperija]Market Sessions is a clean session-mapping indicator designed for crypto traders who want to better understand how price behaves during different parts of the trading day.
The indicator highlights the main market sessions directly on the chart using customizable boxes, session names, session times, completed session high/low levels, sweep detection, reclaim detection and alerts.
It is especially useful for traders who work with liquidity concepts, session ranges, intraday market structure, and time-based trading analysis.
Default Sessions:
• Asian Session: 02:00 - 10:00 UTC;
• London Session: 09:00 - 17:30 UTC;
• New York Session: 16:30 - 23:00 UTC;
• Closed / Low Activity Session: 23:00 - 02:00 UTC.
1. Session Boxes
The indicator draws visual boxes around each selected session. Each box shows the full price range created during that session, including the session high and session low.
This helps traders quickly see:
• Where price ranged during a specific session;
• Which session created the most volatility;
• Whether price is expanding or consolidating;
• How the current session reacts to previous session ranges.
2. Session Names and Times
Each session box can display the session name and session time directly on the chart.
This makes it easier to follow the trading day without constantly checking the clock, especially when analyzing multiple timeframes or trading crypto markets that run 24/7.
3. Session High / Low Levels, Sweeps and Reclaims
After each session finishes, the indicator automatically draws the completed session high and low as horizontal levels. These levels are often important because previous session highs and lows can act as key liquidity areas. Traders commonly watch them to see whether price rejects from them, breaks through them, sweeps them, or reclaims them.
Examples of completed session levels:
• Asian High / Asian Low;
• London High / London Low;
• New York High / New York Low;
• Closed Session High / Closed Session Low.
The indicator detects two important events around these levels:
• Session Sweep:
A high sweep is detected when the current candle high reaches or moves above a completed session high.
A low sweep is detected when the current candle low reaches or moves below a completed session low.
• Session Reclaim:
After a sweep, the indicator watches the candle close.
If a completed session high is swept and price closes back below that high, it is considered a reclaim.
If a completed session low is swept and price closes back above that low, it is considered a reclaim.
This helps traders identify when price has interacted with a previous session liquidity level and whether the move continued or failed after the sweep.
4. Mitigated Levels
When a session level is swept, the trader can choose whether to remove it from the chart or keep it visible as a faded/dotted mitigated level.
This gives more control over chart cleanliness:
• Hide mitigated levels for a cleaner chart;
• Show mitigated levels to study how price reacts after liquidity is taken.
5. Customizable Visual Settings
The indicator includes multiple customization options:
• Show or hide session boxes;
• Show or hide session names;
• Show or hide completed session high/low levels;
• Show or hide price values on labels;
• Choose label size;
• Choose session level line style;
• Choose line width;
• Choose box border style;
• Choose box border width;
• Customize each session color;
• Hide weekend sessions.
This makes the indicator flexible for different trading styles, chart layouts, and visual preferences.
6. Alerts
The indicator includes alert conditions for:
• Session Sweep
• Session Sweep Reclaim
The alert messages can include the ticker, timeframe, swept level, price, and reclaim direction.
Important Notes:
This indicator does not predict price direction. It is a visual and alert-based tool that helps traders identify session ranges, completed session highs/lows, sweeps, and reclaims. A sweep does not guarantee a reversal, and a reclaim does not guarantee continuation in the opposite direction. These events should always be analyzed together with market structure, candle closes, volatility, volume, risk management, and a complete trading plan.
Trading involves risk. This indicator is for educational and analytical purposes only and should not be considered financial advice. Indicator
Bitcoin RSI Channel (2W, M)Bitcoin RSI Channel (2W, M)
The Bitcoin RSI Channel is a macro-analytical tool designed to identify long-term cyclical tops and bottoms of Bitcoin by applying linear regression modeling to the Relative Strength Index (RSI).
Traditionally, RSI levels like 70 and 30 are used as static markers for overbought and oversold conditions. However, as Bitcoin matures and its volatility dampens, its cyclical RSI peaks and troughs have historically followed a descending trajectory. This script accounts for that "fading" volatility by using mathematically fitted trendlines that track the actual historical extremes of Bitcoin’s momentum.
Main Objectives
Curve Fitting: Plots mathematically modeled linear regression lines through historical RSI peaks and bottoms, ensuring the channel remains as close as possible to the actual turning points of previous cycles.
Normalized View: Provides an optional "Normalized" mode where the dynamic channel is flattened into a 0-1 "Risk Metric" for easier comparison between cycles.
Main Chart Visualization: Directly projects overbought and oversold zones onto the price chart via plot coloring, allowing for a seamless confluence of price action and momentum analysis.
Cycle Forecasting: Designed as a high-timeframe tool to assist in predicting global market tops and generational buying opportunities.
IMPORTANT: Timeframe & Methodology
Please note that the regression lines in this script are specifically modeled for the 2-Week (2W) and Monthly (1M) timeframes.
These high timeframes were chosen because they significantly reduce market noise, making them superior for identifying global cycle shifts. The coefficients used in the code were derived from an approximation (fitting) of data points from 2011 through 2023.
Recommendation: Always wait for the candle to close on the 2W or Monthly timeframe to confirm a signal. Intra-candle fluctuations can be volatile and may provide premature signals before the period is finalized.
How to Use
Identifying Extremes: When the RSI enters the green "Buy Zone" or the red "Sell Zone," it historically indicates that Bitcoin has reached extreme oversold or overbought levels. These periods suggest the proximity of a potential cyclical bottom or top.
Visualizing on Price: These macro shifts are intuitively reflected through the price overlay on the main chart, providing immediate visual feedback on the current stage of the market cycle.
Strategic Caution: These zones have not been infallible in the past, and this indicator should not be used in isolation. Always seek confluence with other technical or fundamental analysis before making trading decisions.
User Tips
Clean View: You can hide the Bitcoin price bars on your main chart (via the Chart Settings) to focus entirely on the risk-based coloring provided by the indicator overlay.
Overlay Toggle: If you prefer to keep the indicator purely in its own pane, you can disable the "Plot on Main Pane" option in the script settings.
Settings & Parameters
View Mode: Switch between "Fit Lines" (standard RSI inside a diagonal channel) and "Normalized" (RSI converted into a Risk Metric).
Sell/Buy Zone Levels: Adjustable thresholds (default 0.90 and 0.10) to define your personal risk appetite for overbought and oversold conditions.
Plot on Main Pane: Toggle to enable/disable price bar colorization based on the current Risk Metric.
Limitations & Disclaimer
BTC Specificity: This indicator is purpose-built for Bitcoin. While you can load it on other symbols, the indicator pane will always calculate based on INDEX:BTCUSD data to maintain its cyclical logic. The main chart overlay, however, will color the plot of whatever instrument you are currently viewing.
Fixed RSI Optimization: The regression model is strictly optimized using the default RSI settings (14-period, Source: Close). The linear regression lines were fitted specifically to these values; therefore, the ability to modify the RSI length or source has been intentionally omitted from the settings. Changing these parameters would render the channel irrelevant, as the trendlines would no longer align with historical market extremes.
Static Modeling: The regression coefficients are "hardcoded" based on historical peaks and troughs up to 2023. As the market evolves, future cycles may require new approximations to account for shifting volatility.
No Guarantees: Mathematical models describe the past but do not guarantee the future. There is no guarantee that Bitcoin will reach the upper or lower boundaries in any given cycle, or that it will stay within them. Use this tool as one part of a comprehensive trading strategy.
Indicator
Indicator
Parabolic Move Detector [AGPro Series]🚀 Parabolic Move Detector
A dedicated framework for identifying, measuring, and classifying parabolic price acceleration across any asset and any timeframe. Built on a single transparent metric — Parabolic Pace — the tool objectively detects the start bar of a parabolic move, tracks its age, scores its intensity on a 0-100 scale, classifies its lifecycle phase, and contextualizes each move against the asset's own historical parabolic events.
🔹 OVERVIEW
Parabolic moves are notoriously difficult to recognize in real time. By the time they look obvious, the move is already late-stage. Conventional momentum tools (RSI, MACD, standard ROC) measure speed, not the underlying structural character of a parabolic move. They fire constantly on ordinary trends and miss what makes a parabolic move structurally different: the rate at which price is covering ATR-sized distance per bar.
Parabolic Move Detector closes that gap with a single, transparent metric. It measures how many ATRs price has moved per bar over a configurable lookback window. That is the literal mathematical definition of a parabolic move: sustained directional travel at an unusual speed relative to recent volatility. The framework auto-calibrates per timeframe and per asset, so a 15m memecoin pump and a 1D large-cap rally are measured with the same structural definition.
🔹 UNIQUE EDGE
Most acceleration or momentum indicators in the public space fall into two buckets: oscillators with hardcoded thresholds that need retuning per symbol, or composite "trend strength" meters that blur acceleration into raw trend direction. This tool is different in four concrete ways:
1. Single-metric detection engine. The entire detection pipeline is driven by one transparent number: Parabolic Pace = cumulative price move divided by cumulative ATR over the lookback. No percentiles, no hidden regressions, no black-box composite. This makes the tool easy to audit, fast to calibrate, and consistent across assets.
2. ATR-normalized by design. Because pace is expressed in ATRs per bar, it is inherently timeframe-adaptive and asset-adaptive. No need to retune for BTC vs a thin-volume altcoin, or for 15m vs 1W.
3. Four-phase state machine. Each move is classified through a deterministic lifecycle — Accelerating → Peaking → Decelerating → Exhaustion — with explicit transition conditions rather than heuristic labels. This turns a vague concept ("it looks parabolic") into a reproducible state with measurable transitions.
4. Per-asset historical statistics. The tool logs every completed parabolic cycle on the current chart, filters out micro-events, and reports the average duration and average drawdown from peak. That gives structural context no oscillator provides: what has this specific asset actually done the last N times it went parabolic.
🔹 METHODOLOGY
Core detection pipeline:
• Pace is computed as (close − close ) divided by (ATR14 × N), where N is the lookback window. The result is the number of ATRs traveled per bar.
• Pace is lightly smoothed with a short SMA to reduce single-bar noise.
• Detection triggers when smoothed pace exceeds the Pace Threshold and the move is directionally up.
• A minimum-duration filter requires the pace condition to persist for N consecutive bars before confirming the start, eliminating single-bar spikes.
• A post-move cooldown prevents the same move being re-detected as multiple events.
State machine transitions:
• Idle → Accelerating : pace sustained above threshold for the minimum duration.
• Accelerating → Peaking : Acceleration Score drops >20% from its cycle peak while still elevated.
• Any phase → Decelerating : score drops below 40% of cycle peak.
• Decelerating → Exhaustion : pace rolls over below half-threshold, and the move has lived at least 6 bars.
• Exhaustion → Idle : cooldown bars elapsed and score collapsed.
Acceleration Score (0-100) is a direct function of pace: score rises linearly with pace and receives a small persistence bonus for sustained upward momentum, capped at 100.
Historical statistics:
Each time a full cycle closes on the chart, the tool checks whether the move traveled at least the minimum ATRs from start to peak. If it qualifies, duration (start bar to peak bar) and drawdown from move high to subsequent low are averaged into rolling per-asset statistics.
🔹 STATES AND VISUALS
• Parabolic Zone : gradient background across the active move. Color reflects phase (brand blue in Accelerating, indigo in Peaking, amber in Decelerating). Intensity scales with Acceleration Score.
• Parabolic Start label : marks the confirmed start bar of a new move.
• Peaking / Decelerating labels : mark phase transitions. Labels are automatically suppressed within a confluence window to prevent stacking.
• Exhaustion label : marks the bar where the move has structurally collapsed.
• Duration Projection : dotted forward line sized to the asset's historical average parabolic duration, shown only while a move is active.
🔹 KEY INPUTS
Detection group:
• Pace Lookback — window over which parabolic pace is measured.
• Pace Threshold — minimum ATRs-per-bar required to qualify as parabolic.
• Minimum Move Duration — bars of sustained pace required before confirming a start.
• Minimum Event Size — minimum ATR-normalized move size required to log an event in historical statistics.
• Post-Move Cooldown — minimum bars after a completed move before a new one can start.
Historical Stats group:
• Show Duration Projection — toggle the forward projection line.
• Projection Length — forward projection cap in bars.
Visuals group:
• Parabolic Zone Background, Ambient Score Tint, Parabolic Start Label, Exhaustion Warning Label, Phase Transition Labels — all independently toggleable.
Style group:
• Label Size, Panel Size, Help Text Size — default Normal.
• Panel Location — six anchor positions.
• Panel Theme — Dark or Light.
Alerts group:
• Parabolic Start, Peaking Phase Reached, Exhaustion Detected — individually toggleable alerts.
🔹 HOW TO USE
• On any asset and any timeframe, wait for a confirmed Accelerating phase. The Parabolic Start label marks the reference bar.
• Track the Acceleration Score as the move develops. A score climbing toward 60-100 indicates a textbook parabolic.
• Compare Move Age against the panel's Avg Duration statistic. Moves significantly older than the asset's historical average are in late-cycle territory.
• Compare Move Change % against the Avg Reversal statistic for post-move drawdown context.
• Watch for the Peaking transition — this is the first structural deceleration, not a reversal call.
• The Exhaustion state marks where pace has decisively collapsed and the move is structurally over.
• Combine with your existing trend, structure, or volume framework. This tool is designed to complement directional analysis, not replace it.
🔹 LIMITATIONS AND TRANSPARENCY
• The tool detects and classifies acceleration structure. It does not predict reversals, tops, or bottoms. Avg Reversal is a post-cycle statistic computed from completed events on the current chart, not a forward-looking forecast.
• Historical statistics require completed cycles on the chart. Newly loaded symbols with few prior parabolic events will show low sample sizes until more cycles complete.
• The tool confirms a move only after pace has been sustained for the minimum duration. The start label is therefore plotted retroactively on its true start bar, which is the correct academic behavior for a sustained-condition detector.
• All computations are on confirmed bar close logic. No repainting of historical signals once a bar closes.
• The Pace metric requires a valid ATR reading, so at least 14+ bars of history are needed before the tool becomes active on a fresh chart.
🔹 RISK DISCLOSURE
This script is an analytical tool provided for educational and research purposes only. It is not a trading strategy, not financial advice, and does not generate buy or sell recommendations. Trading any market involves substantial risk of loss. All decisions and their consequences are the sole responsibility of the user. Past behavior of parabolic cycles on any asset does not guarantee future behavior.
Indicator
Round Number Magnet Map [AGPro Series]Round Number Magnet Map
════════════════════════════════════════
🔹 OVERVIEW
Round numbers act as psychological magnets on every liquid market. Traders cluster stop orders, limit orders, and mental entries around levels like 2000, 2400, 50000. These levels attract price, get tested repeatedly, and either hold with sharp reactions or break with decisive momentum. Yet most round-number tools ship a hard-coded list (100, 500, 1000) that works on some charts and fails on others.
Round Number Magnet Map is a psychological level engine that detects the right round numbers for any symbol automatically, tracks every touch with a composite reaction grading system, and ranks the strongest magnets in a professional leaderboard. It works out of the box on Bitcoin at 100k, on Ethereum at 2k, on Solana at 10, on EUR/USD at 1.05, on the S&P 500 at 5000, and on gold at 2400 — no configuration required. Traders who prefer manual control can override the auto-detected tiers with their own comma-separated list.
The indicator is asset-agnostic, non-repainting, bar-confirmed, and optimized for speed. It is designed to be a permanent chart companion on any timeframe.
🔹 UNIQUE EDGE
What separates Round Number Magnet Map from generic round-number indicators:
1. Asset-aware auto-detection. The script reads current price magnitude and selects the correct tier spacing automatically — 10000/5000/1000 for high-cap assets, 100/50/10 for mid-cap, 0.01/0.005/0.001 for forex majors. Three nested tiers render simultaneously so both major and minor psychological levels are visible with a clear visual hierarchy.
2. Composite reaction grading. Each touch is not just counted — it is graded. The script combines three inputs: ATR reaction (how many ATRs price traveled after the touch), wick rejection ratio (how strongly the touch bar rejected the level), and relative volume (whether institutional flow confirmed the reaction). The result is a 0-100 score mapped to A/B/C/D grades, so traders can distinguish a truly respected magnet from a level that price simply grazed.
3. Broken-level recovery logic. Most tools mark a level as "broken" the first time price closes through it and leave it broken forever. That is wrong on round numbers — price oscillates around 2000, 3000, 10000 repeatedly across months and years. This engine un-breaks a level the moment price returns to its zone, so the map always reflects current reality.
4. On-chart leaderboard. The panel ranks the top 5 most-touched levels visible in the current chart window, with touch count and composite grade, so the strongest magnets are always one glance away.
5. Clean by design. Rendering is restricted to an ATR-scaled window around current price, with optional toggles to hide broken and untouched levels. The chart stays readable even on high timeframes where dozens of round numbers would otherwise clutter the view.
🔹 METHODOLOGY
Tier generation. When auto-detect is enabled, the script classifies current price into a magnitude bucket (>10000, 1000-10000, 100-1000, 10-100, 1-10, <1, etc.) and assigns a three-tier spacing. Tier 0 is the major step, tier 1 is a half-step, tier 2 is a fine step. All three tiers are generated around current price within an ATR-scaled search range, deduplicated, and capped at a configurable maximum (default 20).
Touch detection. Each level is surrounded by a zone of thickness (ATR × configurable multiplier, default 0.20). A touch is registered when a bar's high-low range intersects the zone and at least N bars have passed since the last touch on that level (cooldown, default 5). This prevents a single consolidation from inflating the touch count.
Reaction grading. Exactly N bars after a touch (default 5), the script computes:
• ATR reaction (60% weight): maximum favorable excursion from the level in the direction of the test, normalized against a target of 2 ATRs = score 100.
• Wick rejection (25% weight): the rejection wick on the touch bar relative to the bar's range.
• Relative volume (15% weight): volume on the touch bar relative to the 20-bar average.
The three components are combined into a single 0-100 composite score. Scores of 80+ are grade A, 65-80 are grade B, 45-65 are grade C, below 45 are grade D.
Break detection. A level is marked as broken only when, during a reaction grading, price has closed beyond the zone by an additional 0.3 ATR in the opposite direction of the test. This strict criterion avoids false breaks from single wicks or low-conviction closes. Broken levels are un-marked automatically when price returns to the zone.
Rendering. Active non-broken levels render as solid blue lines with an optional S/R-style zone box. Broken levels render as dashed gray lines with a BRK badge. Labels show price, touch count, and grade. Priority-0 (major) levels render with increased line width, and levels within 1 ATR of price render thicker still (magnet effect).
🔹 SIGNALS & ALERTS
The script generates four non-repainting, bar-confirmed alert conditions:
• Touch — price has entered a round-number zone.
• Held (Strong Reaction) — a touch has resolved with a composite score ≥ 60, meaning the level held with meaningful reaction strength.
• Broken — a level has been decisively broken by a strong close beyond the zone.
• Magnet Approach — price is within 0.5 ATR of a level, approaching without yet touching.
Each alert fires at bar close and carries ticker and timeframe tokens for routing to external automation.
🔹 KEY INPUTS
Detection
• Auto-Detect Tiers — asset-aware tier selection (recommended).
• Custom Tiers — comma-separated override (e.g., "1000,500,100" for BTC).
• Level Search Range — how far from price to generate levels, in ATR-scaled units.
• Max Active Levels — hard cap on rendered levels (default 20).
Touch & Zone
• Zone Thickness — size of each round-number zone in ATR units (default 0.20).
• ATR Length — period for ATR used in zone and reaction calculations (default 14).
• Touch Cooldown — minimum bars between touches on the same level (default 5).
• Reaction Window — bars after a touch used for reaction grading (default 5).
Reaction Grading
• Weight: ATR Reaction / Wick Rejection / Relative Volume — configurable composite weights. Weights are normalized automatically if they do not sum to 1.
• ATR Normalization Target — the ATR-reaction value that maps to score 100.
Visuals
• Show Zones, Show Level Labels, Hide Broken Levels, Hide Untouched Levels, Magnet Effect.
• Far Levels Transparency, Label Size, Label Offset.
Panel
• Show Panel, Panel Location (6 options), Panel Theme (Dark/Light), Panel Font Size.
Alerts
• Independent toggles for Touch, Held, Broken, Magnet Approach.
🔹 HOW TO USE
The indicator is designed for discretionary trading and framework-based decision making. A few practical patterns:
1. Use the nearest Above and Below levels in the panel as your immediate target and invalidation reference. The Strongest line on the panel is the highest-conviction magnet in view.
2. Grade A and B levels are historically respected by this market. When price approaches one, expect a reaction. When price approaches a Grade D level, expect a clean pass-through or a trap.
3. Confluence with other tools. Round numbers combined with a swing high/low, a moving average, or a Fibonacci level are far more likely to hold than a round number alone. Treat this indicator as one layer in a stacked decision framework.
4. Timeframe selection. Use higher timeframes (1D, 4H) to identify the dominant magnets for position trading, and drop to lower timeframes (1H, 15m) for execution around those same levels.
5. Broken levels are still information. A dashed level with 20+ historical touches is a zone where liquidity has been swept and where retests often provide re-entry opportunities.
🔹 LIMITATIONS & TRANSPARENCY
• This tool identifies psychological levels and grades their historical reaction quality. It does not predict price direction and it is not a trading strategy. Use it as part of a complete decision framework.
• Reaction grades are historical, not forward-looking. A level that held five times may still break on the next test, especially in strong trending conditions or during high-impact news events.
• Touch counts depend on chart history. On symbols with limited history, recent levels may have fewer touches than their true significance warrants.
• The reaction window is fixed (default 5 bars). Reactions that take longer to develop will be graded as weaker than they truly are. Adjust the window to match the instrument and timeframe.
• Extremely low-volume symbols may produce noisy reaction scores because the relative-volume component becomes unreliable. Reduce its weight to 0 in such cases.
🔹 RISK DISCLOSURE
This indicator is a technical analysis tool for educational and discretionary decision support. It does not constitute financial advice, investment advice, a solicitation, or a recommendation to buy or sell any instrument. Past reactions at any level do not guarantee future behavior. All trading involves substantial risk of loss. You are solely responsible for your trading decisions and for managing your capital.
Indicator
Swap Engine - Pair Rotation (Z-Score) [AGPro Series]Swap Engine - Pair Rotation (Z-Score)
🔷 OVERVIEW
Swap Engine - Pair Rotation (Z-Score) transforms the log-ratio between two correlated crypto assets into a disciplined tier ladder decision framework. Rather than signalling single-asset direction, the engine measures how stretched one pair has become relative to its rolling mean and proposes rotation between the two assets when the spread reaches statistically meaningful extremes. Every decision is evaluated on confirmed Engine TF bar close, keeping suggestions non-repainting under the configured execution model.
🟣 UNIQUE EDGE
Unlike single-symbol mean-reversion or trend indicators, this engine treats the ratio itself as the tradable variable and pairs it with a full operational stack: a tiered exposure ladder (T0 to T3), an Integrity Gate that blocks entries when the pair relationship deteriorates, a Trend Regime filter that respects persistent one-sided moves, and a confirm-first execution model that converts raw signals into auditable decisions. A dedicated Signal Quality score (Q 0-100) and Integrity Score (IN 0-100) make every suggestion inspectable, not a black box.
🟢 METHODOLOGY
The engine fetches the closing price of Pair A and Pair B on the chosen Engine TF, computes the log-ratio L = ln(A / B), then derives a rolling z-score using user-defined lookback length. Entry thresholds (Z1, Z2, Z3) define the three tiers of exposure; exit thresholds (hysteresis) define when each tier is scaled back. A cost filter requires the expected mean-reversion edge to exceed a configurable multiple of estimated roundtrip cost before any entry is allowed. The Integrity Gate continuously validates rolling return correlation, ratio drift, and spread-volatility expansion, halting new entries when the pair relationship degrades.
🟡 SIGNALS & ALERTS
Each signal renders as a clearly tagged label on chart showing the action type (ENTRY / EXIT), source tier, target tier, direction (A->B or B->A), z-score snapshot, delta %, and Reason Code. Alerts are provided for: entry and exit events per direction, pending lifecycle (created, confirmed, skipped, expired), trend regime activation edges, duplicate suppression, and configuration warnings. All alerts fire on Engine TF bar close to remain consistent with the visible suggestions.
⚙️ KEY INPUTS
Pair A / Pair B: the two assets to rotate between (same quote currency recommended).
Engine TF: timeframe used for all ratio, z-score, and decision logic (240 / 4H default).
Lookback: bars used for rolling mean and standard deviation.
Entry Z1/Z2/Z3, Exit Z1/Z2/Z3: tiered thresholds for scaling in and out.
Tier Sizing (T1 / T2 / T3 %): rotation size per tier as a percentage of the active pool.
Trade Profile: preset gate behavior (Conservative, Balanced, Aggressive, Volatile Alt, High-Cost, Custom).
Integrity Gate: correlation, drift, and volatility expansion filter with configurable minimum score.
Execution Model: ASSUME (auto-advance), CONFIRM (pending + manual commit), or SIGNAL_ONLY (display only).
🔵 HOW TO USE
Start on the default BTCUSDT vs ETHUSDT pair on 4H Engine TF with the Balanced profile. Keep the chart timeframe equal to or lower than the Engine TF (the script warns otherwise). Watch the status panel for the current tier, direction, confidence strip (Q / IN / PH), and next action preview. In CONFIRM mode, a PENDING card appears when a signal fires; increase CONFIRM +1 to commit the rotation state, or SKIP +1 to discard. Use the Trade Profile dropdown to tighten or loosen effective gates without changing your base inputs.
🟠 LIMITATIONS & TRANSPARENCY
This is an indicator, not a strategy; no orders are placed and no backtest statistics are produced. Signals reflect statistical extremes in the pair's log-ratio and do not guarantee mean reversion. Performance depends heavily on pair selection - assets with persistent trends, broken correlation, or structural regime changes can cause extended adverse periods. The Integrity Gate mitigates but does not eliminate this risk. Costs, slippage, tax, and execution details are the user's responsibility; the Min Edge x filter is an estimate, not a realized-cost guarantee. Always validate on your own pair, timeframe, and account conditions before relying on any suggestion.
🔴 RISK DISCLOSURE
Trading and rotating between crypto assets involves substantial risk, including loss of capital. Past or simulated behavior of the ratio does not guarantee future results. This tool is shared for educational and analytical purposes only and does not constitute financial, investment, or trading advice. Users are solely responsible for their own decisions and should consult a qualified professional before committing capital. Indicator
CVD Multi Exchange PercentileCVD Multi Exchange Percentile
Aggregated order flow across four major crypto derivatives exchanges — with historical percentile ranking to measure how extreme today's session really is.
A Cumulative Volume Delta (CVD) indicator with daily reset, divergence detection, and absorption signals, built for perpetual futures.
It combines Binance, Bybit, OKX, and Bitget into a single aggregated flow, then ranks it against its own history to give you objective context.
█ 🧩 KEY FEATURES
🔹 Multi Exchange Aggregation
Four sources (Binance, Bybit, OKX, Bitget) can be toggled independently. The aggregated delta captures cross-exchange order flow that single-source CVD cannot detect — especially during liquidations or arbitrage-driven moves.
🔹 Historical Percentile System
Each session's peak CVD is stored in a rolling buffer, separated by direction (bull vs bear). The current session is ranked against this distribution to measure how extreme the flow is compared to recent history.
🔹 Live Percentile
A real-time percentile tracks the current CVD value as the session develops — no need to wait for session close.
🔹 Swing Divergence
Detects divergences between price and CVD structure:
- Bullish: price makes lower low, CVD makes higher low
- Bearish: price makes higher high, CVD makes lower high
Filtered by percentile threshold and optional trend filter.
🔹 Volume Absorption
Highlights conditions where price and CVD move in opposite directions under high volume:
- Bullish absorption: price down, CVD up
- Bearish absorption: price up, CVD down
Requires elevated volume and percentile confirmation.
🔹 Visual Encoding
Histogram color reflects direction and momentum. Signal markers:
- Divergence bullish: dark green triangle up
- Divergence bearish: blue triangle down
- Absorption bullish: orange circle
- Absorption bearish: purple circle
Optional info table provides real-time stats.
Signal examples on TRXUSDT.P (1H) — three signal types visible:
- Orange circle (Absorption Bull): price dropping but CVD rising on high volume — buying pressure hidden under falling price
- Blue triangle (DIV- Bearish): price making higher high but CVD making lower high — selling pressure building despite rising price
- Purple circle (Absorption Bear): price rising but CVD falling on high volume — selling pressure hidden under rising price
Signal examples on ETHUSDT.P (1H) — bullish signals visible:
- Dark green triangles (DIV+ Bullish): price making lower lows but CVD making higher lows — buying pressure increasing despite falling price, signaling potential reversal
- Orange circle (Absorption Bull): same logic as above — hidden buying under selling candles
█ 🔧 HOW IT WORKS
The script fetches lower-timeframe OHLCV data from each exchange using `request.security_lower_tf()`.
Each intrabar volume is classified using a CLV-based model (close location within range) to estimate buying vs selling pressure. The resulting deltas are summed across all exchanges and accumulated into a daily CVD, resetting at the start of each new UTC session.
█ 📖 HOW TO USE
Apply the indicator to Perpetual Futures charts (.P).
The symbol is auto-detected from the chart and mapped across all supported exchanges — no manual input needed.
Suggested timeframe: 1H (default percentile lookback is 336 bars, which equals ~14 days on 1H charts).
Signals are contextual, not standalone triggers. Use them to identify:
- flow/price divergences
- potential absorption zones
- extreme participation conditions
█ ⚙️ SETTINGS
Data Sources (Perpetual Futures Only) — Enable/disable Binance, Bybit, OKX, Bitget
Settings — Intrabar precision (1/5/15/60), daily reset
Signals — Percentile lookback (default 336 bars, ~14 days on 1H), min percentile for divergence (75), swing length (8), trend filter SMA (20), absorption volume lookback (10) and multiplier (1.5), show/hide toggles for divergences, absorption, trend filter, and info table
█ 💡 WHAT MAKES THIS DIFFERENT
Most CVD indicators rely on a single exchange and lack statistical context.
This script aggregates flow across venues and ranks it using a percentile system, providing a clear measure of whether current activity is extreme or routine.
Bull and bear distributions are handled separately, avoiding distortion from mixed data.
█ ⚠️ LIMITATIONS
— Works only on perpetual futures (.P required)
— Delta is estimated from OHLCV, not tick-level order book data
— Exchange data availability may vary by symbol
— Intrabar resolution affects precision and performance
█ 📌 DISCLAIMER
This is a contextual analysis tool, not a signal generator.
It does not provide buy/sell signals and should not be used as a standalone trading system. Always apply proper risk management.
Indicator
Head & Shoulders Auto Detector [AGPro Series]Head & Shoulders Auto Detector
🎯 **Overview**
Head & Shoulders Auto Detector is a precision pattern recognition tool that automatically identifies classic Head & Shoulders (bearish) and Inverse Head & Shoulders (bullish) reversal formations across any market and timeframe. Built from the ground up for traders who want the full lifecycle of a pattern tracked on-chart — not just a label and a line, but forming → confirmation → target/stop outcome — with a transparent, quality-scored framework that filters low-probability setups before they clutter the chart.
Every pattern carries a composite quality score, a symmetry percentage, an ATR-adaptive neckline, two projection targets, and a live status label that evolves through the pattern's lifespan.
🔹 **Unique Edge**
Most H&S indicators stop at detection. This one goes further:
• **Full lifecycle state machine** — every pattern moves through four explicit states (Forming → Confirmed → Target Hit / Stopped / Invalidated / Expired), and the visuals update in real time at each transition.
• **Dead pattern hygiene** — once a pattern fails or hits target, orphan TP and stop lines are removed, the neckline freezes at the decision bar, and the status label grays out. The chart never accumulates stale clutter.
• **Quality-driven visual hierarchy** — high-quality patterns (Q≥75) are rendered with a star marker and full saturation, mid-tier patterns get standard treatment, and low-tier patterns (Q<60) fade into the background so the trader's eye is guided to what matters.
• **Dual-target projection with R:R** — every confirmation displays both a classic measured-move TP1 and an extended 1.618× TP2, each labeled with the exact reward-to-risk ratio calculated at entry.
• **ATR-adaptive everything** — shoulder tolerance, neckline flatness, head prominence, stop buffer, and label offsets all scale with volatility, so the same settings work across BTC 4H, gold daily, or small-cap stocks.
🔹 **Methodology**
Patterns are detected from confirmed pivot highs and lows using a configurable pivot length. For a valid Head & Shoulders, three same-side pivots (Left Shoulder → Head → Right Shoulder) must satisfy:
• Head extends beyond both shoulders by at least the configured ATR multiple (prominence test).
• Shoulder heights differ by less than the shoulder tolerance in ATR units (symmetry test).
• Two opposite-side pivots between LS-Head and Head-RS define the neckline; their vertical distance must be within the neckline tolerance.
• Composite symmetry score (50% time symmetry, 50% price symmetry) must exceed the minimum threshold.
Quality score combines four weighted components:
• Symmetry (45%) — time + price balance between shoulders
• Neckline flatness (25%) — how horizontal the neckline is
• Volume profile (15%) — head-bar volume relative to shoulder average
• Head prominence (15%) — how clearly the head dominates
Confirmation triggers when price closes beyond the neckline level (interpolated for sloped necklines). Stop is placed at the head level plus an ATR buffer to avoid wick stop-outs. TP1 uses the standard head-to-neckline measured move; TP2 extends to 1.618× that projection.
🔹 **Signals & Alerts**
Four alert events available:
• **Pattern Forming** — a valid H&S or Inverse H&S structure has been detected but not yet confirmed.
• **Pattern Confirmed** — close has broken the neckline; entry is live with TP/Stop drawn.
• **Target Hit** — TP1 has been reached on a confirmed pattern.
• **Neckline Retest** — after confirmation, price has returned to touch the neckline (common high-probability re-entry zone).
🔹 **Key Inputs**
• **Pivot Length** — controls swing-point sensitivity
• **Min Symmetry Score** — minimum shoulder symmetry percentage to accept a pattern (default 60, balanced)
• **Neckline Tolerance (ATR)** — how sloped a neckline is allowed to be
• **Shoulder Height Tolerance (ATR)** — how different the two shoulders can be
• **Head Prominence (ATR)** — minimum head extension beyond shoulders
• **Volume Soft Confirmation** — toggle volume influence on quality score
• **TP1 Method** — Classic (horizontal neckline reference) or Measured Move (slope-aware)
• **Stop Buffer (ATR)** — extra room beyond the head level (default 0.35)
• **Max Pattern Lifetime** — bars after which an unconfirmed pattern expires
• Full visual controls: font size, panel position, theme, zone display, label offset, color palette
🔹 **How to Use**
1. Apply the indicator to any liquid market and timeframe. 4H and higher tend to produce the most reliable formations; intraday works but expects more noise.
2. Watch for patterns labeled with a ⭐ and bright color (Q≥75) — these are the highest-confidence setups.
3. Wait for the ✓ Confirmed status to appear before entering; the ⚡ breakout marker pinpoints the exact confirmation bar.
4. Use the TP1 / TP2 R:R labels to size the trade. Stop is pre-calculated at head level + ATR buffer.
5. Monitor the panel stats over time to understand the indicator's behavior on your specific market — Win Rate, Avg Quality, and Last Signal all update live.
6. Consider combining with trend context (a bearish H&S is far more powerful at resistance in a downtrend than in the middle of a strong uptrend).
🔹 **Limitations & Transparency**
• Pattern detection uses confirmed pivots, so signals appear with a natural delay equal to the Pivot Length setting. This is intrinsic to pivot-based logic, not a flaw.
• Quality score and historical win rate are chart-native calculations based on the loaded history; they are descriptive, not predictive.
• The script does not include multi-timeframe confluence or trend filters — these are deliberate design choices to keep the tool focused and composable with other indicators.
• Volume confirmation is a soft scoring input, not a hard filter, since many crypto pairs and indices have volume data of variable reliability.
• Pattern state transitions use close-based confirmation; intrabar wicks do not trigger state changes except for stop/target hits, which are high/low based as expected.
🔹 **Risk Disclosure**
This indicator is an analytical tool, not a trading recommendation or financial advice. Pattern recognition describes what has formed on a chart; it does not predict future price movement with certainty. Always use proper risk management, position sizing, and confirm signals with your own analysis. Past pattern statistics shown on the panel are descriptive of the visible history and do not guarantee future performance. Trading involves substantial risk of loss. Indicator
