LogoLogo
  • Welcome to AMP Futures (USA) Help
  • Trading Platforms
    • Quantower
      • Shortcuts
        • Overview
      • Getting Started
        • What's new
        • Installation
        • First start
        • Add Exchanges-Symbols
          • Add New Micro Crude Oil (CME) Symbol - MCLE
        • Platform update
        • Backup & restore manager
        • Reset settings to default
        • You have found a bug. What’s next?
      • General Settings
        • Main Toolbar
        • Workspaces
        • Single Panel
        • Link panels
        • Binds
        • Group of panels
        • Templates
        • Set as Default
        • Symbols lookup
        • Table management
        • Setup Actions & Advanced filters
        • Alerts
        • General settings
      • Data-Feed Connections
        • Connection to CQG (AMP Futures)
          • Errors with CQG
      • Analytics Panels
        • Chart
          • Chart Overview
          • Chart Types
            • Tick chart
            • Time aggregation
            • Renko
            • Heiken Ashi
            • Kagi
            • Points & Figures
            • Range bars
            • Line break
            • Volume Bars
            • Reversal Bars
          • Chart Settings
          • Chart Trading
          • Chart overlays
          • Technical indicators
            • Channels
              • Donchian Channel
              • High Low Indicator
              • Round Numbers
              • Highest High
              • Lowest Low
              • Bollinger Bands
              • Bollinger Bands Flat
              • Price Channel
              • Keltner Channel
              • Moving Average Envelope
            • Moving averages
              • Exponential Moving Average
              • FYL Indicator
              • Linearly Weighted Moving Average
              • McGinley Dynamic Indicator
              • Modified Moving Average Indicator
              • Pivot Point Moving Average Indicator
              • Regression Line Indicator
              • Simple Moving Average Indicator
              • Smoothed Moving Average Indicator
              • Guppy Multiple Moving Average Indicator
              • Trend Breakout System Indicator
              • Triple Exponential Moving Average Indicator
            • Oscillators
              • Aroon Indicator
              • Moving Average Convergence/Divergence
              • Awesome Oscillator
              • Accelerator Oscillator
              • %R Larry Williams
              • Momentum
              • Rate of Change
              • Relative Strength Index (RSI) Indicator
              • Commodity Channel Index
            • Trend
              • Average Directional Movement Index (ADX) Indicator
              • Ichimoku Cloud Indicator
              • Directional Movement Index (DMI) Indicator
              • ZigZag
            • Volatility
              • Average True Range
              • Standard deviation
            • Volume
              • Delta Flow
              • Delta Rotation
              • Level2 indicator
          • Drawing Tools
          • Volume Analysis Tools | Volume Profiles | Footprint chart | VWAP
            • Cluster chart
            • Volume profiles
            • Time statistics
            • Time histogram
            • Historical Time & Sales
          • OHLC
          • Power Trades
          • VWAP | Volume Weighted Average Price
          • Anchored VWAP
        • Watchlist
        • Time & Sales
        • Price Statistic
        • DOM Surface
        • Option Analytics
        • TPO Profile Chart
      • Trading Panels
        • Multiple Order Entry
        • Order Entry
          • Algo Order Types
          • OCO (Multi-Level)
          • OCO (Post Fill)
          • Order Types
        • DOM Trader
          • How to setup DOM for Scalping
        • Market depth
        • Trading simulator
        • Market Replay
      • Portfolio Panels
        • Positions
        • Working Orders
        • Trades
        • Orders History
        • Synthetic Symbols
        • Historical Symbols
      • Information Panels
        • Account info
        • Symbol Info
        • Event Log
        • RSS
        • Reports
      • Miscellaneous
        • Symbol Mapping Manager
        • Live Support
        • Market Heat map
        • Stat matrix
        • Exchange times
        • Quote Board
        • Browser
        • Excel and RTD function
          • Changing RTD Throttle Interval in Excel
        • Quantower Telegram Bot
      • Quantower Algo
        • Introduction
        • Install for Visual Studio
        • Strategy runner
        • Simple Indicator
        • Simple strategy
        • Input Parameters
        • Built-In indicators access
        • Custom indicators access
        • Level2 data
        • Access Volume analysis data from indicators
        • Indicator with custom painting (GDI)
        • Access Chart from indicator
        • Using markers with indicators
        • Using Clouds in Indicator
        • Adding a custom indicator to Watchlist
        • Downloading history
        • Access to trading portfolio
        • Trading operations
        • Example: Simple Moving Average
        • Access to advanced aggregations
        • Access to symbol/account additional fields
      • Customization
        • Localization
      • FAQ
        • General Errors
