Skip to main content

​
Release 24.02.2026

  • Execution Reports (8): added nonmandatory tag CashOrderQty (152) to differentiate value based orders from quantity based orders. For value based orders (BTC & ETH inverse futures and perpetuals where the order size is specified as a USD amount), both OrderQty(38) and CashOrderQty(152) are present and equal. For quantity based orders, CashOrderQty is absent

​
Release 07.10.2025

  • Removed deprecated RFQ messages as previously announced.
    • Removed Quote Request (R)
    • Removed Quote Request Reject (AG)
    • Removed Quote Status Report (AI)
    • Removed RFQ Request (AH)

​
Release 10.06.2025

  • MaxShow(210) is replaced with DisplayQty(1138). The iceberg orders cannot be fully invisible anymore. Setting the DisplayQty (1138) = 0 is interpreted as no hidden volume, i.e. the full order quantity is displayed to the market. Omitting the field gives the same result.
  • Execution Reports (8): added nonmandatory tag RefreshQty (1088)

​
Release 06.03.2025

  • Support for non-printable ASCII characters (such as control characters ranging from 0x00 to 0x1F) in string values has been removed to ensure compliance with the WS/REST API. Attempting to use non-printable ASCII characters will now result in a decoding error.

​
Release 04.02.2025

  • Order Cancel/Replace Request (G): removed support of undocumented tag MaxShow (210) in compliance with WS/REST API

​
Release 08.08.24

  • Order Mass Cancel Request (q): added FreezeQuotes (9031) tag

​
Release 03.07.24

  • Mass Quote Acknowledgement (b): added more values of QuoteEntryStatus (1167)
  • MMProtection Limits (MM): added ProtectionVegaLimit (20118)

​
Release 04.06.24

  • New Order Single (D): added nonmandatory tag ValidUntilTime (62)
  • Order Cancel/Replace Request (G): added nonmandatory tag ValidUntilTime (62)
  • Mass Quote (i): added nonmandatory tag ValidUntilTime (62)
  • Execution Reports (8): added nonmandatory tags IsLiquidation (9034), IsRebalance (9035), IsRiskReducing (9036)
  • SecurityListRequest (x): added Currency, SecurityType, SecondaryCurrency

​
Release 09.03.24

  • SecurityStatusRequest (e): added subscription
  • SecurityStatus (f): added Text field
  • Changed scope for MMProtection Limits (MM) from account to trade

​
Release 13.02.24

  • Added Mass Quote (i)
  • Added Mass Quote Acknowledgement (b)
  • Execution Reports (8): added nonmandatory tags MMPGroup (9019), QuoteSetID (302), QuoteID (117), QuoteEntryID (299) related to Mass Quoting
  • Added Quote Cancel (Z)
  • Mass Cancel Report (r): added one more type for MassCancelRequestType, added optional field QuoteCancelType for mass cancel reports generated by Quote Cancel (Z), ClOrdID is not required tag anymore
  • MMProtection Reset (MZ), MMProtection Limits (MM) — added optional MMPGroup.

​
Release 12.12.23

  • Fixed an issue where Reject (3) was incorrectly returned instead of OrderCancelReject (9), with the specified ClOrdID, DeribitLabel, or OrigClOrdId, in response to an Order Cancel Request (F).

​
Release 1.3.21

  • User Request(BE): added CROSS as currency

​
Release 1.3.20

  • DeribitLiquidation is hidden from the public for the first hour after the trade (to prevent abusing).

​
Release 1.3.19

  • changed MMProtectionLimits and MMProtectionReset to work with currency pair instead of a single currency.

​
Release 1.3.18

  • added the following messages: TradeCaptureReportRequest (AD), TradeCaptureReportRequestAck (AQ), and TradeCaptureReport (AE). Clients can now utilize these to subscribe for receiving reports on their own trades.

​
Release 1.3.17

  • added fields NoTickRules(1205), StartTickPriceRange(1206), TickIncrement(1208) to the instrument for tick size steps
  • added option DisplayIncrementSteps(9018) to Logon and Security List Request(x) so the client can enable receiving the above mentioned new fields in the instrument

​
Release 1.3.16

  • added possibility to search closed orders by ClOrdID or DeribitLabel via OrderMassStatusRequest

