Class: MarketDepth

CIQ. MarketDepth


new MarketDepth(params)

Plugin that puts a market depth plot under the chart. This type of chart shows the volumes of bids and asks .

Requires cryptoIQ plugin. See CIQ.ChartEngine#updateCurrentMarketData for data requirements

To enable this plugin in sample-template-advanced.html , search for cryptoiq and uncomment the necessary sections. This template can also be used as reference to create your own UI for this module.

Once instantiated, use the display(true/false) function to add it or remove it from the chart. See example.

If using ChartIQ webComponents, it needs to be created before the UI manager (startUI) is called for custom themes to apply.

Visual Reference:
img-marketDepth-plugin

Parameters:
Name Type Argument Default Description
params object

Configuration parameters

Properties
Name Type Argument Description
stx CIQ.ChartEngine <optional>

The chart object

parameters.volume boolean <optional>

Set to true to include volume bars on the chart

parameters.mountain boolean <optional>

Set to true to allow shading of the chart

parameters.tension number <optional>
null

Splining tension for smooth curves around data points (range 0-1). Must include splines.js for this to be effective.

params.height string <optional>
150px

Height of market depth panel

params.yAxis object <optional>

optional yAxis parameters

params.precedingContainer object <optional>

Set to the htmlElement after which to insert the market depth chart. Defaults to last chart container's parent.

parameters.orderbook object <optional>

Set to the htmlElement which is the orderbook container, to make the orderbook appear within the marketdepth area. For example, $$$("cq-orderbook") To use the default orderbook in orderbook.html, set this parameter to true.

parameters.record boolean <optional>

Set to true to record the marketDepth data. Updating currentMarketData will then also update masterData. This is useful when rendering historical market depth. Note this may be memory-intensive. The marketDepth plugin's "recording" property will be set to this value. This can be turned on or off on the fly by calling stxx.marketDepth.setRecorder(true|false)

Since:
  • 6.2.0 added record parameter
Example
// instantiate a Market Depth plot with default params
	new CIQ.MarketDepth({stx:stxx});

 // display the marketDepth
	stxx.marketDepth.display(true);

 // hide the marketDepth
	stxx.marketDepth.display(false);