Sierra Chart market depth historical graph setup: display options and the data you need to see past depth

11 min read

Set up the Sierra Chart Historical Market Depth Graph as a liquidity heatmap. Covers the data prerequisites for past depth, the color scaling options and checks for ES, NQ and CL.

Sierra Chart market depth historical graph setup: display options and the data you need to see past depth

What the Historical Market Depth Graph needs before it shows anything

To set up the Sierra Chart market depth historical graph, set Record Market Depth Data to Yes for your symbol in Global Settings >> Symbol Settings, then add the Market Depth Historical Graph study to an intraday chart from Analysis >> Studies. Past depth only appears for periods Sierra Chart recorded while connected, or for days it downloaded from Sierra Chart's servers. Most blank heatmaps come from a missing data step, not from the color settings.

This guide covers the data prerequisites first, then the study inputs, a validation routine and a troubleshooting list for ES, NQ and CL. It is not a DOM layout guide: for the price ladder itself, see the Sierra Chart DOM setup for futures. Here the focus is the graph drawn behind the price bars, which most traders call the Sierra Chart liquidity heatmap.

Get professional chartbooks for Sierra Chart

DOM, footprint, heatmap and market profile setups, installed in seconds. Our trading courses cover the method behind them.

★★★★★
“Chartbooks are superb, I save a lot of time! Thanks for these quality products.”
@traderpro95
Instant deliverySecure payment97% satisfactionLifetime access

Data prerequisites for viewing past depth

Market depth must be enabled in your data feed and service package

The heatmap is built from order book updates, not from trades. Sierra Chart's Market Depth Historical Graph documentation requires a service package that includes Advanced features, and market depth for the exchange you trade. For ES, NQ, YM, RTY and CL, that means CME Globex depth. A quick test is to open a Trade DOM on the symbol. If the bid and ask depth columns are empty while prices update, the heatmap cannot work either. Fix the feed or the subscription before you touch any chart setting.

Turn on depth recording for the symbol

Go to Global Settings >> Symbol Settings, select your symbol or symbol pattern, set Record Market Depth Data to Yes, and make sure Use Custom Symbol Settings Values is enabled. Press OK, then disconnect and reconnect to the data feed so the setting takes effect.

Depth is only available from when it was recorded or downloaded

This is the point that confuses most people. A normal price chart can backfill years of trades. Historical depth has two possible sources:

  • Recorded locally. Sierra Chart saves the depth updates it receives while it is connected and the market is open. If your platform was closed overnight, there is no depth for overnight hours on your machine.
  • Downloaded from Sierra Chart's servers. The documentation says historical depth can be downloaded with the Denali Exchange Data Feed or the Delayed Exchange Data Feed, and that the servers keep it for a maximum of 180 days. Enable it in Global Settings >> Sierra Chart Server Settings with Support Downloading Historical Market Depth Data and Maximum Historical Market Depth Days to Download. Stay connected and open a chart with the study to start the download, and follow progress in Window >> Message Log.

On another feed, assume you only have what you recorded yourself until your feed's documentation says otherwise.

Depth files are stored in the MarketDepthData subfolder of the Data Files Folder shown in Global Settings >> General Settings. They are named [symbol].[UTC date].depth, one per day, and the symbol must match the chart symbol exactly. If there are no files for your symbol, nothing is being recorded. For the trade data side, see Sierra Chart chartbook data requirements.

Tick by tick trade data for the bars on top

The heatmap colors the background. The price bars, footprint or volume drawn over it still come from trade data. For accurate overlays, set Global Settings >> Data/Trade Service Settings >> Intraday Data Storage Time Unit to 1 tick. Sierra Chart explains the trade-offs in its tick by tick data configuration guide. Changing this only affects data stored from that point on.

Sierra Chart heatmap setup: the display options that matter

The Market Depth Historical Graph is a study. Open an intraday chart (it does not work on daily charts), go to Analysis >> Studies, select Market Depth Historical Graph, press Add, then press Settings to edit its inputs. The chart loads 10 days of depth by default, set in Chart >> Chart Settings under Use Number of Days to Load >> Market Depth.

Bar period and chart type

For each chart column, the study draws the highest depth quantity seen at each price. With 5 minute bars on NQ, each column summarizes a lot of book changes and the picture looks blocky. With 1 minute bars, or a fine number of trades or seconds per bar, the resting orders show up as continuous horizontal bands. For index futures scalping, a 1 minute or 30 second chart is a practical starting point. Very fine bar periods load more depth data and can slow the chart on older machines.

Color scaling and maximum quantity

This is the setting group that decides whether the heatmap is readable.

  • Highest Quantity For Coloring sets the size shown at full intensity. A value of 0 uses the actual maximum, which works like automatic scaling: convenient, but the same color can represent different sizes on different days.
  • Value Type for Highest Quantity for Coloring makes that cap an actual contract count or a percentage of maximum depth. An actual value keeps colors consistent.
  • Lowest Quantity for Coloring hides blocks below a size, which removes background noise.
  • Determine Min and Max Levels from All Bars or Visible Bars sets the range used for scaling.

A fixed cap needs a starting value per instrument. Watch the DOM for a few minutes during regular hours and note what a large resting order looks like on that market. A size that stands out on CL will look ordinary on ES, where the book is typically much thicker at each 0.25 tick. If the whole chart is saturated, raise the cap. If almost everything is dark, lower it. Sierra Chart support's position is that no single set of numbers works for every trader, so expect to tune it.

Bid and ask colors

