Accessing historical trades and orders using API

Overview

Deribit API allows users to retrieve historical trade and order records by utilising the historical parameter. 

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 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).

Example Request: 

{
  "method": "private/get_user_trades_by_currency",
  "params": {
    "currency": "ETH",
    "historical": true
  },
  "jsonrpc": "2.0",
  "id": 2
}

Example Response: 

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "trades": [
      {
        "timestamp": 1741270338502,
        "state": "open",
        "price": 1355.9,
        "direction": "sell",
        "index_price": 2246.9768,
        "instrument_name": "ETH_USDC",
        "trade_seq": 18009,
        "api": false,
        "amount": 0.2505,
        "mark_price": 2246.9768,
        "order_id": "ETH_USDC-109841952",
        "matching_id": null,
        "tick_direction": 3,
        "fee": 0,
        "profit_loss": null,
        "mmp": false,
        "post_only": false,
        "self_trade": false,
        "contracts": 2505,
        "original_order_type": "market",
        "trade_id": "ETH_USDC-18820350",
        "fee_currency": "USDC",
        "order_type": "limit",
        "risk_reducing": false,
        "liquidity": "M"
      },
      {
        "timestamp": 1741270338460,
        "state": "open",
        "price": 1355.9,
        "direction": "sell",
        "index_price": 2246.9768,
        "instrument_name": "ETH_USDC",
        "trade_seq": 18006,
        "api": false,
        "amount": 0.2505,
        "mark_price": 2246.9768,
        "order_id": "ETH_USDC-109841952",
        "matching_id": null,
        "tick_direction": 3,
        "fee": 0,
        "profit_loss": null,
        "mmp": false,
        "post_only": false,
        "self_trade": false,
        "contracts": 2505,
        "original_order_type": "market",
        "trade_id": "ETH_USDC-18820345",
        "fee_currency": "USDC",
        "order_type": "limit",
        "risk_reducing": false,
        "liquidity": "M"
      }
    ],
    "has_more": true
  }
}