> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upsidemax.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# ordersByCloids: Fetch Orders by Client-Assigned Order ID

> Fetch orders by your client-assigned order IDs for easy reconciliation and status tracking without needing to store exchange-assigned order IDs.

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`](/info/user-orders).

## Request

```json theme={"system"}
{
  "type": "ordersByCloids",
  "accountId": "1002",
  "marketDeployerId": 1,
  "cloids": ["1778844423064", "1778844423078"]
}
```

<ParamField body="type" type="string" required>
  Must be `"ordersByCloids"`.
</ParamField>

<ParamField body="accountId" type="string" required>
  Your account ID. Client order IDs are scoped to an account, so this field is required to avoid collisions across accounts.
</ParamField>

<ParamField body="marketDeployerId" type="integer" required>
  The market deployer the orders belong to.
</ParamField>

<ParamField body="cloids" type="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.
</ParamField>

## Response

```json theme={"system"}
{
  "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`](/info/user-orders#order-fields). Client order IDs that do not match any known order are silently omitted from the response.