1 April 2025

  • Updated

Maintenance 9 AM UTC - The system will be down for around 15 - 30 minutes. Client systems will not be able to communicate with Deribit during this time.

Account rebalancing alert

A new email alert has been introduced to notify cross collateral accounts when the negative equity limit is breached. Users can manage these notifications in the Account Settings panel.

API

The following API updates will be included in this release:

  • The public/get_expirations endpoint now supports filtering by currency pair using the new currency_pair parameter.

  • The main account can now use the subaccount_id parameter in private/get_transaction_log to retrieve the transaction log for a specific subaccount

Historical API

Our API now allows users to retrieve historical trade and order records by utilizing the historical parameter. This feature has been added recently and is immediately available.

While recent records (30 minutes for orders and 24 hours for trades) can be accessed without this parameter, they are only stored temporarily and eventually removed. After this period, the records are only available through the historical parameter.

Retention Periods:

  • Recent orders: Available for 30 minutes before removal.

  • Recent trades: Available for 24 hours before removal.

  • Historical records: Persist indefinitely.

Supported Endpoints

The following API endpoints support historical data retrieval:

  • private/get_order_history_by_instrument

  • private/get_order_history_by_currency

  • private/get_user_trades_by_instrument

  • private/get_user_trades_by_instrument_and_time

  • private/get_user_trades_by_currency

  • private/get_user_trades_by_currency_and_time

  • private/get_user_trades_by_order

API Usage

To retrieve historical trades and orders, use the historical parameter in your API request to any of the endpoints listed above.

  • historical: false → Retrieves recent records (available immediately after execution).

  • historical: true → Retrieves historical records (available after a short delay for indexing).