OPEN-SOURCE SCRIPT
Aggiornato Open Interest Commitment Map [AGPro Series]
Open Interest Commitment Map [AGPro Series]
🧠 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 TradingView 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 TradingView 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.
🧠 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 TradingView 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 TradingView 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.
Note di rilascio
UPDATE NOTES - V1.3This update focuses on right-side tag separation, projected badge readability, and cleaner screenshot composition.
The core purpose of the script remains unchanged.
This release improves how the existing logic is presented, organized, and interpreted on the chart.
This script continues to function as an analytical and visualization tool.
It does not attempt to predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
• Refined projected center-badge positioning
The commitment-zone badge remains in the projected zone area but now sits slightly farther left so it has more breathing room from the right-side tag stack.
• Improved right-side tag stacking
The OI tag is no longer placed on the exact same vertical line as the centered commitment badge.
• Increased default right-tag spacing
The default spacing between state, OI, and score tags is wider for cleaner 4H and 1W screenshots.
• Preserved the original commitment engine
No changes were made to open interest logic, score calculation, state classification, alerts, or fallback behavior.
------------------------
Visual Improvements
------------------------
• Reduced overlap risk between the centered zone badge and the OI change tag.
• Improved first-glance readability around the projected zone edge.
• Kept the premium commitment zone, rails, event labels, right-side tags, and AGPro panel identity intact.
• Maintained the single merged blue panel header row.
------------------------
Interface & Usability
------------------------
• Zone Label Anchor remains available for screenshot-specific horizontal badge adjustment.
• Right Tag Spacing ATR remains available for controlling the vertical separation of the right-side tag stack.
• Panel show/hide, panel location, panel theme, panel font size, and label font size controls remain unchanged.
------------------------
Behavior Notes
------------------------
This update does not change the core analytical logic of the script.
The goal is to improve clarity and usability, not to introduce new predictive behavior.
Users should interpret outputs the same way as before, but with cleaner label separation.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Open interest symbol availability varies by exchange, symbol format, and market.
Market conditions such as volatility, liquidity, derivatives participation, and timeframe differences may affect how states appear.
Outputs should always be interpreted within broader market context.
------------------------
Risk Reminder
------------------------
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.
Note di rilascio
🔧 UPDATE NOTES - v1.4This update focuses on readability, decision usability, and proof of context.
The core purpose of the script remains unchanged. It continues to map open
interest commitment, contraction, absorption, and reset behavior with a projected
commitment zone and an AG Pro panel.
This script remains an analytical and visualization tool. It does not attempt to
predict price direction or provide guaranteed outcomes.
------------------------
What Changed
------------------------
• Commitment Follow Rate
A new stop-aware statistic reports, of past long and short builds, how many
followed through by the target distance in the committed direction before
reversing to the opposite stop. It is evaluated on confirmed bars only, shows
"Building (n)" until enough samples exist, and is color-graded by tier.
• Decision-oriented panel
The panel now ends with an Action read (long commitment, short commitment,
positions unwinding, absorption caution, or check source) alongside the Follow
Rate, replacing the static attention-marker row, so the dashboard guides
interpretation rather than only listing values.
• Readable labels, badge, and tags
All event labels, the centered zone badge, and the right-side state, OI, and
score tags now use a luminance-aware text color, so the text stays legible on the
teal, pink, gold, and indigo fills instead of washing out.
• Cleaner panel content
Removed duplicate panel values and surfaced the commitment distance and OI source
where they are most useful.
------------------------
Visual Improvements
------------------------
• Improved chart readability by placing dark or light text automatically on each colored fill
• Reduced visual clutter to enhance first-glance interpretation
• Refined visual hierarchy so the active state and follow rate stand out more clearly
• Kept right-side tags readable by separating the state, OI, and score tags vertically when the zone is narrow, so they no longer stack on tight charts
------------------------
Interface & Usability
------------------------
• Optimized panel layout for clearer information flow, ending on an action read
• Improved label readability for better chart interaction
• Adjusted default visual settings for a more balanced appearance
• Enhanced overall user experience without changing the commitment logic
------------------------
Behavior Notes
------------------------
The commitment engine is unchanged.
The Commitment Follow Rate describes historical behavior only. Open interest
commitment is a context, not a directional guarantee, so the follow rate reflects
how builds have historically resolved rather than forecasting the next move.
For real open interest, use the indicator on a market whose OI feed is available
(the panel Data Mode shows Open Interest, Volume Proxy, or No OI Data). Use the OI
Symbol Mode input if your exchange uses a different OI symbol format.
------------------------
Limitations Reminder
------------------------
The script remains a rule-based analytical tool.
Market conditions such as volatility, liquidity, exchange differences, and
timeframe differences may affect how the commitment state and follow rate appear.
Outputs should always be interpreted within broader market context.
------------------------
Risk Reminder
------------------------
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.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.
Script open-source
Nello spirito di TradingView, l'autore di questo script lo ha reso open source, in modo che i trader possano esaminarne e verificarne la funzionalità. Complimenti all'autore! Sebbene sia possibile utilizzarlo gratuitamente, ricordiamo che la ripubblicazione del codice è soggetta al nostro Regolamento.
Public-free scripts + invite-only AGPro workflows for market analysis, liquidity context, risk planning and execution review.
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Rules-based. No hype. No guesswork.
Library & access: agprolabs.com/
Telegram: t.me/agprolabs
Declinazione di responsabilità
Le informazioni e le pubblicazioni non sono intese come, e non costituiscono, consulenza o raccomandazioni finanziarie, di investimento, di trading o di altro tipo fornite o approvate da TradingView. Per ulteriori informazioni, consultare i Termini di utilizzo.