ordersByIds: Fetch Orders by Exchange-Assigned Order IDs

The ordersByIds query lets you fetch one or more specific orders using their exchange-assigned order IDs — the id values returned by userOrders or an order placement response. This is the most direct way to check order status or confirm a cancellation without retrieving your entire order list. The response orders[] array uses the same fields as userOrders.

Request

{
  "type": "ordersByIds",
  "marketDeployerId": 1,
  "orderIds": ["8280", "8281"]
}

string

required

Must be "ordersByIds".

integer

required

The market deployer the orders belong to.

string[]

required

Array of exchange-assigned order IDs to look up, each expressed as an int64 decimal string (e.g. ["8280", "8281"]). You can pass a single-element array to look up one order.

Response

{
  "type": "ordersByIds",
  "marketDeployerId": 1,
  "orders": [
    {
      "id": "8280",
      "clientOrderId": "0",
      "accountId": "5",
      "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. Orders not found for a given ID are silently omitted from the response — check that the returned array length matches your input if you need to confirm all IDs resolved.

Overview

Market Data

Account

Orders

ordersByIds: Fetch Orders by Exchange-Assigned Order IDs

Request

Response

​Request

​Response

Request

Response