---
title: "GET Orders"
method: GET
path: "/v1/orders"
tags: ["Trading"]
---

# GET Orders

`GET /v1/orders`

Retrieve a list of orders with optional filtering and pagination.

## Query parameters

- `clientReference` string
- `orderStatus` OrderStatus[] — Comma-delimited list of order statuses. Returns orders matching any of the provided statuses.
- `placedAtStart` string, date-time
- `placedAtEnd` string, date-time
- `completedAtStart` string, date-time
- `completedAtEnd` string, date-time
- `accountId` string, uuid
- `pair` string
- `side` string
- `after` string
- `limit` string, integer
- `sortField` 'orderStatus' | 'placedAt' | 'completedAt'
- `sortDirection` 'ASC' | 'DESC'

## Response `200`

Successful response

- object
  - `after` string, nullable — The token of the last item in the response
  - `totalCount` string, integer — The total number of items in the entire filtered data set
  - `items` Order[]
    - `orderId` string, uuid
    - `accountId` string, uuid
    - `orderStatus` 'PLACED' | 'FILLED' | 'FAILED' | 'CANCELED' | 'PENDING_NEW' | 'NEW' | 'PARTIALLY_FILLED' | 'REJECTED' | 'PENDING_CANCEL' | 'CANCEL_FAILED' | 'EXPIRED'
    - `side` string
    - `pair` string
    - `strategy` 'RFQ'
    - `limitPrice` string, number, nullable
    - `orderPrice` string, number
    - `leavesQty` string, number — Remaining quantity to be filled
    - `orderQuantity` string, number
    - `fillQuantity` string, number
    - `cumulativeQty` string, number — Only exists for MARKET/LIMIT orders
    - `fillPrice` string, number
    - `avgPrice` string, number, nullable — Only exists for MARKET/LIMIT orders
    - `orderType` 'MARKET' | 'LIMIT' | 'PREVIOUSLY_QUOTED'
    - `timeInForce` 'GTC' | 'GTD' | 'DAY' — Time in force should be DAY for market orders
    - `expireTime` string, date-time, nullable — Only exists for LIMIT orders
    - `clientOrderId` string, uuid, nullable
    - `fillPercentage` string, number
    - `clientFeeRate` string, integer, nullable
    - `clientFeeAmount` string, number, nullable — Fixed fiat fee amount in tenant native currency
    - `providerFeeRate` string, integer
    - `placedAt` string, date-time
    - `completedAt` string, date-time, nullable
    - `clientReference` string, nullable
    - `rejectedAt` string, date-time, nullable — Only exists for REJECTED orders
    - `orderRejectReason` string, nullable — Only exists for REJECTED orders
    - `currency` string

## Other responses

- `400` — Validation Error
- `401` — Unauthorized
- `403` — Insufficient Privileges
- `4XX` — Client error
- `5XX` — Server error

---

[API](https://skmtc.net/aquanow/apis/aquanow-cams-rest-api.md) · [All operations](https://skmtc.net/aquanow/apis/aquanow-cams-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aquanow/aquanow-cams-rest-api/revisions/c62a02b27407/schema)