SubscribeLevel2
Last updated
Last updated
Category: User Permissions: Operator, Trading, Level2MarketData Call Type: Synchronous
Retrieves the latest Level 2 Ticker information and then subscribes the user to Level 2 market data event updates for one specific instrument. Level 2 allows the user to specify the level of market depth information on either side of the bid and ask. The SubscribeLevel2 call responds with the Level 2 response shown below. The OMS then periodically sends Level2UpdateEvent information in the same format as this response until you send the UnsubscribeLevel2 call.
Only a user with Operator permission can issue a Level2MarketData permission using the call AddUserMarketDataPermission.
Note: Depth in this call is "depth of market," the number of buyers and sellers at greater or lesser prices in the order book for the instrument.
or
Key | Value |
---|---|
The response is an array of elements for one specific instrument, the number of elements corresponding to the market depth specified in the Request. It is sent as an uncommented, comma-delimited list of numbers. The example is commented.
Key | Value |
---|---|
OMSId
integer. The ID of the Order Management System on which the instrument trades.
InstrumentId
integer. The ID of the instrument you’re tracking. Conditionally optional.
Symbol
string. The symbol of the instrument you’re tracking. Conditionally optional.
Depth
integer. The depth of the order book. The example request returns 10 price levels on each side of the market.
MDUpdateID
integer. Market Data Update ID. This sequential ID identifies the order in which the update was created.
Number of Accounts
integer. Number of accounts
ActionDateTime
long integer.. ActionDateTime identifies the time and date that the snapshot was taken or the event occurred, in POSIX format X 1000 (milliseconds since 1 January 1970).
ActionType
integer. L2 information provides price data. This value shows whether this data is: 0 new 1 update 2 deletion
LastTradePrice
real. The price at which the instrument was last traded.
Number of Orders
integer. Number of orders
Price
real. Bid or Ask price for the Quantity (see Quantity below).
ProductPairCode
integer. ProductPairCode is the same value and used for the same purpose as InstrumentID. The two are completely equivalent. InstrumentId 47 = ProductPairCode 47.
Quantity
real. Quantity available at a given Bid or Ask price (see Price above).
Side
integer. One of: 0 Buy 1 Sell 2 Short (reserved for future use) 3 Unknown (error condition)