Trading
Private

Retrieves a detailed log of all trigger orders (stop orders, take-profit orders, etc.) for the authenticated account. The log includes trigger order creation, activation, execution, and cancellation events.

Results can be filtered by currency and instrument name. Use pagination parameters (count and continuation) to retrieve large trigger order histories. This is useful for tracking trigger order activity and debugging trigger order behavior.

Scope: trade:read

Try in API console

get/private/get_trigger_order_history

Request

  • Base URL
    https://test.deribit.com/api/v2
  • URL
    https://test.deribit.com/api/v2/private/get_trigger_order_history
  • Auth
    none declared

Query parameters

currency'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR' required

Currency, i.e "BTC", "ETH", "USDC"

The currency symbol.

📖 Related Article: Using the currency Parameter

instrument_namestring

Unique instrument identifier

Example:BTC-PERPETUAL

Instrument name

countinteger

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

continuationstring
Example:xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT

Continuation token for pagination

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": {
    "entries": [
      {
        "timestamp": 1536569522277,
        "trigger_order_id": "SLTB-187015",
        "order_id": "ETH-100234",
        "instrument_name": "BTC-PERPETUAL",
        "request": "trigger:order",
        "last_update_timestamp": 1536569522277,
        "source": "api"
      }
    ],
    "continuation": "xY7T6cutS3t2B9YtaDkE6TS379oKnkzTvmEDUnEUP2Msa9xKWNNaT"
  }
}

Changes

No recorded changes to this operation across all 11 revisions of this API.