DEderibit
Market Data
Public

Changed on

Retrieves the latest trades that have occurred for a specific instrument. Returns trade details including price, amount, direction, timestamp, and trade ID.

Results can be filtered by sequence number range or timestamp range. Use the count parameter to limit the number of trades returned, and sorting to control the order (ascending or descending by trade ID).

Note: For spot instruments routed to Coinbase Exchange, this call is not supported. Use Get product trades directly for full trade history.

📖 Related Article: Spot Trading: Deribit and Coinbase-Routed Instruments

Try in API console

get/public/get_last_trades_by_instrument

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/public/get_last_trades_by_instrument
  • Auth
    none declared

Query parameters

instrument_namestring required

Unique instrument identifier

Example:BTC-PERPETUAL

Instrument name

start_seqinteger

Inclusive sequence number of the first trade to return; cannot be combined with start_timestamp.

end_seqinteger

Inclusive sequence number of the last trade to return; cannot be combined with end_timestamp.

start_timestampinteger

The timestamp (milliseconds since the Unix epoch)

Example:1536569522277

Inclusive earliest timestamp (milliseconds since the Unix epoch); cannot be combined with a start_id or start_seq bound.

end_timestampinteger

The timestamp (milliseconds since the Unix epoch)

Example:1536569522277

Inclusive latest timestamp (milliseconds since the Unix epoch).

countinteger

Number of requested items, default - 10, maximum - 1000

sorting'asc' | 'desc' | 'default'

Result ordering: asc, desc, or the method-specific default.

Response

Success response

jsonrpc'2.0' required

The JSON-RPC version (2.0)

idinteger

The id that was sent in the request

Example response

{
  "result": {
    "trades": [
      {
        "instrument_name": "BTC-PERPETUAL",
        "timestamp": 1517329113791,
        "starbase_timestamp": 1536569522277000000,
        "block_trade_id": "154",
        "block_trade_leg_count": 3
      }
    ]
  }
}

Changes

  • 82518876f388Revision changes
    • breaking

      the response property /// became nullable for the status

    • info

      added the optional property /// to the response with the status