The Market Depth Demo is a very simple market depth application based on Lightstreamer for its real-time communication needs.
This project includes a web client front-end for the demo. The server-side part of this demo, the Metadata and Data Adapters, is covered in this project: Lightstreamer - Market Depth Demo - Java Adapter.
Market depth is an electronic list of buy and sell orders, organized by price level and updated to reflect real-time market activity.
Market depth data are also known as Level II, Depth Of Market (DOM), and the order book.
Lightstreamer has semi-native support for market depth, which can be managed very easily via COMMAND mode subscriptions. Basically, the bid and ask lists for an instrument will be two items subscribed to in COMMAND mode.
You will be able to add, update, and remove rows, where each row is identified by a key, which is the price. Lightstreamer will take care of aggregating updates to market depth in the most optimized way, based on bandwidth and frequency constraints.
This way, you will be able to manage full market depths even on unreliable networks and also benefit from update resampling with conflation, if needed.
The demo is based on an adapter that simulates the generation of random orders and any contracts in case of matching. Furthermore you can add orders at your convenience through the basic input form (only limited orders are allowed).
The demo includes the following client-side functionalities:
- A Subscription containing 1 item, subscribed to in
MERGE
mode feeding a StaticGrid (showing summary data for the stock). - Two Subscriptions containing 1 item each, subscribed to in
COMMAND
mode feeding two DynaGrids (showing the bid and ask lists). - The orders are sent to the adapter through the Lightstreamer Server using the LightstreamerClient.sendMessage utility. A confirmation response is received from the Metadata Adapter.
If you want to install a version of this demo pointing to your local Lightstreamer Server, follow these steps:
- As prerequisite, the Lightstreamer - Market Depth Demo - Java Adapter has to be deployed on your local Lightstreamer Server instance. Please check out that project and follow the installation instructions provided with it.
- Download this project.
- Get the
lightstreamer.min.js
file from npm or unpkg and put it in thesrc/js
folder. - Get the
require.js
file form requirejs.org and put it in thesrc/js
folder. - Deploy this demo on the Lightstreamer Server (used as Web server) or in any external Web Server. In the former case, please create the folders
<LS_HOME>/pages/MarketDepthDemo
and copy here the contents of the/src
folder of this project. The client demo configuration assumes that Lightstreamer Server, Lightstreamer Adapters, and this client are launched on the same machine. If you need to target a different Lightstreamer server, please search injs/lsClient.js
this line:
var lsClient = new LightstreamerClient(protocolToUse+"//localhost:"+portToUse,"MARKETDEPTH");
and change it accordingly.
- Open your browser and point it to: http://localhost:8080/MarketDepthDemo/
- Compatible with Lightstreamer SDK for Web Clients version 9.0.0 or newer.
- For a version of this example compatible with Lightstreamer SDK for Web Clients version 6.2 to 8.0, please refer to this tag.