Orders

GET Order

get

Retrieve an order by its order ID.

Authorizations

Path parameters

orderIdstring · uuidRequired

The settlementId of the settlement

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/orders/{orderId} HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "accountId": "123e4567-e89b-12d3-a456-426614174000",
  "orderStatus": "PLACED",
  "side": "BUY",
  "pair": "BTC-USD",
  "strategy": "RFQ",
  "orderPrice": "52100.00",
  "orderQuantity": "1.00",
  "fillQuantity": "1.00",
  "fillPrice": "52100.00",
  "fillPercentage": "100",
  "clientFeeRate": "10",
  "providerFeeRate": "10",
  "placedAt": "2025-04-26T09:37:28.316Z",
  "completedAt": null,
  "clientReference": "text"
}

GET Orders

get

Retrieve a list of orders with optional filtering and pagination.

Authorizations

Query parameters

clientReferencestringOptional

Filter orders by client provided reference parameter

orderStatusstring · enumOptional

Filter orders by order status

Possible values:

placedAtStartstring · date-timeOptional

Filter orders by when the order was placed. Lower bound, exclusive

placedAtEndstring · date-timeOptional

Filter orders by when the order was placed. Upper bound, inclusive

completedAtStartstring · date-timeOptional

Filter orders by when the order was completely filled. Lower bound, exclusive

completedAtEndstring · date-timeOptional

Filter orders by when the order was completely filled. Upper bound, inclusive

accountIdstring · uuidOptional

Filter orders by account ID

afterstringOptional

When provided, specifies the last item returned in previous page, used to fetch the next page. Fetches the first page when omitted.

limitstring · integerOptional

When provided, specifies the number of items to return in the page. Uses default page size of 10 when omitted.

sortFieldstring · enumOptional

Will sort the returned data using the specified field.

Possible values:

sortDirectionstring · enumOptional

Specifies the sort direction for the sortField.

Possible values:

Responses

get

HTTPcURLJavaScriptPython

GET /api/v1/orders HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "after": "text",
  "totalCount": "1",
  "items": [
    {
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "orderStatus": "PLACED",
      "side": "BUY",
      "pair": "BTC-USD",
      "strategy": "RFQ",
      "orderPrice": "52100.00",
      "orderQuantity": "1.00",
      "fillQuantity": "1.00",
      "fillPrice": "52100.00",
      "fillPercentage": "100",
      "clientFeeRate": "10",
      "providerFeeRate": "10",
      "placedAt": "2025-04-26T09:37:28.316Z",
      "completedAt": null,
      "clientReference": "text"
    }
  ]
}

Request an Order (WIP)

post

Create an order. You can place three types of orders: limit, rfq and market. Orders can only be placed if your account has sufficient funds. Once an order is placed, your account funds will be put on hold for the duration of the order. How much and which funds are put on hold depends on the order type and parameters specified.

Authorizations

Body

one ofOptional

or

or

Responses

post

HTTPcURLJavaScriptPython

POST /api/v1/orders HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "quoteId": "123e4567-e89b-12d3-a456-426614174000",
  "orderType": "PREVIOUSLY_QUOTED",
  "clientReference": "text"
}

{
  "order": {
    "orderId": "123e4567-e89b-12d3-a456-426614174000",
    "accountId": "123e4567-e89b-12d3-a456-426614174000",
    "orderStatus": "PLACED",
    "side": "BUY",
    "pair": "BTC-USD",
    "strategy": "RFQ",
    "orderPrice": "52100.00",
    "orderQuantity": "1.00",
    "fillQuantity": "1.00",
    "cumulativeQty": "1.00",
    "fillPrice": "52100.00",
    "avgPrice": "52100.00",
    "orderType": "LIMIT",
    "timeInForce": "GTC",
    "expireTime": "GTC",
    "clientOrderId": "5f80d325-0f71-4f0a-a346-75c7bb6ac867",
    "fillPercentage": "100",
    "clientFeeRate": "10",
    "providerFeeRate": "10",
    "placedAt": "2025-04-26T09:37:28.316Z",
    "completedAt": null,
    "clientReference": "text",
    "rejectedAt": "2025-04-26T09:37:28.316Z",
    "orderRejectReason": "text"
  },
  "executions": [
    {
      "executionId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "executedAt": "2025-04-26T09:37:28.316Z",
      "pair": "BTC-USD",
      "side": "BUY",
      "deliverCurrency": "BTC",
      "deliverQuantity": "1.00",
      "receiveCurrency": "USD",
      "receiveQuantity": "52100.00",
      "price": "52100.00",
      "baseQuantity": "0.0016",
      "quoteQuantity": "10.74",
      "clientFeeRate": "10",
      "providerFeeRate": "10",
      "clientFeeQuantity": "52.10",
      "providerFeeQuantity": "52.10",
      "feeCurrency": "USD",
      "executionStatus": "TRADE_EXECUTED",
      "tradeDate": "2025-04-26",
      "valueDate": "2025-04-26",
      "confirmedAt": "2025-04-26T09:37:28.316Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}

Cancel an Order (WIP)

delete

Cancel a LIMIT order in NEW status

Authorizations

Body

anyOptional

Responses

delete

HTTPcURLJavaScriptPython

DELETE /api/v1/orders/{orderId} HTTP/1.1
Host: cams.aquanow.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*

{
  "msgType": "OrderCancelReject",
  "orderId": "91e115fa-8b04-4508-90a8-43ccd0aa658b",
  "orderStatus": "PENDING_CANCEL"
}