---
title: "GET /private/get_trigger_order_history"
method: GET
path: "/private/get_trigger_order_history"
tags: ["Trading", "Private"]
---

# GET /private/get_trigger_order_history

`GET /private/get_trigger_order_history`

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](https://test.deribit.com/api_console?method=%2Fprivate%2Fget_trigger_order_history)

## Query parameters

- `currency` 'BTC' | 'ETH' | 'USDC' | 'USDT' | 'EURR', required — Currency, i.e `"BTC"`, `"ETH"`, `"USDC"`
- `instrument_name` string — Unique instrument identifier
- `count` integer
- `continuation` string

## Response `200`

Success response

- PrivateGetTriggerOrderHistoryResponse
  - `jsonrpc` '2.0', required — The JSON-RPC version (2.0)
  - `id` integer — The id that was sent in the request
  - `result` object, required
    - `entries` TriggerOrderHistoryRecord[]
      - `timestamp` integer, required — The timestamp (milliseconds since the Unix epoch)
      - `trigger` 'index_price' | 'mark_price' | 'last_price', required — Trigger type (only for trigger orders). Allowed values: `"index_price"`, `"mark_price"`, `"last_price"`.
      - `trigger_price` number, required — Trigger price (Only for future trigger orders)
      - `trigger_offset` number, required — The maximum deviation from the price peak beyond which the order will be triggered (Only for trailing trigger orders)
      - `trigger_order_id` string, required — Id of the user order used for the trigger-order reference before triggering
      - `order_id` string, required — Unique order identifier
      - `order_state` string, required — Order state: `"triggered"`, `"cancelled"`, or `"rejected"` with rejection reason (e.g. `"rejected:reduce_direction"`).
      - `instrument_name` string, required — Unique instrument identifier
      - `request` string, required — Type of last request performed on the trigger order by user or system. `"cancel"` - when order was cancelled, `"trigger:order"` - when trigger order spawned market or limit order after being triggered
      - `direction` 'buy' | 'sell', required — Direction: `buy`, or `sell`
      - `price` number, required — Price in base currency
      - `amount` number, required — It represents the requested order size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin.
      - `last_update_timestamp` integer — The timestamp (milliseconds since the Unix epoch)
      - `reduce_only` boolean, required — Optional (not added for spot). '`true` for reduce-only orders only'
      - `post_only` boolean, required — `true` for post-only orders only
      - `order_type` 'limit' | 'market', required — Requested order type: `"limit` or `"market"`
      - `label` string — User defined label (presented only when previously set for order by user)
      - `is_secondary_oto` boolean — `true` if the order is an order that can be triggered by another order, otherwise not present.
      - `oco_ref` string — Unique reference that identifies a one_cancels_others (OCO) pair.
      - `source` string — Source of the order that is linked to the trigger order.
    - `continuation` string — Continuation token for pagination.

---

[API](https://skmtc.net/deribit/apis/deribit-api-2.md) · [All operations](https://skmtc.net/deribit/apis/deribit-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deribit/deribit-api-2/versions/430b3f0bc67c/schema)