OPEN-SOURCE SCRIPT
Auction Regime Atlas v1.0

# 🧭 Auction Regime Atlas v1.0
Auction Regime Atlas is a Pine Script v6 overlay indicator designed to visualize market acceptance, value migration, rejected auction areas, and contextual auction regimes directly on the chart.
❌ It is not a buy/sell signal tool.
❌ It is not a strategy.
❌ It is not an orderflow or liquidation-data replacement.
🎯 The goal is to help traders understand where price has been accepted, where value is forming, where price has moved away from value, and whether the current market context is balanced, transitional, displaced, or low quality.
---
## 💡 Core Idea
Markets often rotate around accepted value before moving into new auction areas.
Auction Regime Atlas maps that process by combining:
* price acceptance over a lookback window
* volume participation
* candle efficiency
* wick/rejection behavior
* higher-timeframe context
* regime classification
* distance from current value
📊 The result is a compact visual framework for understanding auction context without flooding the chart with signals.
---
## 🚀 Main Features
### 1. 🎯 Core Value Band
The Core Value Band highlights the price area where recent market activity shows the strongest acceptance.
It is calculated from a price-bin acceptance model using:
* time spent near price
* volume concentration
* close location
* wick/rejection behavior
⚠️ This band is meant as auction context, not as a mechanical support or resistance level.
---
### 2. 📏 Acceptance Edges
Upper and lower acceptance edges define the boundaries of the current accepted value area.
These edges help identify whether price is:
* inside accepted value
* above value
* below value
* far away from value
---
### 3. 🔄 Auction Regime
The dashboard shows a simplified auction regime state.
Current v1.0 regime states include:
* Neutral
* Balance
* Migration Up
* Migration Down
* Failed Auction
🛡️ The regime engine uses confirmed-bar logic and cooldown handling to avoid excessive state flipping.
---
### 4. 🌍 HTF Context
The indicator includes a higher-timeframe context layer based on confirmed higher-timeframe data.
ℹ️ This is used only as context and does not create entry or exit signals.
---
### 5. 📍 Location Awareness
The Location field shows where current price is relative to the accepted value area:
* Inside Value
* Above Value
* Below Value
* Away From Value
* No Value
When price is far away from the value zone, the visual relevance of the Core Band is reduced so the zone does not appear like an active trade signal.
---
### 6. 🎨 Visual Modes
Auction Regime Atlas includes three modes:
#### 🎯 Focus Mode
A clean minimal view for live chart reading.
Shows:
* Core Value Band
* Acceptance Edges
* compact dashboard
* no debug rows
#### ⚖️ Balanced Mode
Adds additional context zones while keeping the chart clean.
Shows:
* Core Value Band
* Acceptance Edges
* transitional/rejection context
* vacuum/context areas where applicable
#### 🔬 Research Mode
Adds validation and diagnostic rows for development, review, and deeper inspection.
Shows:
* object count
* validation status
* pending state information
* alert condition status
---
## 📋 Dashboard Fields
The compact dashboard includes:
* Mode
* Regime
* HTF Context
* Core Value Band
* Acceptance Score
* Location
* Activity
* Context Quality
🔬 Research Mode can additionally show:
* Validation Status
* Object Count
* State Debug
* Alert Debug
---
## 🔔 Alerts
The indicator includes four confirmed-bar alert conditions:
* New Auction Regime
* Value Migration Started
* Acceptance Edge Broken
* Failed Auction Detected
⚠️ Alerts are context alerts only.
They are not trade entry or exit instructions.
---
## 🛠️ Suggested Use
Auction Regime Atlas is best used as a context layer.
Useful questions:
* Is price currently inside accepted value?
* Is price moving away from value?
* Is the market balanced or transitioning?
* Did price leave value without building new acceptance?
* Is the current move happening near or far away from accepted value?
* Does higher-timeframe context support or contradict the current auction?
✅ Recommended starting use:
* Focus Mode for clean chart reading
* Balanced Mode for broader context
* Research Mode only for diagnostics and validation
---
## 📖 Practical Workflow
A simple way to interpret auction conditions is to combine Regime, Location Awareness, and HTF Context into a structured process.
### 1️⃣ Step 1: Start With HTF Context
First identify the higher-timeframe backdrop shown in the dashboard.
Ask:
* Is the higher timeframe supportive of directional movement?
* Is it balanced or already migrating?
* Does it align with the current chart or create conflict?
🌍 HTF Context provides the broader auction environment in which lower-timeframe activity is occurring.
### 2️⃣ Step 2: Check Current Location
Next evaluate where price is relative to accepted value.
* Inside Value suggests ongoing acceptance and rotational behavior.
* Above Value or Below Value suggests price is testing outside accepted value.
* Away From Value suggests displacement from the current auction area.
* No Value suggests acceptance has not yet formed clearly.
📍 Location helps determine whether price is interacting with value or operating away from it.
### 3️⃣ Step 3: Read the Active Regime
Then assess the current Auction Regime state.
* Balance implies acceptance and rotational trade around value.
* Migration Up or Migration Down implies value is attempting to relocate.
* Failed Auction suggests an attempted move has not established acceptance.
* Neutral indicates limited directional auction information.
🔄 The regime describes the current phase of the auction process rather than predicting the next move.
### 4️⃣ Step 4: Compare Regime and Location
The most useful information often comes from the relationship between regime and location.
Examples:
* Balance + Inside Value often reflects stable acceptance.
* Migration Up + Above Value may indicate value expansion higher.
* Migration Down + Below Value may indicate value expansion lower.
* Failed Auction + Away From Value may indicate rejection of a recent auction attempt.
📊 This comparison helps identify whether price behavior is consistent with the current auction state.
### 5️⃣ Step 5: Evaluate Market State Transitions
Watch for changes between regimes while monitoring location relative to value.
Common transitions include:
* Balance → Migration Up
* Balance → Migration Down
* Migration → Failed Auction
* Failed Auction → Balance
🔍 A transition becomes more meaningful when it is supported by location changes and aligned with HTF Context.
### 6️⃣ Step 6: Build a Contextual Narrative
Rather than treating any single field as a signal, combine all three layers:
1. Determine the higher-timeframe backdrop.
2. Identify where price is relative to value.
3. Assess the active auction regime.
4. Monitor whether the relationship between those factors is strengthening or weakening.
🧠 This workflow helps traders interpret whether the market is accepting value, rejecting value, migrating toward a new value area, or transitioning between auction states.
---
## 📈 Recommended Markets and Timeframes
The indicator is designed for liquid markets, especially:
* crypto perpetuals
* major crypto spot markets
* liquid index or futures markets
* high-volume intraday instruments
⏱️ Suggested timeframes:
* 5m
* 15m
* 1h for higher timeframe context
---
## ⚠️ Important Limitations
Auction Regime Atlas does not use true orderflow, footprint, delta, liquidation, or exchange-level positioning data.
All calculations are based on OHLCV data available in Pine Script.
❌ The indicator does not predict price direction.
❌ It does not guarantee reversals, continuations, or breakouts.
❌ It does not provide financial advice.
📌 The visual zones should be interpreted as auction context, not as automatic trade levels.
---
## 🛡️ Non-Repainting Design
The indicator is designed with confirmed-bar logic and non-repainting higher-timeframe requests.
Higher-timeframe context uses confirmed data and avoids lookahead behavior.
🔧 Visuals are updated with a stable object lifecycle to reduce flicker and avoid uncontrolled object creation.
---
## 📝 Release Notes — v1.0
🎉 Initial public release.
✅ Included:
* Acceptance Map Engine
* Core Value Band
* Acceptance Edges
* Minimal Auction Regime Engine
* HTF Context
* Location Awareness
* Focus / Balanced / Research modes
* Compact dashboard
* Confirmed-bar alerts
* Validation diagnostics in Research Mode
* Controlled object budget
* Non-repainting architecture
❌ Not included:
* strategy mode
* backtesting
* buy/sell signals
* automated entries or exits
* orderflow claims
* delta claims
* liquidation data
* machine learning
* multi-symbol logic
Auction Regime Atlas is a Pine Script v6 overlay indicator designed to visualize market acceptance, value migration, rejected auction areas, and contextual auction regimes directly on the chart.
❌ It is not a buy/sell signal tool.
❌ It is not a strategy.
❌ It is not an orderflow or liquidation-data replacement.
🎯 The goal is to help traders understand where price has been accepted, where value is forming, where price has moved away from value, and whether the current market context is balanced, transitional, displaced, or low quality.
---
## 💡 Core Idea
Markets often rotate around accepted value before moving into new auction areas.
Auction Regime Atlas maps that process by combining:
* price acceptance over a lookback window
* volume participation
* candle efficiency
* wick/rejection behavior
* higher-timeframe context
* regime classification
* distance from current value
📊 The result is a compact visual framework for understanding auction context without flooding the chart with signals.
---
## 🚀 Main Features
### 1. 🎯 Core Value Band
The Core Value Band highlights the price area where recent market activity shows the strongest acceptance.
It is calculated from a price-bin acceptance model using:
* time spent near price
* volume concentration
* close location
* wick/rejection behavior
⚠️ This band is meant as auction context, not as a mechanical support or resistance level.
---
### 2. 📏 Acceptance Edges
Upper and lower acceptance edges define the boundaries of the current accepted value area.
These edges help identify whether price is:
* inside accepted value
* above value
* below value
* far away from value
---
### 3. 🔄 Auction Regime
The dashboard shows a simplified auction regime state.
Current v1.0 regime states include:
* Neutral
* Balance
* Migration Up
* Migration Down
* Failed Auction
🛡️ The regime engine uses confirmed-bar logic and cooldown handling to avoid excessive state flipping.
---
### 4. 🌍 HTF Context
The indicator includes a higher-timeframe context layer based on confirmed higher-timeframe data.
ℹ️ This is used only as context and does not create entry or exit signals.
---
### 5. 📍 Location Awareness
The Location field shows where current price is relative to the accepted value area:
* Inside Value
* Above Value
* Below Value
* Away From Value
* No Value
When price is far away from the value zone, the visual relevance of the Core Band is reduced so the zone does not appear like an active trade signal.
---
### 6. 🎨 Visual Modes
Auction Regime Atlas includes three modes:
#### 🎯 Focus Mode
A clean minimal view for live chart reading.
Shows:
* Core Value Band
* Acceptance Edges
* compact dashboard
* no debug rows
#### ⚖️ Balanced Mode
Adds additional context zones while keeping the chart clean.
Shows:
* Core Value Band
* Acceptance Edges
* transitional/rejection context
* vacuum/context areas where applicable
#### 🔬 Research Mode
Adds validation and diagnostic rows for development, review, and deeper inspection.
Shows:
* object count
* validation status
* pending state information
* alert condition status
---
## 📋 Dashboard Fields
The compact dashboard includes:
* Mode
* Regime
* HTF Context
* Core Value Band
* Acceptance Score
* Location
* Activity
* Context Quality
🔬 Research Mode can additionally show:
* Validation Status
* Object Count
* State Debug
* Alert Debug
---
## 🔔 Alerts
The indicator includes four confirmed-bar alert conditions:
* New Auction Regime
* Value Migration Started
* Acceptance Edge Broken
* Failed Auction Detected
⚠️ Alerts are context alerts only.
They are not trade entry or exit instructions.
---
## 🛠️ Suggested Use
Auction Regime Atlas is best used as a context layer.
Useful questions:
* Is price currently inside accepted value?
* Is price moving away from value?
* Is the market balanced or transitioning?
* Did price leave value without building new acceptance?
* Is the current move happening near or far away from accepted value?
* Does higher-timeframe context support or contradict the current auction?
✅ Recommended starting use:
* Focus Mode for clean chart reading
* Balanced Mode for broader context
* Research Mode only for diagnostics and validation
---
## 📖 Practical Workflow
A simple way to interpret auction conditions is to combine Regime, Location Awareness, and HTF Context into a structured process.
### 1️⃣ Step 1: Start With HTF Context
First identify the higher-timeframe backdrop shown in the dashboard.
Ask:
* Is the higher timeframe supportive of directional movement?
* Is it balanced or already migrating?
* Does it align with the current chart or create conflict?
🌍 HTF Context provides the broader auction environment in which lower-timeframe activity is occurring.
### 2️⃣ Step 2: Check Current Location
Next evaluate where price is relative to accepted value.
* Inside Value suggests ongoing acceptance and rotational behavior.
* Above Value or Below Value suggests price is testing outside accepted value.
* Away From Value suggests displacement from the current auction area.
* No Value suggests acceptance has not yet formed clearly.
📍 Location helps determine whether price is interacting with value or operating away from it.
### 3️⃣ Step 3: Read the Active Regime
Then assess the current Auction Regime state.
* Balance implies acceptance and rotational trade around value.
* Migration Up or Migration Down implies value is attempting to relocate.
* Failed Auction suggests an attempted move has not established acceptance.
* Neutral indicates limited directional auction information.
🔄 The regime describes the current phase of the auction process rather than predicting the next move.
### 4️⃣ Step 4: Compare Regime and Location
The most useful information often comes from the relationship between regime and location.
Examples:
* Balance + Inside Value often reflects stable acceptance.
* Migration Up + Above Value may indicate value expansion higher.
* Migration Down + Below Value may indicate value expansion lower.
* Failed Auction + Away From Value may indicate rejection of a recent auction attempt.
📊 This comparison helps identify whether price behavior is consistent with the current auction state.
### 5️⃣ Step 5: Evaluate Market State Transitions
Watch for changes between regimes while monitoring location relative to value.
Common transitions include:
* Balance → Migration Up
* Balance → Migration Down
* Migration → Failed Auction
* Failed Auction → Balance
🔍 A transition becomes more meaningful when it is supported by location changes and aligned with HTF Context.
### 6️⃣ Step 6: Build a Contextual Narrative
Rather than treating any single field as a signal, combine all three layers:
1. Determine the higher-timeframe backdrop.
2. Identify where price is relative to value.
3. Assess the active auction regime.
4. Monitor whether the relationship between those factors is strengthening or weakening.
🧠 This workflow helps traders interpret whether the market is accepting value, rejecting value, migrating toward a new value area, or transitioning between auction states.
---
## 📈 Recommended Markets and Timeframes
The indicator is designed for liquid markets, especially:
* crypto perpetuals
* major crypto spot markets
* liquid index or futures markets
* high-volume intraday instruments
⏱️ Suggested timeframes:
* 5m
* 15m
* 1h for higher timeframe context
---
## ⚠️ Important Limitations
Auction Regime Atlas does not use true orderflow, footprint, delta, liquidation, or exchange-level positioning data.
All calculations are based on OHLCV data available in Pine Script.
❌ The indicator does not predict price direction.
❌ It does not guarantee reversals, continuations, or breakouts.
❌ It does not provide financial advice.
📌 The visual zones should be interpreted as auction context, not as automatic trade levels.
---
## 🛡️ Non-Repainting Design
The indicator is designed with confirmed-bar logic and non-repainting higher-timeframe requests.
Higher-timeframe context uses confirmed data and avoids lookahead behavior.
🔧 Visuals are updated with a stable object lifecycle to reduce flicker and avoid uncontrolled object creation.
---
## 📝 Release Notes — v1.0
🎉 Initial public release.
✅ Included:
* Acceptance Map Engine
* Core Value Band
* Acceptance Edges
* Minimal Auction Regime Engine
* HTF Context
* Location Awareness
* Focus / Balanced / Research modes
* Compact dashboard
* Confirmed-bar alerts
* Validation diagnostics in Research Mode
* Controlled object budget
* Non-repainting architecture
❌ Not included:
* strategy mode
* backtesting
* buy/sell signals
* automated entries or exits
* orderflow claims
* delta claims
* liquidation data
* machine learning
* multi-symbol logic
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.
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.
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.