The study has four color ranges per side (Range 0 to Range 3 Max Bid Color and Max Ask Color). Use two clearly different hues for bid and ask depth so you can tell at a glance whether a band is below or above the market. With Use Range Minimum Colors set to No, each gradient fades toward the chart background, which keeps small quantities quiet so they do not hide the levels you care about.

Price increment per row

On ES and NQ the tick size is 0.25, on CL it is 0.01, on RTY it is 0.10 and on YM it is 1. First confirm Chart >> Chart Settings >> Symbol >> Tick Size matches the contract. To group levels, use the study's Combine Increment in Ticks input: on NQ, a value of 4 combines four ticks into whole points. Combining can make a thin book look heavy, so keep it at 1 for first setup and group only if there are too many levels to read, which is more common on CL.

Overlays

The heatmap is most useful when you can see trades against it. Candles are the simplest overlay. A footprint built with the Numbers Bars study adds bid and ask volume but can crowd the chart; the Sierra Chart footprint chart setup covers readable settings. Many traders keep the footprint on a separate chart. To skip building colors and scaling from scratch, the Sierra Chart heatmap chartbook comes with the study tuned, and the DOM with heatmap chartbook puts the order book next to the heatmap so you can compare resting orders with executions.

How to read the graph without overreading it

The heatmap shows where orders were resting and for how long. A bright horizontal band that persists on ES as price approaches it tells you size was sitting there. It does not tell you that size will stay. Orders can be pulled before price arrives, and that disappearance is part of what the graph shows. Some traders watch whether a band holds as trades print into it, gets consumed, or vanishes just before contact. Treat these as observations about the book, not as signals.

On EURUSD, keep expectations modest. Spot forex has no central order book, and Sierra Chart's forex and CFD symbols do not provide depth for this study. Exchange-traded currency futures carry CME depth, which is what the graph was designed around.

Validation routine before relying on it

Run these checks once, then after any data feed or version change:

  1. Open a Trade DOM on the symbol and confirm depth columns update.
  2. Add the study and confirm color appears on the current session.
  3. Check the MarketDepthData folder for a .depth file for that exact symbol and today's UTC date.
  4. Scroll back to a period when Sierra Chart was closed. A blank area is expected unless you downloaded depth for it.
  5. Turn on Display Market Depth Quantities After Last Bar, set Depth Quantity Type to Display After Last Bar to Last Depth, and compare that column with the DOM in real time.
  6. Use Chart >> Reload and Recalculate and confirm the past depth is still drawn.

If the chart itself is blank or studies are missing after loading a chartbook, that is a different issue. The chartbook not displaying correctly guide covers symbol mismatch and missing studies.

Troubleshooting a blank or wrong heatmap

  • The graph is blank and color changes do nothing. There is usually no depth behind the study. Check the service package, check that the chart is intraday, and check for depth files. If the Trade DOM shows no depth levels at all, the issue is depth authorization with your data provider.
  • Only some days load. Check the Market Depth days to load in Chart Settings, especially in replay. If the Message Log reports a depth memory error, set it to 1 and raise it gradually.
  • Quantities do not match the DOM. Each column shows the highest quantity at that price during the bar. Use Last Quantity Instead Of Max Quantity For Bars changes that, and Tick Size must match the contract when levels are combined.
  • Gaps inside the session. Extend Last Known Depth carries the last known quantity forward into bars with no depth updates.
  • The chart is slow. Sierra Chart suggests a chart update interval of 1000 ms or more, Show Quantity Numbers set to None or Only After Last Bar, and Maximum Levels to Display at 20 or lower.

Conclusion

A working historical depth heatmap depends on data before display. Confirm depth is in your feed and service package, turn on Record Market Depth Data, and accept that past depth only exists for periods you recorded or downloaded. Then use a fine bar period, a fixed highest quantity per instrument, distinct bid and ask colors and one tick rows, and validate against the live DOM.

FAQ

Why does my heatmap only show today?

Most likely depth was recorded only while Sierra Chart was running today, and historical depth downloading is off or not available on your feed. On the Denali or Delayed exchange feed, enable Support Downloading Historical Market Depth Data. Otherwise leave recording on and history will build up from now on.

How many days of historical depth can I download?

Sierra Chart keeps depth on its servers for a maximum of 180 days. Maximum Historical Market Depth Days to Download sets how much you fetch, and the Market Depth days to load setting, 10 by default, sets how much the chart shows.

Why did my heatmap disappear after the contract rollover?

Depth files are saved per exact symbol, so the new front month starts with its own files. Enable Record Market Depth Data for the new contract, or for a symbol pattern that covers it, and download its past depth if your feed supports it.

Does the heatmap use a lot of disk space?

Depth files grow quickly on active markets like ES and NQ because every book update is stored. Check the size of the MarketDepthData folder after a few sessions and remove old files you no longer need.

Can I use the heatmap on a chart replay?

Replay can show depth only for periods where depth data exists on your machine. If you never recorded or downloaded depth for that date, the replay shows price without the heatmap.

Should I use the same maximum quantity for ES and CL?

No. Book sizes differ a lot between instruments, so set Highest Quantity For Coloring per chart based on what significant size looks like on that market's DOM.

To skip the color and layout work, browse the ready-to-use Sierra Chart chartbooks from SierraOnShop.

Set this up in Sierra Chart in seconds

Clement

Written by

Futures trader for more than seven years, specialized in order book and order flow scalping on US index futures, now building automated strategies. Founder of SierraOnShop.

More about the author

Read the order flow with the right tools

Start with a professional Sierra Chart chartbook, or learn the method with our trading courses.

★★★★★
“Just received the footprint chartbook. Installation took 30 seconds, works perfectly on Sierra 2800.”
@orderflowpro
Instant deliverySecure payment97% satisfactionLifetime access