Breaking Changes
Potential Breaking Change 1
Using “stop” value for "type" parameter in "/private/cancel_all_by_currency" and "/private/cancel_all_by_instrument" will now result in cancellation of only Stop-Loss orders.
To cancel Take-Profit orders one of these two new possible values should be used: "take" (only Take-Profit) and "trigger_all" (both Stop-Loss and Take-Profit). "trigger_all" should be used in place of "algo_all" which was marked as deprecated and will be removed in future updates.
Potential Breaking Change 2
[APIv2][Block Trades] Removed the "initiator_user_id" and "executor_user_id" fields from the response object of /private/execute_block_trade, /private/get_block_trade and /private/get_last_block_trades_by_currency.
Other changes
KYC
As of 21 September 2021, we will add another security measure to our KYC process. New individual (non-corporate) clients will be required to complete a liveness check. This means an extra step will be added to the verification process in which a new user will have to look into the camera, so our ID verification software can check if the person is the same person as the person in the ID that has been provided. The goal is to minimise identity fraud. At the moment, existing clients do not have to complete this additional step.
Block Trade
[APIv2] Added optional "app_name" field to the block trade response object.
Daily_withdrawal_limit
-
[APIv2] Added private/get_daily_withdrawal_limit, and private/set_daily_withdrawal_limit (only for reducing the current limit) methods
-
Added UI possibility to reduce clients’ daily withdrawal limit
-
Warning: Raising the daily withdrawal limit can only be done by Deribit admins. Please request removal or increase via support@deribit.com which will require an identity confirmation. When setting this value to zero it immediately blocks all ability to withdraw [BTC / ETH] from Deribit.
IP Range whitelisting
[APIv2 & UI] Added ability to whitelist IP range (subnet) for API Key, for example, 126.23.12.x/24.
Hypothetical Portfolio margin
-
[APIv2] Added "private/get_portfolio_margins" method returning portfolio margins for provided simulated positions
-
A client might want to simulate what adding a certain position might do to their margins, or switching from standard margin to portfolio margin. This new endpoint shows that.
Get positions from main and all sub-accounts in a single request
-
[APIv2] Added private/get_subaccounts_details method
-
Affects /private/get_position and /private/get_positions
-
Add parameter all_accounts (default=FALSE) and if set to TRUE this will return the position for all subaccounts
Cancel_by_label
[APIv2] Added optional “currency” parameter for private/cancel_by_label (passing this parameter optimizes execution, but will cancel orders only in selected currency).
FIX
-
Addition of FIX equivalent of Edit/cancel by label
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)
-
Added support for FIX Sequence Reset message
-
For Security List Request(x) added SubscriptionRequestType(263) - possibility to get notifications about new or terminated instruments and for SecurityList (y) notifications: added SecurityStatus(965) field.
Edit notes notification
[APIv2] Notification after editing notes in withdrawals, deposits and transfers ("withdrawal.*", "deposit.*", "transfer.*" channels).
Incremental ticker
-
[APIv2] Added "incremental_ticker.{instrument_name}" subscription The new
-
subscription is more efficient with regards to the number of updates and data sent
-
The subscription sends a full ticker for the instrument in the initial event and later only incremental changes between consecutive tickers.
-
Incremental_ticker event will not send more than once per second
-
if nothing changes then incremental_ticker is not sent at all (normal ticker is sent at least every 5 seconds)
-
but if nothing changes for more than 1 minute we do resend full ticker
Possibility to assign labels to user subscriptions
[APIv2] Clients while subscribing to private channels of multiple accounts in the same connection can receive the assigned label in notification messages