​
Release 1.3.16

  • incremental refresh for indices now has 1 entry instead of 2
  • BTC-DVOL, ETH-DVOL are renamed in compliance with other indices: BTCDVOL_USDC-DERIBIT-INDEX, ETHDVOL_USDC-DERIBIT-INDEX

​
Release 1.3.15

  • SecurityList (y): added new value FXSPOT of SecurityType for currency exchange spot market.
  • SecurityList (y): added PriceQuoteCurrency (1524)

​
Release 1.3.14

  • Documentation alignment

​
Release 1.3.13

Added combo API:
  • added Security Definition Request (c)
  • added Security Definition (d)
Added RFQ API:
  • added Quote Request (R)
  • added Quote Request Reject (AG)
  • added Quote Status Report (AI)
  • added RFQ Request (AH)

​
Release 1.3.12

  • MarketData Request (V) added DeribitShowBlockTradeId (9012)
  • MarketData (W) and (X): added TrdMatchID(880) as blocktrade ID

​
Release 1.3.11

  • MarketData Request (V): added DeribitSkipBlockTrades (9011)

​
Release 1.3.10

  • added possibility to use client’s ClOrdID and DeribitLabel in Order Cancel Request(F), Order Mass Cancel Request(q) and Order Cancel/Replace Request(G) without exchange generated OrigClOrdID (equivalent of REST/WS cancel_by_label etc)

​
Release 1.3.09

  • Added Sequence Reset(4)
  • Security List Request(x) added SubscriptionRequestType(263) - possibilty to get notifications about new or terminated instruments
  • SecurityList (y): added SecurityStatus(965) in the notifications

​
Release 1.3.08

  • Logon(A): Added custom tag ConnectionOnlyExecutionReports(9010)

​
Release 1.3.07

  • Order Cancel/Replace Request (G): adjusted behavior for MMP orders when DeribitMMProtection (9008) flag is not specified

​
Release 1.3.06

  • SecurityList (y): added Deribit Volatility Index instruments: BTC-VIX, ETH-VIX
  • MarketData Request (V): added requests for Deribit Volatility Index

​
Release 1.3.05

  • Added MMProtection Limits (MM)
  • Added MMProtection Limits Result/Reject (MR)
  • Added MMProtection Reset (MZ)
  • New Order Single (D): added nonmandatory DeribitMMProtection (9008)
  • Order Cancel/Replace Request (G): added nonmandatory DeribitMMProtection (9008)
  • Execution Reports (8): added nonmandatory DeribitMMProtection (9008)

​
Release 1.3.04

  • Logon(A): Added custom tag DeribitSequential(9007)
  • Execution Reports (8): added SecondaryExecID which is ID of the last change of the order

​
Release 1.3.03

  • Added SecurityStatusRequest(e) request and SecurityStatus(f) response

​
Release 1.3.02

  • Execution Reports (8): added FillsGrp for non-immediate fills also (before it was only for immediate fills)
  • Position Report (AP): added missing PosType (703) added into PositionQty block
  • Execution Reports (8): added LastQty (32) and LastPx (31)

​
Release 1.3.01

  • MarketData Request (V): added support for multiple Symbols (NoRelatedSym and followed group of Symbols)
  • MarketData (W) and (X): added custom field DeribitLiquidation (100091)

​
Release 1.3.00

  • MarketData (W) and (X): added OpenInterest (746)
  • MarketData (W) and (X): added MarkPrice (100090)
  • MarketData (W) and (X): added UnderlyingSymbol(311)
  • MarketData (W) and (X): added UnderlyingPx(810)
  • MarketData (W) and (X): added ContractMultiplier(231)
  • Position Report (AP): added ContractMultiplier(231)
  • Position Report (AP): added UnderlyingEndPrice(883)
  • SecurityList (y): PutOrCall changed for compliance - put = 0, call = 1
  • SecurityList (y): added InstrumentPricePrecision(2576)
  • SecurityList (y): added MinPriceIncrement(969)
  • SecurityList (y): added UnderlyingSymbol(311)
  • SecurityList (y): added MinTradeVol(562)
  • User Request(BE): added parameter Currency(15), default is BTC
  • Order Mass Cancel Request(q): added parameter Currency(15)
  • added notification for StopLimit and StopMarket Orders. StopMarket orders has OrdType=S
  • Execution Report (8): added ContractMultiplier(231)
  • Execution Report (8): added ConditionTriggerMethod(5127)