Powered by GitBook
On this page
  • Theory
  • Practice
  • Input parameters
  • Class constructor
  • OnInit method
  • OnUpdate method
  • OnClear method

Was this helpful?

  1. Trading Platforms
  2. Quantower
  3. Quantower Algo

Level2 data

Access to aggregate and non-aggregate order book collections.

PreviousCustom indicators accessNextAccess Volume analysis data from indicators

Last updated 4 years ago

Was this helpful?

Theory

Order book (or level2) is a collection of buy and sell orders for specific instruments organized by price level. Each level has three important values - price, size and side. This collection is dynamic, in other words, it is constantly updated in real time during the day.

Many professional traders develop their strategies using order book data. Quantower API provides users an easy way to get aggregated and non-aggregated order book snapshots. To use it you just need to execute the "" method and pass the parameters you need. This method is located at the "" class. Each instrument has its own "" object.

Overloads

There are two method overloads:

public DepthOfMarketAggregatedCollections GetDepthOfMarketAggregatedCollections(GetLevel2ItemsParameters parameters = null)

This method takes the “’-object with properties:

  • ​ - enum, type of aggregation (“Price level” by default)

  • CustomTickSize - aggregation step (cannot be less than symbol tick size)

  • LevelsCount - number of levels required

  • CalculateCumulative - set ‘true’ if you need cumulative value for each price level.

public DepthOfMarketAggregatedCollections GetDepthOfMarketAggregatedCollections(GetDepthOfMarketParameters parameters)

This method takes the “”-object with properties:

  • ​ - the object described above.

  • CalculateImbalancePercent - set ‘true’ if you need ‘imbalance’ value for each price level.

These methods return a ‘’ object with two lists - ‘Asks’ and ‘Bids’. Each collection contains instances of class. There are our price levels.

Practice

In this topic we will develop a simple indicator which will draw ‘Cumulative’ values as histogram.

Input parameters

First, let’s define input parameters. We want to manage the number of levels and set custom tick size.

[InputParameter("Level count", 10, 1, 9999, 1, 0)]public int InputLevelsCount = 10;​[InputParameter("Custom tick size", 30, 0.0001, 9999, 0.0001, 4)]public double InputCustomTicksize = 0.0001;

Class constructor

Populate constructor of our class. Define name and add line series.

Name = "Level2 cumulative";​AddLineSeries("Asks cumulative", Color.DarkRed, 10, LineStyle.Histogramm);AddLineSeries("Bids cumulative", Color.DarkGreen, 10, LineStyle.Histogramm);​SeparateWindow = true;

OnInit method

Pay attention! In the ‘OnInit’ method we need to subscribe to the ‘NewLevel2’ event. This is necessary for the terminal to send a 'order book' subscription request to the vendor. The ‘Symbol_NewLevel2Handler’ method we leave empty.

protected override void OnInit(){     this.Symbol.NewLevel2 += Symbol_NewLevel2Handler;}​private void Symbol_NewLevel2Handler(Symbol symbol, Level2Quote level2, DOMQuote dom){​}

OnUpdate method

In the ‘OnUpdate’ method we skip the historical part and then get a level2 snapshot. Be sure to check that the ask/bid collections have values. Then we get the required levels and set ‘Cumulative’ values into our indicator buffers.

protected override void OnUpdate(UpdateArgs args){    if (args.Reason == UpdateReason.HistoricalBar)       return;​    var dom = this.Symbol.DepthOfMarket.GetDepthOfMarketAggregatedCollections(new GetLevel2ItemsParameters()    {        AggregateMethod = AggregateMethod.ByPriceLVL,        LevelsCount = this.InputLevelsCount,        CalculateCumulative = true,        CustomTickSize = this.InputCustomTicksize    });​    if (dom.Asks.Length > 0)       SetValue(dom.Asks.Last().Cumulative, 0);​    if (dom.Bids.Length > 0)       SetValue(-dom.Bids.Last().Cumulative, 1);}

OnClear method

In the ‘OnClear’ don’t forget to unsubscribe from the ‘NewLevel2’.

protected override void OnClear(){    this.Symbol.NewLevel2 -= Symbol_NewLevel2Handler;}
GetDepthOfMarketAggregatedCollections
DepthOfMarket
DepthOfMarket
GetLevel2ItemsParameters
AggregatedMethod
GetDepthOfMarketParameters
GetLevel2ItemsParameters
DepthOfMarketAggregatedCollections
‘Level2Item’