ICT (Inner Circle Trader) concepts are institutional trading tools — techniques for reading market structure based on how large players create and fill orders. COD3X now auto-detects two of the most actionable ICT patterns: Fair Value Gaps and Change of Character.
Here's what they are, how the detection works, and how agents use them.
Fair Value Gaps (FVG)#
A Fair Value Gap is a three-candle price imbalance. It forms when aggressive buying or selling creates a gap between the high of candle 1 and the low of candle 3 (bullish FVG) or the low of candle 1 and the high of candle 3 (bearish FVG).
Bullish FVG#
Candle 1: High at $62,000
Candle 2: Strong bullish candle (gap-up move)
Candle 3: Low at $62,400
Gap zone: $62,000 – $62,400
The gap between candle 1's high and candle 3's low is the "fair value gap." Price moved so aggressively that it left unfilled orders in that zone. The thesis: price will return to fill the gap before continuing the move.
Bearish FVG#
The inverse. Candle 1's low is higher than candle 3's high after a strong bearish move. The gap zone becomes a resistance area where price is likely to reject.
Why FVGs Work#
FVGs represent zones of institutional order flow imbalance. When a large buyer sweeps through price levels, they don't fill every order at every price — they leave gaps. Market makers and other participants see these gaps as areas where liquidity wasn't provided, and price tends to revisit them to "rebalance."
It's not magic. It's the mechanics of how large orders interact with limit order books.
COD3X Detection#
COD3X auto-detects FVGs on all timeframes:
- FVG zones are marked directly on the chart as highlighted regions
- Bullish FVGs (potential support/entry zones) in one color
- Bearish FVGs (potential resistance/entry zones) in another
- Partially filled FVGs update in real-time as price returns to the zone
- Fully filled FVGs are removed from the chart
Agents can query FVG data programmatically — checking whether the current price is within an FVG zone, how far price is from the nearest unfilled FVG, and whether a gap has been partially or fully filled.
Change of Character (CHoCH)#
A CHoCH marks the moment market structure shifts. In a bullish trend (higher highs, higher lows), a CHoCH occurs when price breaks below the most recent higher low. The trend was making higher lows — and then it didn't. The "character" of the market changed.
Bullish CHoCH (Bearish → Bullish)#
In a downtrend (lower lows, lower highs), price breaks above the most recent lower high. The sellers were in control, pushing highs lower — until they weren't. This CHoCH signals potential trend reversal to the upside.
Bearish CHoCH (Bullish → Bearish)#
In an uptrend, price breaks below the most recent higher low. Buyers were maintaining higher lows — until they failed. This signals potential trend reversal to the downside.
Why CHoCH Matters#
CHoCH is one of the earliest signals that a trend is ending. By the time traditional indicators confirm a reversal (MACD crossover, moving average death cross), price has already moved significantly. CHoCH catches the structural shift as it happens, not after the fact.
The tradeoff: CHoCH signals more false positives than lagging indicators. Not every structural break leads to a full reversal — sometimes it's just a deeper pullback within a continuing trend. This is where combining CHoCH with other signals (like FVGs) improves accuracy.
COD3X Detection#
CHoCH events are auto-detected and:
- Marked on the chart at the exact candle where the break occurred
- Classified as bullish or bearish
- Available as trigger conditions for agent goals
- Queryable by the AI model during reasoning
An agent goal can be configured to fire specifically when a CHoCH event is detected: "When a bearish CHoCH forms on BTC 4h, analyze whether a short setup exists."
Combining FVG + CHoCH#
The highest-probability ICT setup combines both concepts:
Short Setup Example#
- CHoCH detected — Bullish trend breaks a higher low (bearish CHoCH on 4h BTC)
- Identify FVG above — A bearish FVG exists at $63,200–$63,600 from the previous aggressive sell-off
- Wait for price to rally into the FVG — Price recovers to $63,300 (inside the gap)
- Enter short — The thesis: trend structure has shifted (CHoCH), and price has rallied into a resistance zone (FVG) that institutional sellers are likely to defend
- Stop-loss above the FVG — $63,700 (above the gap zone)
- Take-profit at the CHoCH low — Where the structural break occurred
Long Setup Example#
- CHoCH detected — Bearish trend breaks a lower high (bullish CHoCH on 1h ETH)
- Identify FVG below — A bullish FVG exists at $3,380–$3,410
- Wait for pullback into the FVG
- Enter long at $3,395 — Inside the gap, where institutional buy orders likely sit
- Stop-loss below the FVG — $3,370
- Take-profit at the CHoCH high
Agent Goal Example#
When a bearish CHoCH forms on BTC-PERP 4h timeframe:
1. Identify the nearest unfilled bearish FVG above the current price
2. If an FVG exists within 2% of current price, set an alert
3. When price enters the FVG zone, evaluate a short entry
4. Stop-loss 0.3% above the FVG upper boundary
5. Take-profit at the CHoCH swing low
6. Max position size 5%, leverage 3x
The agent uses Chain-of-Thought to evaluate each step: Is the CHoCH clean? Is the FVG unfilled? Is there confluence with other signals (RSI, volume, funding rate)? Only enter if the full picture supports the trade.
Configurable Alerts#
FVG and CHoCH events support the full alert system:
- Browser notifications when a pattern forms
- Goal triggers that fire agent execution
- Telegram alerts (via the plugin)
- Chart annotations that persist until the pattern is filled or invalidated
Alerts are configurable per symbol and per timeframe. Monitor BTC CHoCH on 4h but not 15m. Track SOL FVGs on 1h but not 1d. You decide what's worth watching.
ICT concepts meet AI agents. Fair Value Gaps and Change of Character are now auto-detected, charted, and available as agent triggers. Institutional market structure analysis, automated.
