Derivatives V3

2024-04-11

REST API

• Get Instruments Info [UPDATE]
  • Add response fields minNotionalValue

2024-03-12

REST API

• Set Risk Limit [DEPRECIATE]
  • Since auto risk limit has been launched, it is meaningless to use this API

2024-03-04

REST API

• Public Trading History
  • Add new response fields for Option only. mP, iP, mIv, iv

Websocket API

• Public Trade
  • Add new stream fields for Option only. mP, iP, mIv, iv

2023-11-09

REST API

• Get Execution List [UPDATE]

  • Add the time range limitation for startTime and endTime request params

• Get Closed PnL [UPDATE]

  • Add the time range limitation for startTime and endTime request params
  • data is sort by updatedTime

2023-10-25

REST API

• My Position [UPDATE]

  • Add response field isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

• Confirm New Risk Limit [NEW]

  • Add a new endpoint

Websocket API

• Position [UPDATE]
  • Add response field isReduceOnly, mmrSysUpdatedTime, leverageSysUpdatedTime

2023-09-28

REST API

• Get Long Short Ratio [NEW]
  • Add a new endpoint to query long short ratio market data

2023-08-11

REST API

• Wallet Balance
  • availableToBorrow always returns "" because main-sub uids share borrow quota

WebSocket API

• Wallet
  • availableToBorrow always returns "" because main-sub uids share borrow quota

2023-07-31

REST API

• My Position
  • Adjust liqPrice value logic. It only has value when minPrice < liqPrice < maxPrice, otherwise it is always ""

WebSocket API

• Position
  • Adjust liqPrice value logic. It only has value when minPrice < liqPrice < maxPrice, otherwise it is always ""

2023-07-13

REST API

• Get Kline
  • Increase max limit from 200 to 1000
• Get Mark Price Kline
  • Increase max limit from 200 to 1000
• Get Index Price Kline
  • Increase max limit from 200 to 1000
• Get Premium Index Price Kline
  • Increase max limit from 200 to 1000

2023-05-23

REST API

• Place Order [UPDATE]
  • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType
• Replace Order [UPDATE]
  • Add new request params for new TP/SL tpLimitPrice, slLimitPrice
• Get Open Orders [UPDATE]
  • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
• Get Order List [UPDATE]
  • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice
• My Position [UPDATE]
  • tpSlMode in the position is depreciated
• Set Trading Stop [UPDATE]
  • Add new request params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice, tpOrderType, slOrderType

WebSocket API

• Position
  • tpSlMode in the position is depreciated
• Order [UPDATE]
  • Add new response params for new TP/SL tpslMode, tpLimitPrice, slLimitPrice

2023-05-10

REST API

• Set Risk Limit [UPDATE]
  • Adjust the error code

Old error code	New error code	Msg
10001	140071	RiskId is not modified

2023-04-20

REST API

• Account Info [UPDATE]
  • add new response fields dcpStatus, timeWindow, smpGroup
• Place Order [UPDATE]
  • add new request param smpType used to select SMP execution type
• Get Open Orders [UPDATE]
  • add new response fields smpType, smpOrderId, smpGroup
  • add new enum cancelBySmp of cancelType
• Get Order List [UPDATE]
  • add new response fields smpType, smpOrderId, smpGroup
  • add new enum cancelBySmp of cancelType

WebSocket API

• Order [UPDATE]
  • add new response fields smpType, smpOrderId, smpGroup
  • add new enum cancelBySmp of cancelType

2023-04-12

REST API

• My Position [UPDATE]
  • add response param adlRankIndicator

WebSocket API

• Position [UPDATE]
  • add response param adlRankIndicator

2023-03-08

REST API

• Risk Limit [UPDATE]
  • remove useless response field section

2023-03-03

REST API

• Ticker Info [UPDATE]
  • A new response field openInterestValue is added for Futures
• Open Interest [UPDATE]
  • cursor & nextPageCursor are added to support pagination

2023-02-28

REST API

• IP Rate Limit [UPDATE]
  • Due to the switch to CloudFront, the IP limit rules have been adjusted appropriately

2023-02-20

WebSocket API

• Execution [UPDATE]
  • Add new fields: blockTradeId, markPrice

2023-02-09

REST API

• Set Disconnect Cancel All [NEW]
  • Set DCP for Options trade
• Get DCP Info [NEW]
  • Set DCP for Options trade
• Set MMP [NEW]
  • Set MMP for Options tarde
• Reset MMP [NEW]
  • To release MMP frozen status
• Get MMP State [NEW]
  • Get MMP settings info

WebSocket API

• Order [UPDATE]
  • Add new fields: avgPrice, blockTradeId, cancelType, cumExecFee, leavesValue, positionIdx, rejectReason

2023-01-19

REST API

• Set Margin Mode
  • Portfolio margin mode supports USDT Perpetual
• Get Open Orders
  • For portfolio margin mode, orderIM returns ""
• Get Order List
  • For portfolio margin mode, orderIM returns ""
• My Position
  • For portfolio margin mode, positionIM, positionMM, leverage returns "", riskId returns 0
• Wallet Balance
  • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

WebSocket API

• Position
  • For portfolio margin mode, positionIM, positionMM, leverage returns "", riskId returns 0
• Order
  • For portfolio margin mode, orderIM returns ""
• Wallet
  • For portfolio margin mode, totalOrderIM, totalPositionIM, totoalPositionMM returns ""

2023-01-16

WebSocket API

• Orderbook
  • Add 500 level depth, push frequency is 100ms

2023-01-09

WebSocket API

• Tickers
  • nextFundingTime has been changed from dataTime 2023-01-05T08:00:00Z to timestamp (ms) 1672905600000
  • predicatedFundingRate has been removed from stream