Sneak preview

Take a look at our next release and other upcoming features and improvements. For the latest API updates, see Release notes.

What's in the next release?

The next release is version 2.8.0. We expect this to include the following:

New

Timestamps in order book snapshots

• For the Get order book request, we will add a timestamp of when the snapshot was generated.
• For the WebSocket Book subscription channel, we will add a timestamp of the last transaction event in the message.

Response parameters for Get markets

• The responses to the GET /markets REST and WebSocket requests will now include the following parameters:
  • quantityDecimals (integer)
  • notionalDecimals (integer)
  • tickSize (string)
  • maxOpenOrders (integer)
  • feeCategory (string)

Extended responses for market data requests

• We will add an optional query parameter extendedResponse to let you select the format of the response. If set to true, it will return additional parameters in the response. The default value will be false and will return the current response format.

  The following requests will return additional parameters:

  • Get trades will include: transactTimestamp, assetCode, assetName, price, missingPrice, priceNotaton, priceCurrency, quantity, quantityCurrency, quantityNotation, venue, publicationTimestamp, publicationVenue, and tradeId.
  • Get order book will include: submissionTimestamp, assetCode, assetName, bids and asks arrays (that include side, price, quantity, and numOrders), priceCurrency, priceNotation, quantityCurrency, quantityNotation, venue, tradingSystem, and publicationTimestamp.

Changed

Market statuses

• We will update the market status logic and add two more statuses in the lifecycle of orders:
  • trading: open for trading.
  • halted: closed for trading. You cannot create, update, or cancel orders.
  • auction: in transition from closed to open. You cannot create market orders. You can create other order types, but there is still no matching.
  • auctionMatching : the opening price is calculated. Orders created during the auction phase that meet the final opening price are matched and executed.
  • cancelOnly: you can only cancel orders and cannot create or update orders.

Operator ID response parameter

If specified, the operatorId parameter will now be returned in the responses to the following requests:

• REST API: Create order, Update order, Cancel order, and Cancel orders
• WebSocket API: Create order, Update order, Cancel order, and Cancel orders

What you need to do

• Prepare to handle the change to the market status logic with the two new statuses.
• Use operatorId as a request parameter in all order lifecycle requests.
• Update any logic that uses GET /orderbook or WebSocket getBook messages to support the new timestamp field.
• Prepare to handle additional fields in the GET /markets responses.