v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB
Collateral Trading

Query unexecuted(active) conditional orders

The endpoint returns active (unexecuted) conditional orders for the authenticated account. Conditional orders include OCO and 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>
post/api/v4/conditional-orders

Request body

marketstring

Filter by specific market. Example: BTC_USDT

If not specified, returns conditional orders for all markets.

offsetinteger

Number of records to skip for pagination.

limitinteger

Maximum number of records to return per page.

requeststring
nonceinteger

Example request

{
  "market": "BTC_USDT",
  "limit": 100,
  "request": "{{request}}",
  "nonce": 1594297865000
}

Response

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

limitinteger

Number of records per page

offsetinteger

Number of records skipped

totalinteger

Total number of records

Example response

{
  "limit": 100,
  "total": 2,
  "records": [
    {
      "id": 117703764513,
      "type": "oco",
      "stopLoss": {
        "orderId": 117703764514,
        "positionSide": "LONG"
      },
      "takeProfit": {
        "orderId": 117703764515,
        "positionSide": "LONG"
      }
    }
  ]
}