Orders

GET Order

get

Retrieve an order by its order ID.

Authorizations

Path parameters

orderIdstring · uuidrequired

The settlementId of the settlement

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cams.aquanow.com/api/v1/orders/{orderId}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

400

401

403

4XX

5XX

200

{
  "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-02T08:27:31.770Z",
  "completedAt": null,
  "clientReference": "text"
}

Successful response

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

Available options:

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.

Available options:

sortDirectionstring · enumoptional

Specifies the sort direction for the sortField.

Available options:

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://cams.aquanow.com/api/v1/orders' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

400

401

403

4XX

5XX

200

{
  "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-02T08:27:31.770Z",
      "completedAt": null,
      "clientReference": "text"
    }
  ]
}

Successful response

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

Execute a previously requested quote. Creates an Order and Executes it. Retuns both the order and the execution.

Create a Limit Order

Create a MARKET Order

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://cams.aquanow.com/api/v1/orders' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "quoteId": "123e4567-e89b-12d3-a456-426614174000",
    "orderType": "PREVIOUSLY_QUOTED",
    "clientReference": "text"
  }'

200

400

401

403

4XX

5XX

200

{
  "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-02T08:27:31.770Z",
    "completedAt": null,
    "clientReference": "text",
    "rejectedAt": "2025-04-02T08:27:31.770Z",
    "orderRejectReason": "text"
  },
  "executions": [
    {
      "executionId": "123e4567-e89b-12d3-a456-426614174000",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "executedAt": "2025-04-02T08:27:31.770Z",
      "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-02",
      "valueDate": "2025-04-02",
      "confirmedAt": "2025-04-02T08:27:31.770Z",
      "clientReference": "text",
      "tradeTaxRate": "5",
      "clientTaxQuantity": "2.61",
      "providerTaxQuantity": "2.61"
    }
  ]
}

Successful response

Cancel an Order (WIP)

delete

Cancel a LIMIT order in NEW status

Authorizations

Body

anyoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://cams.aquanow.com/api/v1/orders/{orderId}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json'

200

400

401

403

4XX

5XX

200

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

Successful response