---
title: "Query unexecuted(active) conditional orders"
method: POST
path: "/api/v4/conditional-orders"
tags: ["Collateral Trading"]
---

# Query unexecuted(active) conditional orders

`POST /api/v4/conditional-orders`

The endpoint returns active (unexecuted) conditional orders for the authenticated account. Conditional orders include [OCO](/glossary#one-cancels-the-other-oco) and [OTO](/glossary#one-triggers-the-other-oto) types. The response uses polymorphic structure — each record contains a `type` field (`oco` or `oto`) that determines the record shape. Use the optional `market` parameter to filter results.

<Warning>
Rate limit: 12000 requests/10 sec.
</Warning>

<Accordion title="Error Codes">
  - `30` - default validation error code (invalid pagination — `limit` outside 1–100 or negative `offset`)
  - `31` - market validation failed (the `market` filter is unknown or not available for collateral trading)
</Accordion>

## Request body

- object
  - `market` string — Filter by specific market. Example: BTC_USDT If not specified, returns conditional orders for all markets.
  - `offset` integer — Number of records to skip for pagination.
  - `limit` integer — Maximum number of records to return per page.
  - `request` string
  - `nonce` integer

## Response `200`

Successful response - returns paginated conditional orders (OCO and OTO types)

- object
  - `limit` integer — Number of records per page
  - `offset` integer — Number of records skipped
  - `total` integer — Total number of records
  - `records` union[] — Array of conditional orders (can be OCO or OTO type)
    - union
      - object — OCO type conditional order
        - `id` integer
        - `type` 'oco'
        - `reduceOnly` boolean — Reduce-only flag
        - `stopLoss` object
          - `orderId` integer
          - `positionSide` 'LONG' | 'SHORT' | 'BOTH'
        - `takeProfit` object
          - `orderId` integer
          - `positionSide` 'LONG' | 'SHORT' | 'BOTH'
      - object — OTO type conditional order
        - `id` integer
        - `type` 'oto'
        - `reduceOnly` boolean — Reduce-only flag
        - `stopLossPrice` string
        - `takeProfitPrice` string
        - `conditionalOrder` object
          - `orderId` integer
          - `clientOrderId` string
          - `market` string
          - `positionSide` 'LONG' | 'SHORT' | 'BOTH'

## Other responses

- `400` — Inner validation failed
- `422` — Request validation failed
- `503` — Service temporarily unavailable

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/revisions/76c9def9942f/schema)