List Orders

The orders of the merchant's members, with filters — including a direct lookup by client_order_id.

GET/api/ordersAuth: Required

Query Parameters

client_order_idstring

Look up one order by the id you sent on creation. With this parameter the response is that single order object, not a paginated envelope, and every other parameter is ignored. If no such order exists for your account, the call answers 400 with code 1001.

member_idnumber

Filter by member_id.

marketstring

Filter by market.

sidestring

Filter by side.

statestring

Filter by state — wait, done, fail or cancel.

pagenumber

Page number. Default 1.

per_pagenumber

Items per page. Default 20, maximum 1000.

Response

A paginated envelope; orders are in items. With client_order_id — a single order object instead, see the parameter above.

itemsarrayRequired

Orders.

More attributes

GET/api/orders

curl 'https://api.example.com/api/orders' \
  -H 'Api-Token: YOUR_API_TOKEN'

EXAMPLE RESPONSE

{
  "total_count": 55,
  "per_page": 2,
  "total_pages": 28,
  "page": 1,
  "prev_page": null,
  "next_page": 2,
  "items": [
    {
      "id": 21180,
      "client_order_id": null,
      "market_id": "trxusdt",
      "side": "sell",
      "ord_type": "market",
      "volume": "0.0",
      "origin_volume": "100.0",
      "amount": null,
      "price": null,
      "avg_price": "0.2941",
      "state": "done",
      "member_id": 9665,
      "locked": "0.0",
      "origin_locked": "100.0",
      "updated_at": "2026-07-29T12:37:52.145Z",
      "created_at": "2026-07-29T12:37:50.519Z"
    },
    {
      "id": 21181,
      "client_order_id": null,
      "market_id": "trxusdt",
      "side": "sell",
      "ord_type": "market",
      "volume": "0.0",
      "origin_volume": "100.0",
      "amount": null,
      "price": null,
      "avg_price": "0.2942",
      "state": "done",
      "member_id": 9665,
      "locked": "0.0",
      "origin_locked": "100.0",
      "updated_at": "2026-07-29T13:06:20.162Z",
      "created_at": "2026-07-29T13:06:18.793Z"
    }
  ]
}