ordersByCloids: Fetch Orders by Client-Assigned Order ID

The ordersByCloids query lets you look up orders using the client-assigned order IDs you set at placement time (the c field in a place order action). This is useful for reconciliation flows where you want to track order status using your own identifiers without needing to store or map exchange-assigned order IDs. The response orders[] array uses the same fields as userOrders.

Request

{
  "type": "ordersByCloids",
  "accountId": "1002",
  "marketDeployerId": 1,
  "cloids": ["1778844423064", "1778844423078"]
}

string

required

Must be "ordersByCloids".

string

required

Your account ID. Client order IDs are scoped to an account, so this field is required to avoid collisions across accounts.

integer

required

The market deployer the orders belong to.

string[]

required

Array of client order IDs to look up, each expressed as an int64 decimal string. These must match the c values you supplied when the orders were placed.

Response

{
  "type": "ordersByCloids",
  "accountId": "1002",
  "marketDeployerId": 1,
  "orders": [
    {
      "id": "8280",
      "clientOrderId": "1778844423064",
      "accountId": "1002",
      "contractId": 1,
      "marginMode": "C",
      "positionSide": "OneWay",
      "orderSide": "B",
      "orderType": "L",
      "timeInForce": "Gtc",
      "price": "50",
      "size": "10",
      "leverage": "10",
      "status": "Open",
      "reduceOnly": false
    }
  ]
}

The orders array contains the same fields described in userOrders. Client order IDs that do not match any known order are silently omitted from the response.

Overview

Market Data

Account

Orders

ordersByCloids: Fetch Orders by Client-Assigned Order ID

Request

Response

​Request

​Response

Request

Response