Install and load
Close ATAS, run .\ATAS\Install.ps1, start ATAS and add Cival Liquidity Map to a candle chart with a few hundred bars. The panel title reads Cival Liquidity Map and line 2 reads Confirmed pivots: 3-bar delay.
Cival Liquidity Map
Confirmed swing structure from candles: equal highs/lows, sweeps, displacement breaks and structural blocks, with how each one ends.
What this guide covers
The ATAS plugin is compiled; the ports included for other platforms are source software supplied for the purchaser's own use. The indicator applies fixed rules to open, high, low and close: it does not read the order book, cannot identify stop orders or resting liquidity, and its sweeps, breaks and blocks are descriptions of past price, not predictions. Its signals and zones are not trading advice, and nothing here is certified for automated execution; the indicator never places orders.
Despite the name it does not see liquidity, resting orders or stop orders; sweeps and blocks are candle patterns, and the demo sample shows how common they are (110 sweeps in 4.8 days, 46 of 51 blocks closed through). Treat zones as reference prices, never as support or resistance that will hold.
Before you start
- ATAS Platform 8.0.15 or newer (uses the .NET 10 runtime that ATAS ships)
- Windows PC with write access to %APPDATA%\ATAS\Indicators
- Ordinary price candles; footprint data is not needed and the order book is not read
- An instrument whose tick size ATAS reports and a few hundred bars of history
Purchase and download
- Sign in to the account used at checkout. Open Account and locate the confirmed order. If payment is processing, wait for fulfillment rather than buying again.
- Generate a fresh product Download link. Save the ZIP, receipt, release version and checksum. Expired links can be regenerated from the account.
Windows: Get-FileHash .\your-download.zip -Algorithm SHA256. Linux: sha256sum your-download.zip. macOS: shasum -a 256 your-download.zip.
Install Cival Liquidity Map
- Close ATAS completely, then extract Cival-Liquidity-Map-v1.0.0.zip to a normal folder.
- Open PowerShell in the extracted folder and run .\ATAS\Install.ps1 (it copies the DLL, backs up a same-named DLL and verifies the SHA-256).
- Start ATAS, open a candle chart with some history, open the indicator catalog and add Cival Liquidity Map.
- Untick Compact panel (title + two lines) to read the legend lines, and lower Maximum visible zones if the chart is crowded.
PowerShell, from the extracted release folder
Get-FileHash .\ATAS\Cival.LiquidityMap.dll -Algorithm SHA256
Select-String 'Cival.LiquidityMap.dll' .\SHA256SUMS.txt
.\ATAS\Install.ps1
powershell -ExecutionPolicy Bypass -File .\ATAS\Install.ps1How the indicator works
It confirms swing highs and lows 3 bars after they print, draws an equal-high or equal-low line when a new swing lands within your tick tolerance of the previous one, and marks bars that trade beyond the latest swing and close back (a sweep). A close through a swing with a body of at least 1.5 times the prior 20-bar ATR becomes a displacement break, and the last opposite-coloured candle before it becomes a structural block. A block ends only when a bar closes through it, and is then redrawn as a broken block with the opposite side.
Exact shipped defaults
These defaults are a starting point for comparison, not recommended trading parameters or a loss limit. Candle counts depend on the interval. Refer to the shipped source for validation rules before changing them.
| Setting | Default | Meaning |
|---|---|---|
| Pivot confirmation bars | 3 | A swing high or low must beat the bars on both sides; it is confirmed this many bars after it prints, and objects start on the next bar. |
| Equal high/low tolerance (ticks) | 2 | How close, in ticks, a new swing must be to the previous one to draw an EQH or EQL line (0 means exactly equal). |
| Displacement / prior ATR | 1.5 | A close through a swing counts as a structure break only if the bar's body is at least this multiple of the prior 20-bar average true range. |
| Maximum visible zones | 12 | Draws only the nearest this-many active zones, ranked by distance, strength and age. |
| Show touched levels | false | Also draws zones that have ended (closed through), in grey, up to the bar where they ended. |
| Show labels | true | Draws zone and arrow labels; labels that would overlap are hidden, never moved. |
| Minimum bar spacing for signal labels (pixels) | 6 | Arrow labels are hidden when bars are narrower than this on screen; the arrows stay. |
| Compact panel (title + two lines) | true | Shows only the first three panel lines; untick to see the legend lines. |
| Full analysis detail | true | Keeps the full chart with spelled-out labels; switching it off (with Compact display on) gives a short style. |
| Alerts on closed signal / level touch | false | Plays the alert sound when a sweep or structure-break arrow closes or a zone is first touched. |
Step-by-step practice tutorial
Work in ATAS replay or on a demo account. The exercise teaches installation and signal interpretation; the indicator never sends an order.
Show the legend
Untick Compact panel (title + two lines). Six lines appear, including the Active zones count and the legend for EQH/EQL, the structural block and broken block, and the sweep (stops not identified).
Find the swings
Swing highs and lows are confirmed 3 bars after they print; nothing is drawn on the swing bar itself. Equal-high and equal-low lines start on the bar after confirmation and run right until a bar closes through them.
Read sweeps and breaks
A ▼ or ▲ sweep arrow is a bar that traded beyond the latest swing and closed back. A structure-break arrow is a close through the swing with a large body. Notice how often sweeps appear before you give any one weight.
Follow a block
After a structure break a shaded block marks the last opposite-coloured candle. Its label ends with New or Tested. It ends only when a bar closes through its far side, and the range then reappears as a broken block with the opposite colour.
Control the clutter
Lower Maximum visible zones to 6 to 12, raise Pivot confirmation bars or Displacement / prior ATR for fewer objects, and turn on Show touched levels only when you want to study ended zones.
Export for review
Set CSV export folder to a folder used only by this chart. LiquidityMap-signals.csv and LiquidityMap-zones.csv list the arrows and every zone with its state and the bar where it was touched or closed through.
Record your acceptance checks
□ Get-FileHash of %APPDATA%\ATAS\Indicators\Cival.LiquidityMap.dll matches the Cival.LiquidityMap.dll line in SHA256SUMS.txt.
□ After restarting ATAS, Cival Liquidity Map appears in the indicator catalog.
□ On a candle chart, the panel title reads Cival Liquidity Map and line 2 reads Confirmed pivots: 3-bar delay.
□ On a chart with a few hundred bars, sweep and structure-break arrows and at least some lines or shaded zones are drawn.
□ Changing Pivot confirmation bars from 3 to 5 changes line 2 to Confirmed pivots: 5-bar delay and usually reduces the number of objects.
□ Each zone label ends with its state (New or Tested); lowering Maximum visible zones to 3 leaves only the nearest three zones.
□ A zone ends on the first bar that closes through it, not on a wick; with Show touched levels on, ended zones appear in grey.
□ With a CSV export folder set, LiquidityMap-signals.csv and LiquidityMap-zones.csv exist after the calculation finishes.
Check each zone's state (New, Tested, or ended by a close through) and whether the swing it relates to was already confirmed. Untick Compact panel to read the legend and the active zone count against Maximum visible zones.
Maintain, update and customize
- Keep the downloaded ZIP, the receipt, the release version and the SHA-256 checksum together; you need the ZIP to reinstall or roll back.
- Before updating, close ATAS, save a chart template and note your three structure settings; the new Install.ps1 backs up the previous same-named DLL.
- Copy exported CSV files you want to keep; they are rewritten when the history is recalculated. Use a separate export folder per chart and timeframe.
- When you review trades, keep dated screenshots showing the zone state and the panel so you can compare later against what the chart looked like at the time.
Troubleshooting
Cival Liquidity Map is not in the indicator list
Close ATAS fully, confirm Cival.LiquidityMap.dll is in %APPDATA%\ATAS\Indicators, start ATAS again and search for Cival. If the installer was blocked, run powershell -ExecutionPolicy Bypass -File .\ATAS\Install.ps1.
The panel shows only three lines
Compact panel (title + two lines) is on by default. Untick it in the Information panel group to see the legend lines.
Nothing is drawn
Check the loaded history, symbol and timeframe first. There may be fewer than 7 bars, no confirmed swing yet, or every zone may have been closed through; scroll to a busier part of the history or tick Show touched levels. An empty chart is not a measured zero. Do not loosen the structure settings merely to force objects to appear.
A sweep arrow appears but I cannot see its swing
The remembered swing highs and lows are not drawn; only equal pairs become lines. Look back for the latest bar, at least Pivot confirmation bars before the arrow, whose high (or low) beats the bars on both sides, and check that the arrow bar traded beyond it and closed back.
The same rectangle changed colour
A structural block (OB structural) was closed through and its range is redrawn as a broken block (BRK structural) with the opposite side. The original block ended on that close.
The settings do not match this guide
A saved chart or template carries its own values and overrides the defaults. Compare each value with the defaults and reset any you do not recognise.
Too many arrows and rectangles
The rules are frequent on short timeframes. Raise Pivot confirmation bars or Displacement / prior ATR, lower Maximum visible zones, or turn Show labels off.
Labels are missing
Show labels may be off, bars may be narrower than the minimum spacing, or a label would overlap another and is hidden. Zoom in or untick Avoid overlapping labels.
Zones disappear after a while
A bar closed through them. Ended zones are not drawn unless Show touched levels is on.
Equal-high and equal-low lines are rare
Equal tolerance is measured in ticks, so 2 ticks is a tight definition of equal on a market with a small tick relative to price. Leave it, or choose a wider tolerance on purpose; it changes what equal means, so do not change it merely to make more lines appear.
The DLL is locked during install or update
ATAS is still running. Close it, end leftover ATAS processes in the task manager and run the installer again.
Related product guides
Get installation help
Include your order reference, product/version, operating system, ATAS version, failed step and a redacted error. Never send environment files, passwords, private keys or seed phrases.