Tool
Liquidity Interpretor (SMC)
interpretor.liquidity
Inputs
A market structure + liquidity bundle from market.smc_structure. This tool reads its LIQUIDITY group — the pools, Equal Highs/Lows and recent sweeps — sharing the same bundle interpretor.market_structure reads.
Outputs
A boolean that is true on each bar the chosen liquidity condition holds — a fresh reclaim for the sweep modes, or the held state for the pool / equal / side_is modes.
Reads the liquidity side of a Market Structure + Liquidity bundle and turns it into a yes/no gate about stop-hunts and liquidity pools. Price often pierces a pool of stops above a high or below a low, then snaps back — a sweep or liquidity grab that traps traders and often precedes a reversal.
How it works
It reads the LIQUIDITY group of the same market.smc_structure bundle that interpretor.market_structure uses, with no extra emitter needed. The mode picks which liquidity event or state to test: swept_reclaimed and grab fire on the bar that reclaims a pierced pool, while pool_above, pool_below, eqh_present, eql_present and side_is report a held condition. For the sweep modes, required_side says which pool you care about (buyside or sellside).
Modes
Mode options
Fires on the bar a pierced liquidity pool is reclaimed — price poked beyond the level, then closed back inside.
When to use: Time an entry off a confirmed stop-hunt reversal.
Fires when a pool is pierced and reclaimed within a single bar — a sharp wick that grabs liquidity and closes back inside in one candle.
When to use: Catch fast one-bar traps (long lower/upper wicks).
A held state: true while there is an untaken buy-side liquidity pool sitting above current price (a cluster of stops over a high).
When to use: Confirm there is overhead liquidity to target with a long, or to expect a sweep from above.
A held state: true while there is an untaken sell-side liquidity pool sitting below current price (a cluster of stops under a low).
When to use: Confirm there is liquidity below to target with a short, or to expect a sweep from below.
A held state: true when a cluster of Equal Highs (EQH) is present — twin tops at nearly the same price that mark resting buy-side liquidity.
When to use: Spot an obvious draw on liquidity above before a likely sweep.
A held state: true when a cluster of Equal Lows (EQL) is present — twin bottoms at nearly the same price that mark resting sell-side liquidity.
When to use: Spot an obvious draw on liquidity below before a likely sweep.
A held state: true when the side of the most recent sweep matches required_side (buyside or sellside).
When to use: Branch logic on which side liquidity was last taken from.
Required side options
Care about a buy-side pool — stops resting above a high. A buy-side sweep takes out highs and is often a bearish cue.
When to use: Target or react to liquidity sitting above price.
Care about a sell-side pool — stops resting below a low. A sell-side sweep takes out lows and is often a bullish reversal cue.
When to use: Target or react to liquidity sitting below price.
Configuration
Which liquidity condition to test: swept_reclaimed (pool pierced then reclaimed) and grab (pierce + reclaim in one bar) fire on the reclaim bar; pool_above/pool_below (a buy/sell-side pool exists), eqh_present/eql_present (Equal-Highs/Lows cluster) and side_is (the last sweep's side) are held states.
Which pool side the sweep took out — buyside (a high pool above) or sellside (a low pool below). Only used by the swept_reclaimed, grab and side_is modes; a sell-side sweep is a bullish reversal cue.
Connects to
Examples
- Filter: only take long entries when mode is swept_reclaimed with required_side = sellside (a low pool was swept then reclaimed — a bullish trap).
- Gate a short setup on pool_above to confirm there is untaken buy-side liquidity sitting overhead to target.
Common mistakes
- Forgetting that required_side only applies to swept_reclaimed, grab and side_is — setting it in a state mode like pool_above does nothing.
- Expecting a fresh sweep signal every bar — swept_reclaimed and grab only fire on the single reclaim-close bar, not for the whole move after.